z/OS DFSMSrmm Application Programming Interface
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Description of the contents of an output buffer

z/OS DFSMSrmm Application Programming Interface
SC23-6872-00

The first line of the output buffer shown in Figure 1 shows:
0000 0000100000000000 0000007100080260 00000000001B82A0 00000007D6E6D5C5
  • Three 4-byte length fields:
    • 00001000

      This is the length you specified for the output buffer.

    • 00000000

      This means that the output buffer is large enough. When the buffer length is too small, DFSMSrmm sets this field with the size of the buffer needed. DFSMSrmm also returns return code 108 and reason code 10.

    • 00000084

      This is the total size of the data in the output buffer, including the length of this field. You can use this data length to determine when there is no more data to process.

  • Eight structured fields:
    • 0008026000000000

      This is the Begin DATASET group SFI, which begins at offset x'000C' into the output buffer. Use this SFI to confirm that you are processing a DATASET SFI. When you do not want to process a group of structured fields, scan to the end of the group by looking for the corresponding End SFI, such as, the End DATASET group SFI in this example.

The first and second lines of the output buffer shown in Figure 1 show:
0000 0000100000000000 0000007100080260 00000000001B82A0 00000007D6E6D5C5
0020 D9D6D5C54BC6C9C5 D3C44BE3C5E2E300 0E8BC000000001E5 D6D3F0F0F1001087
  • Data Set Name structured field
    • 001B82A000000007 D6E6D5C5D9D6D5C54BC6C9C5D3C44BE3C5E2E3

      This is the Data Set Name structured field, which begins at offset x'0014' into the output buffer. The structured field consists of the 8-byte DSN SFI and, in this example, the 19-byte data set name (OWNERONE.FIELD.TEST). The length of the structured field is 27 bytes (8 plus 19) as shown by the x'001B' value at the beginning of the field.

  • Volume Serial structured field
    • 000E8BC000000001 E5D6D3F0F0F1

      This is the Volume Serial structured field, which begins at offset x'002F' into the output buffer. The structured field consists of the 8-byte VOL SFI and the 6-byte volume serial (VOL001).

The second and third lines of the output buffer shown in Figure 1 show:
0020 D9D6D5C54BC6C9C5 D3C44BE3C5E2E300 0E8BC000000001E5 D6D3F0F0F1001087
0040 0000000007D6E6D5 C5D9D6D5C5000C81 3000000009199711 7C000C81A0000000
  • Owner structured field
    • 0010870000000007 D6E6D5C5D9D6D5C5

      This is the Owner structured field, which begins at offset x'003D' into the output buffer. The structured field consists of the 8-byte OWN SFI and the 8-byte owner (OWNERONE).

  • Create Date structured field
    • 000C813000000009 1997117C

      This is the Create Date structured field, which begins at offset x'004D' into the output buffer. The structured field consists of the 8-byte CDTJ SFI and the 4-byte packed-decimal date (x'1997117C').

The third and fourth lines of the output buffer shown in Figure 1 show:
0040 0000000007D6E6D5 C5D9D6D5C5000C81 3000000009199711 7C000C81A0000000
0060 0A0815270C000C83 3000000005000000 0100080260800000 0000000000000000
  • Create Time structured field
    • 000C81A00000000A 0815270C

      This is the Create Time structured field, which begins at offset x'0059' into the output buffer. The structured field consists of the 8-byte CTM SFI and the 4-byte packed-decimal time (x'0815270C').

  • Physical File Sequence structured field
    • 000C833000000005 00000001

      This is the Physical File Sequence structured field, which begins at offset x'0065' into the output buffer. The structured field consists of the 8-byte FILE SFI and the 4-byte binary sequence number (x'00000001').

  • End DATASET group SFI
    • 0008026080000000

      This is the End DATASET group SFI, which begins at offset x'0071' into the output buffer.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014