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 return
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
either or both of
these fields are non-zero, do not
use the returned dsname.
KEY # LEN PARM
0056 0001 002C --------...--
KEY # LEN PARM
0056 0001 0003 C1 C2 C3-----...--