Dynamic information retrieval text units

Use verb code 07 and the text units listed in Table 1 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. You cannot specify more than one of these keys for a single information retrieval request.

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 that 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. The few exceptions to this rule are noted in the individual text unit descriptions.

For example, if you request information about the storage class of a data set, but that data set is not SMS-managed, the system returns zero in the length field of the text unit.

For either verb code 01 or verb code 07 information retrieval, the data returned in the PARM field is valid only for the number of bytes returned in the LEN field. If on input the PARM field is longer than the information returned on output, the remaining bytes in PARM might contain data from previous invocations of DYNALLOC. The information retrieval function does not pad the remaining bytes with blanks.

For example, on Input the text unit initializes the PARM field to “AAAAAAAA”. On Output the text unit contains the name “MYDD” and a LEN of X'0004'. Beyond the valid length (4 bytes) of “MYDD”, the PARM field might contain data from the previous request (“MYDDAAAA”).

        KEY  #     LEN    PARM
Input:  0004 0001  0008   C1C1C1C1C1C1C1C1

Output: 0004 0001  0004   D4E8C4C4C1C1C1C1

When you request information for multiple parameters, the LEN and PARM fields of the next parameter immediately follow the information returned from the previous parameter. For example, the Output text unit below contains a second LEN and PARM pair. The request returns the information “X” in the PARM2 field. The information in the fields is contiguous; spaces are shown in the example only for readability.

KEY  #     LEN1   PARM1     LEN2     PARM2
Output: nnnn 0002  0004   D4E8C4C4  0001     E7

Table 1. Verb Code 07 (Dynamic Information Retrieval) – Text Unit Keys, Mnemonics, and Functions
Hex Text Unit Key	Mnemonic	DYNALLOC Function (Input)
0001	DINDDNAM	Specifies the ddname identifier of the requested information.
0002	DINDSNAM	Specifies the data set for which the information is requested.
0004	DINRTDDN	Requests the associated ddname.
0005	DINRTDSN	Requests the data set name.
0006	DINRTMEM	Requests the PDS member name.
0007	DINRTSTA	Requests the data set's status.
0008	DINRTNDP	Requests the data set's normal disposition.
0009	DINRTCDP	Requests of the data set's conditional disposition.
000A	DINRTORG	Requests the data set's organization.
000B	DINRTLIM	Requests the number of resources that must be deallocated before making a new allocation.
000C	DINRTATT	Requests the special attribute indications.
000D	DINRTLST	Requests a last relative entry indication.
000E	DINRTTYP	Requests the data set's type (terminal or dummy).
000F	DINRELNO	Specifies the desired allocation information retrieval by relative request number.
0010	DINRTVOL	Requests the return of the first volume serial number associated with the specified allocation.
0011	DINRTDDX	Requests the return of the ddname associated with the specified allocation.
0012	DINRLPOS	Requests the return of the relative position of a data set within a concatenated group.
8017	DINPATH	Specifies the pathname of the z/OS® UNIX file for which information is requested.
C003	DINRCNTL	Requests the JCL CNTL statement reference.
C004	DINRSTCL	Requests the storage class of a new SMS-managed data set.
C005	DINRMGCL	Requests the management class of a new SMS-managed data set.
C006	DINRDACL	Requests the data class of a new data set.
C00B	DINRRECO	Requests the organization of a new VSAM data set.
C00C	DINRKEYO	Requests the key offset of a new VSAM data set.
C00D	DINRREFD	Requests the DD name specified by the REFDD parameter of the DD statement.
C00E	DINRSECM	Requests the name of the RACF® security data set profile.
C00F	DINRLIKE	Requests the data set name on the LIKE parameter.
C010	DINRAVGR	Requests the value of the unit of allocation for a data set.
C012	DINRDSNT	Requests the data set type, such as PDS.
C013	DINRSPIN	Requests the spin data set specification.
C014	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.
C017	DINRPATH	Requests the return of the z/OS UNIX file path specification.
C018	DINRPOPT	Requests the return of the z/OS UNIX file options.
C019	DINRPMDE	Requests the return of z/OS UNIX file access attributes.
C01A	DINRPNDS	Requests the return of the disposition of the z/OS UNIX file during normal step termination.
C01B	DINRPCDS	Requests the return of the disposition of the z/OS UNIX file during abnormal step termination.
C01D	DINRFDAT	Requests the return of the organization of a z/OS UNIX file.
C02A	DINRSPI2	Requests the SPIN interval specification.
C02B	DINRSYML	Requests the SYMLIST specification.
C02C	DINRDSNV	Requests the DSNTYPE version.
C02D	DINRMAXG	Requests the value of MAXGENS.
C02E	DINRGDGO	Requests the return of the order in which the individual generation data sets (GDSs) are concatenated.