Data set name for in-stream or sysout data set

Use the DSNAME parameter to assign a data set name to an in-stream data set (defined with the DD * or DD DATA parameter) and to a sysout data set (defined with the DD SYSOUT parameter). When defining an in-stream or sysout data set, you can code the DSNAME parameter or omit it; if omitted, the system generates a name for the data set.

The data set name for in-stream and sysout data sets consists of two ampersands (&&) followed by one through eight 8 alphanumeric or national ($, #, @,) characters, a hyphen, or a character X'C0'. The first character following the ampersands must be alphabetic or national ($, #, @).

The system generates a qualified name for the in-stream or sysout data set. The qualified name contains:

The userid of the job
The jobname
The jobid
A system-assigned identifier
The data set name from the DSNAME parameter (if DSNAME is coded), or a question mark (?) if DSNAME is not coded.

The format of the name is:

   userid.jobname.jobid.Ddsnumber.name

where name is the dsname or a question mark (?).

When the system checks a user's authority to access a SYSOUT data set, the check is made against the JESSPOOL class using the fully qualified name, preceded by the node name and a period:

   nodename.userid.jobname.jobid.Ddsnumber.name

Profiles of this format may be defined in your security system to allow other users access to your SYSOUT data sets. A profile is not necessary for you to access your own data sets.

Note: A single ampersand before a data set name in a cataloged or in-stream procedure signifies a symbolic parameter. However, if no value is assigned to the name on either the EXEC statement that calls the procedure, a PROC statement in the procedure, or a previous SET statement, the system treats the name as the last qualifier of the data set name for an in-stream or sysout data set.

&&dsname: Specifies the last qualifier of the system-generated data set name for an in-stream or sysout data set.