Route codes

A route code defines a destination for a piece of output. NnnnnRmmmm is the most basic form of a JES2 route code, indicating remote mmmmm at node nnnn. This basic form is called the explicit form of a route code. When the node is local (our own node), the Nnnnn can be omitted. In order to have the destination resolved to NODE1, REMOTE1, the destination needs to be qualified with a 'dot':

DEST=N1.R1
DEST=N1.RM1
DEST=N1.RMT1

The maximum size of a route code is 18 characters. You can specify a route code in any of the forms listed below (although specific commands may be more limited). Note that a slash, a colon, or parentheses can be used instead of a period anywhere a period appears as a separator in a route code. For example, you could specify node.remote, node:remote, node/remote, or node(remote) for a route code.

LOCAL.*
LOCAL|ANYLOCAL
destid
Nnnnn|nodename
Nnnnn.Rmmmm|node.remote|node.userid
Ummmm
node.destid
remote
- LOCAL|ANYLOCAL
- Rmmmm
- destid
- userid
- node

If /R=LOCAL is specified on a command, only output that has explicitly a destination of LOCAL will be released. Destination of a userid which resides on local node will not be released. However, if you specify LOCAL.*, outputs having a destination of LOCAL will be released as well as outputs destined to local userid:

$HASP686 OUTPUT(JEANAMB)
$HASP686 OUTPUT(JEANAMB)   OUTGRP=1.1.1,BURST=NO,FCB=****,
$HASP686                   FLASH=****,FORMS=STD,HOLD=(NONE),
$HASP686                   OUTDISP=HOLD,PRIORITY=144,
$HASP686                   PRMODE=LINE,QUEUE=B,
$HASP686                   RECORDS=(312 OF 312),ROUTECDE=JFB,
$HASP686                   SECLABEL=,TSOAVAIL=NO,UCS=****,
$HASP686                   USERID=JEAN,WRITER=

Above destination is destined to userid JFB on local node. The $OJ1286,/R=LOCAL will have no effect on output. $OJ1286,/R=LOCAL.* will release above output.

In most places, userids may be used instead of remotes. A userid at the local node must have the format of a valid TSO userid. It must begin with an alphabetic character (A-Z) or a special character (@, #, or $). The remaining characters may be alphabetic, numeric, or special characters. Userids at non-local nodes may contain any characters except the following:

Separators: a period; a colon; a slash; a set of parentheses.
Delimiters: a comma; a blank; hexadecimal '00'.

In some commands, generic userids are allowed. A generic userid is a userid that ends in an asterisk (*) and refers to all userids that begin with any characters preceding the *. Note that if the userid is a local userid, then the * can be specified in the last position of the userid.