1.5.3.3.3 Retrieving Information on Data Sets
Use verb code 07 and the text units listed in the following table and described as follows to request that dynamic allocation return certain information about the allocated resources. You must specify the DINDDNAM key, the DINDSNAM key, the DINPATH key, or the DINRELNO key to request information retrieval.
Keys X'0001', X'0002', and X'000F', and X'8017' are input keys. You use them to supply information to the system. The remaining keys are output keys, which the system uses to return the information you requested.
If you request the system return information that does not exist, the system sets the length field for that parameter to zero, and there will be no data field for that parameter.
Table 1-17 Text Units for Retrieving Information on Data Sets
| Text Unit Key | Mnemonic | Description | Supported |
|---|---|---|---|
| 0x0001 | DINDDNAM | Specifies the ddname identifier of the requested information. | Yes |
| 0x0002 | DINDSNAM | Specifies the data set for which the information is requested. | Yes |
| 0x0004 | DINRTDDN | Requests the associated ddname. | Yes |
| 0x0005 | DINRTDSN | Requests the data set name. | Yes |
| 0x0006 | DINRTMEM | Requests the PDS member name. | No |
| 0x0007 | DINRTSTA | Requests the data set's status. | Yes |
| 0x0008 | DINRTNDP | Requests the data set's normal disposition. | Yes |
| 0x0009 | DINRTCDP | Requests of the data set's conditional disposition. | Yes |
| 0x000A | DINRTORG | Requests the data set's organization. | Yes |
| 0x000B | DINRTLIM | Requests the number of resources that must be deallocated before making a new allocation. | No |
| 0x000E | DINRTTYP | Requests the data set's type (terminal or dummy). | No |
| 0x000F | DINRELNO | Specifies the desired allocation information retrieval by relative request number. | No |
| 0x0010 | DINRTVOL | Requests the return of the first volume serial number associated with the specified allocation. | Yes |
| 0x8017 | DINPATH | Specifies the pathname of the z/OS® UNIX file for which information is requested. | No |
| 0xC003 | DINRCNTL | Requests the JCL CNTL statement reference. | No |
| 0xC004 | DINRSTCL | Requests the storage class of a new SMS-managed data set. | No |
| 0xC005 | DINRMGCL | Requests the management class of a new SMS-managed data set. | No |
| 0xC006 | DINRDACL | Requests the data class of a new data set. | No |
| 0xC00B | DINRRECO | Requests the organization of a new VSAM data set. | Yes |
| 0xC00C | DINRKEYO | Requests the key offset of a new VSAM data set. | Yes |
| 0xC00D | DINRREFD | Requests the DD name specified by the REFDD parameter of the DD statement. | No |
| 0xC00E | DINRSECM | Requests the name of the RACF® security data set profile. | No |
| 0xC00F | DINRLIKE | Requests the data set name on the LIKE parameter. | No |
| 0xC010 | DINRAVGR | Requests the value of the unit of allocation for a data set. | No |
| 0xC012 | DINRDSNT | Requests the data set type, such as PDS. | No |
| 0xC013 | DINRSPIN | Requests the spin data set specification. | No |
| 0xC014 | DINRSEGM | Requests the number of logical, line-mode pages (the segment) to be produced for a SYSOUT data set before the segment becomes eligible for immediate printing. | No |
| 0xC017 | DINRPATH | Requests the return of the z/OS UNIX file path specification. | No |
| 0xC018 | DINRPOPT | Requests the return of the z/OS UNIX file options. | No |
| 0xC019 | DINRPMDE | Requests the return of z/OS UNIX file access attributes. | No |
| 0xC01A | DINRPNDS | Requests the return of the disposition of the z/OS UNIX file during normal step termination. | No |
| 0xC01B | DINRPCDS | Requests the return of the disposition of the z/OS UNIX file during abnormal step termination. | No |
| 0xC01D | DINRFDAT | Requests the return of the organization of a z/OS UNIX file. | No |
| 0xC02A | DINRSPI2 | Requests the SPIN interval specification. | No |
| 0xC02B | DINRSYML | Requests the SYMLIST specification. | No |
| 0xC02C | DINRDSNV | Requests the DSNTYPE version. | No |
| 0xC02D | DINRMAXG | When you have applied APAR OA42358, requests the value of MAXGENS. | No |
| 0xC02E | DINRGDGO | Requests the return of the order in which the individual generation data sets (GDSs) are concatenated. | No |
Parent topic: SVC99 Program