DFSMSrmm structured field introducers

The DFSMSrmm application programming interface (API) returns data as structured fields in an output buffer that you define. Structured fields consist of a structured field introducer (SFI) and the data. SFIs describe the type, length, and other characteristics of the data.

All Structured Field Introducers (SFIs) have this format:

Bytes

Description

0-1

2-byte length: SFI length plus data length

2-4

3-byte identifier: SFI ID (hexadecimal)

5

1-byte type modifier: Type of SFI

0 = 8-byte, fixed-length SFI

6

1-byte (Reserved)

7

1-byte data type: Type of data, if any, that follows the SFI

0=Undefined (no data)
1=Character (fixed-length)
2=Bit(8) (1-byte flag, multiple bits can be on)
3=Binary(8) (1-byte (hex) value)
4=Binary(15) (2-byte (hex) value)
5=Binary(32) (unsigned 4-byte (hex) value)
6=Binary(64) (unsigned 8-byte (hex) value)
7=Character (variable-length)
8=Compound SFI (multiple related values, see Compound SFI.)
9=(4 bytes) Packed decimal Julian date: yyyydddC
A=(4 bytes) Packed decimal time format: hhmmsstC

Table 1 shows the structured field introducers that support TS1140 tape drives.

Table 1. Changed structured field introducers
Name	Number	Type	Length	Value	Subcommands
BLKT	X'80D030'	Binary(32)	12	Total block count X'’FFFFFFFF' indicates that BLK6 SFI contains the actual value	LD SD
BLK6	X'80D0B0'	Binary(64)	16	Total block count	LD
CRAT	X'817890'	Binary(32)	12	Compression ratio in hundreths	LD LV
MEDR	X'857000'	Binary(8)	9	Recording technology: 0=NON-CARTRIDGE 1=18TRK 2=36TRK 3=128TRK 4=256TRK 5=384TRK 6=EFMT1 7=EFMT2 8=EEFMT2 9=EFMT3 10=EEFMT3 11=EFMT4 12=EEFMT4	LC LV SV
MEDT	X'858000'	Binary(8)	9	Media type: 0=UNDEFINED 1=CST 2=ECCST 3=HPCT 4=EHPCT 5=ETC/MEDIA5 6=EWTC/MEDIA6 7=EETC/MEDIA7 8=EEWTC/MEDIA8 9=EXTC/MEDIA9 10=EXWTC/MEDIA10 11=EATC/MEDIA11 12=EAWTC/MEDIA12 13=EAETC/MEDIA13	LV, SV
PSZ6	X'87D300'	Compound (Binary(8) Factor, Binary(64) Value)	22	Physical space used: 0=bytes 1=KB 2=MB 3=GB Value: Minimum value = 0.	LD LV