DD DEST Parameter


The DEST parameter is used to specify the destination of printed output produced by a job. It identifies the physical printer or destination to which the output is to be sent.

The DEST parameter always codes with the SYSOUT parameter; if not, the system ignores it.

Syntax -

//DDname DD DSN=datasetname,DISP=disp,DEST=destination

The destination for JES3 is one of the following -

ANYLOCAL Specifies any local device that is attached to the global processor.
device-name Specifies a local device by a name.
device-number Specifies a device by a 3-digit or 4-digit number.
group-name Specifies a group name with local devices, an individual remote station, or a group of remote devices.
nodename Specifies a node name.
(nodename,userid) Specifies a node name, and userid has access to the node.
(nodename,devicename) Specifies a node name and device name of the node.

Default and overrides -

If the DEST parameter is not coded, JES directs the dataset to the default destination from where the job is submitted. The job will fail if the destination specified with the DEST parameter is invalid.

Examples -


Scenario1 - Sending output to SPOOL.

//STEP01 EXEC PGM=PROG1
//DD1    DD   DSN=MTH.DATA.FILE,DISP=SHR
//OUTPUT DD   SYSOUT=*

Scenario2 - Sending output to the PRINTER1.

//STEP01 EXEC PGM=PROG1
//DD1    DD   DSN=MTH.DATA.FILE,DISP=SHR
//OUTPUT DD   SYSOUT=*,DEST=PRINTER1

Scenario3 - Sending output to the QUEUE1.

//STEP01 EXEC PGM=PROG1
//DD1    DD   DSN=MTH.DATA.FILE,DISP=SHR
//OUTPUT DD   SYSOUT=*,DEST=QUEUE1

The output of the job is sent to a logical printer named QUEUE1. The actual physical printer associated with QUEUE1 can be changed without modifying the JCL.