Non-JCL dynamic allocation functions

The keys listed in Table 1 and described on the following pages do not have JCL equivalents; they have meaning only when you request dynamic allocation by dsname (verb code 01). You can request that the system return information about either a dsname or a ddname dynamic allocation request by specifying either of the following:
  • Start of changeThe non-JCL dynamic allocation functions keys 0055-0057, 005D, and 007B-007D, which request that the system return information about your dsname allocation requestEnd of change
  • Information retrieval keys greater than C000, described in Dynamic information retrieval text units

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:  0055 0001  0008   C1C1C1C1C1C1C1C1

Output: 0055 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, on Output the 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 01 (non-JCL dynamic allocation functions) – Text units, mnemonics, and functions

Hex text
unit key

Mnemonic DYNALLOC function
0050 DALPASSW Specifies the password for a protected data set.
0052 DALPERMA Specifies the permanently allocated attribute.
0053 DALCNVRT Specifies the convertible attribute.
0055 DALRTDDN Requests the return of the associated ddname.
0056 DALRTDSN Requests the return of the allocated data set's name.
0057 DALRTORG Requests the return of data set organization.
005C DALSSREQ Specifies allocation of a subsystem data set.
005D DALRTVOL Requests the return of the volume serial number.
0062 DALSSATT Specifies allocation of a subsystem data set to SYSIN.
006E DALBRTKN Specifies a spool data set browse token that contains information about a JES2 spool data set that a user asks to browse.
006F DALINCHG Specifies the tape recording technique and media type to use for a new data set request.
0075 DALUASSR Specifies allocation of a subsystem data set.
0077 DALUNQDS Specifies a uniquely allocated temporary data set.
Start of change0078End of change Start of changeDALReqIEFOPZEnd of change Start of changeRequest IEFOPZ processing.End of change
Start of change0079End of change Start of changeDALINSDDEnd of change Start of changeSpecifies the insulated DD attribute.End of change
Start of change007AEnd of change Start of changeDALNOSECEnd of change Start of changeSpecifies bypass security processing.End of change
Start of change007BEnd of change Start of changeDALRetInfoEnd of change Start of changeReturn allocation information.End of change
Start of change007CEnd of change Start of changeDALRetIEFOPZnewDSNEnd of change Start of changeReturn IEFOPZ-new data set name.End of change
Start of change007DEnd of change Start of changeDALRetIEFOPZnewVOLEnd of change Start of changeReturn IEFOPZ-new volume serial.End of change