Deallocating resources by dsname or pathname

The following considerations apply to unallocation requests specifying a dsname or pathname. For a description of unallocation by ddname, see Deallocating resources by ddname.
  • If you do not specify a ddname, and the dsname or pathname is associated with more than one ddname, all associated data sets or z/OS® UNIX files are deallocated. If an error occurs while deallocating one ddname, processing continues for the others and an error code is returned in the SVC 99 parameter list. If errors occur for more than one ddname, the error code applies to the last ddname for which there was an error.
  • If you specify a member name with the dsname, only those associations containing both the member name and dsname are deallocated. If you code a member name text unit key, you must also code the dsname text unit key for a valid request.
  • To dynamically deallocate a z/OS UNIX file by pathname, you must specify the same pathname that you specified to allocate the file. If the pathname specified differs, the unallocation request will fail. For example, suppose that the file pay.time can be accessed through multiple paths. It was allocated as /usr/applics/pay.time but can also be accessed as /comn/pgms/pay.time. Deallocating the file through the /comn/pgms path is not possible. It must be deallocated by the /usr/applics/pay.time pathname.