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:
- The non-JCL dynamic allocation functions keys 0055-0057, 005D, and 007B-007D, which request that the system return information about your dsname allocation request
- 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
Hex text |
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. |
0078 | DALReqIEFOPZ | Request IEFOPZ processing. |
0079 | DALINSDD | Specifies the insulated DD attribute. |
007A | DALNOSEC | Specifies bypass security processing. |
007B | DALRetInfo | Return allocation information. |
007C | DALRetIEFOPZnewDSN | Return IEFOPZ-new data set name. |
007D | DALRetIEFOPZnewVOL | Return IEFOPZ-new volume serial. |