Ddname return specification - Key = '0055'

DALRTDDN requests that the ddname associated with the allocation be returned to the caller of DYNALLOC. When you code DALRTDDN, # must be one, and LEN must be at least the length of the ddname, and can be longer, up to a maximum of 255 characters. The PARM field must be the length specified by the value in LEN. Dynamic allocation places the allocated ddname in PARM and updates LEN to the length of the returned ddname.

The system does not fail the dynamic allocation request if it cannot obtain the ddname. Therefore, when you use this key, provide an SVC 99 request block extension (see Setting up the request block extension). Upon return, verify that fields S99EERR and S99EINFO in the request block extension are zero. If these fields are non-zero, do not use the returned ddname.

Example: To request that the allocated ddname be returned, code:

KEY    #      LEN    PARM
0055   0001   0008   --------

This specification would be updated upon the assignment of the ddname DD1 as follows:

KEY    #      LEN    PARM
0055   0001   0003   C4 C4 F1-----