z/OS DFSMSdfp Advanced Services
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


How Found

z/OS DFSMSdfp Advanced Services
SC23-6861-01

Chained from a format-8 DSCB that represents the data set. Data sets that have a format 1 DSCB do not have a format 9 DSCB.

Table 1 shows the contents of a format-9 DSCB.

Table 1. Format-9 DSCB
Offset Dec (Hex) Type Length Name Description
0 (X'00') Character 1 DS9KEYID Key identifier.
      DS9KEY Constant value of X'09' in DS9KEYID
1 (X'01') Binary 1 DS9SUBTY Subtype number for format 9.
      DS9SUBT1 Constant value of binary 1 to represent subtype 1.

If your program uses the content of a format 9 DSCB, then it should test the subtype field to learn the format of the DSCB. Currently only one subtype is defined

Beginning of the fields that are unique to the format 9 subtype 1 DSCB.
2 (X'02') Binary 1 DS9NUMF9 Number of format 9 DSCB's for this data set. Valid only in the first format 9 DSCB.
3 (X'03') Character 1 DS9FLAG1 Format 9 DSCB flag byte 1.
  1 . . . . . . .   DS9CREAT Format 9 DSCB built by create.
4 (X'04') Character 8 DS9JOBNAME Job name used to create the data set described by its format 8 DSCB. Valid only when DS9CREAT is on (see offset 3 (X'03'))
12 (X'0C') Character 8 DS9STEPNAME Step name used to create the data set described by its format 8 DSCB. Valid only when DS9CREAT is on (see offset 3 (X'03'))
20 (X'12') Character 6 DS9TIME Number of microseconds since midnight, local time, that the data set described its format 8 DSCB was created. See creation date field, DS1CREDT (offset 53(X'35')), for the date. Valid only when DS9CREAT is on (see offset 3 (X'03'))
26 (X'20') Character 18 * Reserved.
44 (X'2C') Character 1 DS9FMTID Format identifier.
      DS9IDC Constant value of X'F9' in DS9FMTID.
45 (X'2D') Binary 1 DS9NUMF3 Number of format 3 pointers that follow
46 (X'2E') Binary 50 DS9F3 Pointers to first to tenth format-3 DSCBs
The following five bytes occur ten times.
46 (X'2E') Binary 5 DS9F3P First pointer to a format-3 DSCB
46 (X'2E') Binary 2 DS9F3CC Cylinder number in pointer to format-3
48 (X'30') Binary 2 DS9F3HH Track number in pointer to format-3
50 (X'32') Binary 1 DS9F3R Record number in pointer to format-3
96 (X'60') Character 20 DS9ATRV1 Attribute bytes available for vendor use. See Vendor fields in DS9ATRV!.
116 (X'74') Character 19 DS9ATRI2 Attribute fields, for future IBM® definition
End of the fields that are unique to the format 9 subtype 1 DSCB.
135 (X'87') Bitstring 5 DS9PTRDS Pointer (CCHHR) to next format-9 DSCB, the first format-3 DSCB or zero.
135 (X'87') Binary 2 DS9CCPTR Cylinder number in DSCB pointer
138 (X'89') Binary 2 DS9HHPTR Track number in DSCB pointer
140 (X'8B') Binary 1 DS9RPTR Record number in DSCB pointer
140 (X'8C') DS9END  
Vendor fields in DS9ATRV1 in the format 9 DSCB

z/OS® does not enforce any rules on the content of the DS9ATRV1 field. It is available for vendor products to set. IBM provides the following recommendations:

Each vendor should store subfields in the following format beginning at the leftmost byte:

0 (X'0') Character 1    
  xxxx ....     Reserved
  .... xxxx     Number of bytes that follow this two-byte header. Minimum value is 0000.
1 (X'1') Character 1   One-byte field containing a vendor identification issued by IBM.
2 (X'2') Character     Beginning of variable-length field up to 15 bytes.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014