Dsname return specification - Key = '0056'

DALRTDSN requests that the dsname that is allocated be returned to the caller of DYNALLOC. When you code DALRTDSN, # must be one, and LEN must be at least the length of the dsname, 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 dsname in PARM and updates LEN to the length of the returned dsname.

The system does not fail the dynamic allocation request if it cannot obtain the dsname. 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 dsname.

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

KEY    #      LEN    PARM
0056   0001   002C   --------...--

This specification would be updated for the allocation of the dsname ABC as follows:

KEY    #      LEN    PARM
0056   0001   0003   C1 C2 C3-----...--