── DESTNAME ─┬──────────────────────┬──────────────────────────────────┤
├─────┬─<station name>─┤
├─ = ─┘ │
├─ * ──────────────────┤
└─ . ──────────────────┘Explanation
The DESTNAME command provides a means of specifying a non-CANDE station for the printed output of a task. This command
-
Interrogates the current DESTNAME
-
Assigns the DESTNAME to a specified station name
-
Returns the current DESTNAME to the default value for the user
The DESTNAME is supplied on all task executions explicitly initiated by the user and on CANDE-initiated tasks, such as CANDE WRITE. The current DESTNAME can be overridden by an explicit specification on a RUN or COMPILE request.
Changing the DESTNAME value during a session does not affect the tasks that have already been executed during the session.
The <station name> in the DESTNAME command cannot be a station with an LSN value greater than 16,383.
Determining the Default DESTNAME
The default DESTNAME for a particular user is determined by the CANDEDESTNAME for that user in the USERDATAFILE. To change the default DESTNAME in the USERDATAFILE, MAKEUSER must be invoked by the installation. (Refer to the System Software Utilities Operations Reference Manual for further information about MAKEUSER.)
The default DESTNAME for a given usercode is set at the beginning of each session associated with that usercode. The CANDE DESTNAME command can be used to override the default DESTNAME during a session.
