Requesting field format

Figure 1 is an example of the field format data that the DFSMSrmm API returns when you specify the OUTPUT=FIELDS parameter. Your request specifying LISTDATASET FIELD.TEST VOLUME(VOL001) subcommand might also produce the output shown in Figure 1.

Figure 1. Example of output using OUTPUT=FIELDS

<Begin DATASET Group>
  <DSN  - Data Set Name            : 44, character         >
  <CJBN - Job Name                 :  8, character         >
  <VOL  - Volume Serial            :  6, character         >
  <OWN  - Owner                    :  8, character         >
  <DSEQ - Data Set Sequence        :  4, bin(31)           >
  <TZ   - Time Zone                :  4, bin(31)           >
  <DEV  - Device Number            :  4, character         >
  <FILE - Physical File Sequence   :  4, bin(31)           >
  <CDTJ - Create Date              :  4, packed decimal    >
  <CTM  - Create Time              :  4, packed decimal    >
  <SYS  - Creating system ID       :  8, character         >
  <BLKS - Block Size               :  4, bin(31)           >
  <BLKC - Block Count              :  4, bin(31)           >
  <LRCL - Logical Record Length    :  4, bin(31)           >
  <RCFM - Record Format            :  4, character         >
  <DC   - Data Class               :  8, character         >
  <DLWJ - Date Last Written        :  4, packed decimal    >
  <DLRJ - Date Last Read/Referenced:  4, packed decimal    >
  <STEP - Step Name                :  8, character         >
  <DD   - DD Name                  :  8, character         >
  <MC   - Management Class         :  8, character         >
  <SG   - Storage Group Name       :  8, character         >
  <SC   - Storage Class            :  8, character         >
  <VMV  - VRS Management Value     :  8, character         >
  <RTDJ - Retention Date           :  4, packed decimal    >
  <VTYP - Primary VRS Type         :  1, bin(8)            >
  <VJBN - Primary VRS Job Name     :  8, character         >
  <VNME - Primary VRS Name         : 44, character         >
  <VSCN - Primary VRS Subchain name:  8, character         >
  <VSCD - Primary VRS Subchain date:  4, packed decimal    >
  <VRSR - VRS Retained             :  1, bin(8)            >
  <NME  - Security Class Name      :  8, character         >
  <CLS  - Security Class Descriptio: 32, character         >
  <ABND - Abend while open         :  1, bin(8)            >
  <CTLG - Catalog status           :  1, bin(8)            >
  <2JBN - Secondary VRS jobname mas:  8, character         >
  <2NME - Secondary VRS mask       :  8, character         >
  <2SCN - Secondary VRS subchain na:  8, character         >
  <2SCD - Secondary VRS subchain da:  4, packed decimal    >
  <BLKT - Total block count        :  4, bin(31)           >
  <CPGM - Creating program name    :  8, character         >
  <LPGM - Last used program name   :  8, character         >
  <LJOB - Last used job            :  8, character         >
  <LSTP - Last used step name      :  8, character         >
  <LDD  - Last used DD name        :  8, character         >
  <LDEV - Last Drive               :  4, character         >
  <DPCT - Percent of volume        :  1, bin(8)            >
  <XDTJ - Expiration Date          :  4, packed decimal    >
  <XDSB - Expiry date set by       :  1, bin(8)            >
  <OXDJ - Original Expiration Date :  4, packed decimal    >
  <DSS6 - Data Set Size            : 14, compound          >
  <LCDJ - Last Change Date         :  4, packed decimal    >
  <LCTM - Last Change Time         :  4, packed decimal    >
  <LCID - Last Change User ID      :  8, character         >
  <LCSI - Last Change System ID    :  8, character         >
  <LCUD - Last "User" Change Date  :  4, packed decimal    >
  <LCUT - Last "User" Change Time  :  4, packed decimal    >
  <DLTD - Deleted By Disposition Pr:  1, bin(8)            >
  <VEX  - VRSEL EXCLUDE on         :  1, bin(8)            >
  <BESK - CA Tape Encrytion key ind:  4, bin(31)           >
  <PSZ6 - Physical space used      : 14, compound          >
  <CRAT - Compression ratio in hund:  6, bin(31)           >
  <BLK6 - Total block count ( 64 bi:  8, bin(64)           >
  <LRED - LASTREF extra days       :  4, bin(31)           >
<End DATASET Group>

Figure 1:

Shows Begin and End group structured field introducers. In this example, <Begin DATASET Group> and <End DATASET Group>.
Includes descriptive names used to identify structured field introducers. The SFI identifies the data type; and the long character <...> strings do not represent the actual size of the structured field introducers, which are only 8 bytes in length.
Can appear to have no data. This is because structured fields can
- Have no data (SFI only, as in this example), binary zeros, or blank characters.
- Be omitted if they have no data.
Shows that structured fields can be order independent. For example, VOL occurs before OWN for LISTDATASET (as shown in LISTDATASET structured field introducers) while OWN occurs before VOL for LISTPRODUCT (as shown in LISTPRODUCT structured field introducers).
Shows that structured fields might not be in the same order as their corresponding positions in any line-format output.
Shows variable-length fields.

Refer to Hexadecimal example of an output buffer for an example of an output buffer in hexadecimal representation.