JES2 Commands

JES2 operator commands allow remote terminal operators to communicate with the JES2 system. This section lists the most commonly used JES2 remote commands.

Command	Controls or Displays
$A release	job
$B backspace	printer, punch
$C cancel	job, printer, punch, reader
$D display	job, queue
$E restart	printer, punch
$F space forward	printer, punch
$H hold	job
$I interrupt	printer, punch
$L list	job
$N repeat	printer, punch
$O release	job
$P purge	job, printer, punch, reader
$R route	job, queue
$S start	printer, punch, reader
$T set device options	printer, punch
$Z halt	printer, punch

$A release

The $A command releases a job under the operators jurisdiction from hold. The job resumes normal processing. The operator can specify a job name or number with the $A command.

Format

$A jobname	Where jobname is the name of the job to be released from hold.
$A Jnnnn	Where nnnn is a single job number to release that job or a range of job numbers to release a series of jobs from hold.

Examples

$A DATA	Releases the job named DATA.
$A J245	Releases job 245.
$A J2-70	Releases all jobs with numbers ranging from 2 to 70.
$A J245,J747	Releases only jobs 245 and 747.

$B backspace

The $B command backspaces the job currently printing or punching. Operators can use this command when printer or punch malfunctions produce distorted output. They can reprint or repunch part of the output without restarting the entire job.

The $B command has two operands. The first operand identifies the printer or punch to backspace. The second operand gives the number of pages or lines to reprint or repunch or it tells the device to backspace to the beginning of the current data set.

When the operator backspaces printed output, the $B command counts page ejects (that is, skips to channel 1), not physical pages. If no pages eject, $B backspaces to the beginning of the data set.

Format

$B dev,y

where dev is a printer (PR1) or punch (PU1) and y is the number of cards to repunch, the number of pages to reprint, or the letter D, which indicates a backspace to the beginning of the data set. The number of cards or pages can range from 1 to 9999. If you do not specify a number, the system backspaces the printer one page or one line.

Examples

$B PR1	Backspaces printer 1 one page (to the last page eject).
$B PR2,5	Backspaces printer 2 five pages.
$B PR1,D	Backspaces printer 2 to the beginning of the data set.
$B PU1,5	Backspaces punch 1 five cards.

$C cancel

Operators can use the $C command to cancel a job or device under their jurisdiction. The $C command cancels a job on the printer, punch, or reader or a job awaiting execution.

When operators use the $C command on an output device, the command cancels only the active SYSOUT group on that device, it does not cancel other SYSOUT data sets for that job. To cancel a job on the output queue, use the $P command.

E If the $C command does not cancel the job, the operator must reenter the command.

Operators can specify a job number or device with the $C command.

Format

$C Jnnnn

Where nnnn is the number of a job to cancel.

$C dev

Where dev identifies the device to cancel. For dev, substitute one of the following:

RDn to cancel reader n.

PRn to cancel printer n.

PUn to cancel punch n.

Examples

$C J545	Cancels job 545.
$C PR1	Cancels the output currently printing on printer 1 and deletes other SYSOUT data sets for the job that matches the current setup for the printer.
$C RD1	Cancels the job on reader 1.

$D display

The $D command displays information about the system, a job, a device, or a set of devices.

The $D command format depends on the type of information the operator requests.

E The Troubleshooting: Receiving jobs from the host topic provides examples of common uses for some of the $D commands.

Format

$D F	Displays the number of special forms jobs (and their job classes) waiting to print at the operators remote.
$D Jnnnn	Displays information about a job or a range of jobs under the operators jurisdiction. If nnnn is a single number, only job nnnn displays. If nnnn is a range of numbers, all jobs in that range display. For example, an operator can type $D J1-32767 and receive a list of all jobs in the system under that operators jurisdiction. If a job is not printing, make sure the jobs criteria (for example, form or class) matches the printers criteria with the $LJnnnn command.
$D MRx,message	Sends a message to the remote specified by x. The message can contain up to 53 characters. If x=0, the message goes to the host computer console.
$D N,Q=y	Displays the queued jobs, where y describes the type of jobs to display. For y, substitute one of these parameters: XEQ displays only jobs awaiting execution. XEQc displays only jobs awaiting execution that have the job class specified by c. PPU displays only jobs waiting for the printer or punch. HOLD displays jobs on hold. OUT displays jobs awaiting output processing. Job information and the percentage of spool use display.
$D Q,Q=y	Identical to $D N except that only the number of jobs displays rather than the job names and other information.
$D U,RMTnnnn	Displays information about the devices attached to the operators remote, where nnnn is the operators remote number. Information includes the STATUS (active, inactive, or drained), the current settings for FORMS and QUEUE, and WS (work selection criteria).
$D jobname	Displays a list of all jobs in the system with that job name, including jobs not under the operators jurisdiction.

Examples

$D F	Displays the forms queue for the remote.
$D J244	Displays job 244.
$D J234,J534	Displays jobs 234 and 534.
$D J1-32767	Displays all jobs in the system under the operators jurisdiction.
$D MR0,yes	Sends a yes message to the host computer operator.
$D N,Q=PPU	Displays the jobs waiting to print or punch at the operators remote terminal.
$D Q,Q=PPU	Displays the number of jobs waiting to print or punch.
$D U,LGN	Displays the VTAM APPLID for JES2.
$D U,PR1	Displays the parameters for printer 1.
$D U,RMT4	Displays the status of devices at remote 4.
$D DATA	Displays information about the job(s) named DATA.

$E restart

The $E command restarts the job currently printing or punching. The operator can restart job output when print or punch output becomes damaged.

The $E commands single operand is the device to restart.

Format

$E dev

Where dev is the device. This command terminates current printing or punching and re-queues the print or punch output.

Examples

$E PR1	Stops the current job printing on printer 1 and re-queues the entire print output.
$E PU1	Stops the current job on punch 1 and re-queues the entire punch output.

$F space forward

The $F command advances the job currently printing or punching. Operators can advance the job a specified number of pages or cards or to the end of the current data set. For example, they can forward space over a long program listing to print only the programs output data set.

The $F command has two operands. The first operand identifies the device. The second operand gives the number of pages or cards to forward space or tells the device to forward space to the end of the current data set.

When the operator forward spaces printed output, the $F command counts page ejects (that is, skips to channel 1), not physical pages. If no pages eject in the data set being printed, $F forward spaces to the end of the data set.

Format

$F dev,y

Where dev is the output device and y is either a number indicating the number of pages or cards to skip or the letter D to forward space to the end of the data set. If the device encounters the end of a data set during a forward space, printing or punching resumes at the beginning of the next data set. If the operator does not specify a y operand, a 1 is assumed.

Examples

$F PR1	Forward spaces the output one page on printer 1.
$F PR1,5	Forward spaces the output five pages on printer 1.
$F PR2,D	Forward spaces the output to the end of the data set on printer 2.
$F PU1,6	Forward spaces the output six cards on punch 1.

$H hold

The $H command puts a job under the operators jurisdiction on hold. If a job is queued and on hold, the job remains queued and the system takes no action on the job. If the job is active, the job finishes its current activity and then re-queues. If a job is awaiting print, punch, or execution, it remains in that state until it is released. If a job is being read, it finishes being read and then enters the execution queue on hold. A job currently executing finishes execution and enters the print queue on hold.

The operator can specify a job name or number with the $H command.

Format

$H jobname	Where jobname is the name of the job to place on hold.
$H Jnnnn	Where nnnn can be a single job number to place that job on hold or a range of job numbers to place a series of jobs on hold.

Examples

$H MYJOB	Places the job named MYJOB on hold.
$H J357	Places job 357 on hold.
$H J240-500	Places all jobs ranging from 240 to 500 on hold.
$H J250,J630	Places only jobs 250 and 630 on hold.

$I interrupt

The $I command interrupts the job currently printing or punching and queues the remaining portion for later printing or punching. The job resumes output according to job priority. The output automatically backspaces one page or card to prevent data loss.

The $I command allows the operator to interrupt a large job and print smaller jobs of higher priority. When the small jobs complete, the operator can resume printing the large job.

Format

$I dev

Where dev is the device to interrupt.

Example

$I PR1

Interrupts the job currently printing on printer 1 and re-queues the rest of the job for later printing.

To print a short job with a priority lower than or equal to the job currently printing, complete the following steps.

Hold the job currently printing.
Interrupt the printer.
Start the short job and then release the job on hold.

$L list

The $L command displays output attributes for a job, including form name, FCB name, and class. JES displays the status of any jobs submitted from the remote that issued the command, regardless of the output's destination. Operators can use this command to print applications requiring special forms.

E This command is particularly useful for determining why jobs are not printing. Typically, printing problems occur when the job criteria (form and class) do not match the printer criteria. Issue the $DJ1-32767 command to access the job name, then issue the $L command to view the job criteria.

Format

$L Jnnnn,ALL

Where Jnnnn is the job name. Operators can only specify one job name with this command. The ALL operand displays all attributes.

Examples

$D J1-32767	Displays a list of queued jobs so the operator can obtain the job number (see $D).
$L J1845,ALL	Displays the attributes for job 1845.

$N repeat

The $N command requests another copy of the output currently printing or punching. It does not terminate the activity in progress. If another output device is available, the copy begins printing or punching concurrently. If only one device is available, the copy prints or punches after the current activity completes.

Only the SYSOUT data sets that match the current output setup (class, forms, and so forth) will be duplicated. Operators can use this command to make copies of special forms output (for example, mailing labels) without duplicating all the job output or rerunning the job.

Format

$N dev

Where dev is the device.

Examples

$N PR1	Places a copy of the output currently printing on printer 1 in the print queue to create duplicate output.
$N PU2	Places a copy of the output currently being punched on punch 2 into the punch queue to create a duplicate deck.

$O release

The $O command releases the output of a job under the operators jurisdiction from hold.

Operators can specify a job name or number with the $O command.

Format

$O jobname	Where jobname is the name of the job output to release from hold.
$O Jnnnn	Where nnnn can be a single job number to release that jobs output or a range of job numbers to release a series of jobs output from hold.

Examples

$O MYJOB	Releases the output of the job named MYJOB from hold.
$O J357	Releases the output of job 357 from hold.

$P purge

The $P command stops device or job activity after the device or job completes the current activity.

If the operator specifies a job, the software flags it for purging. If the job is inactive, the software purges it. If the job is active, it completes its current activity and then the software purges it.

If the operator specifies a device, the software drains the device if it is inactive. If the device is active, the software sets it to drain. Then the device completes its current activity and drains. A device in the drained state will not start until the operator starts it.

Operators must use the $P command to cancel a job on the output queue because $C will not work.

Operators can specify a job number to purge or device to drain with the $P command.

Format

$P Jnnnn	Where nnnn is the number of the job to purge.
$P dev	Where dev is the device (for example, PR1, RD1, or PU1) to drain.

Examples

$P J333	purges job 333.
$P PR2	drains printer 2.
$P RD1	drains reader 1.

$R route

The $R command routes a jobs output the same way a /*ROUTE statement in JCL does. Operators can route the print or punch output of a job under their jurisdiction to another remote or to the host computer.

The operator can route jobs of a certain type or all jobs with the $R command.

Format

$R type,J=Jnnnn,D=Ryy

Where type is the type of output to route, nnnn is the number of the job to route, and yy is the destination of the routed output.

For the operand type, substitute one of these values:

PRT to route print output.

PUN to route punch output.

ALL to route both print and punch output.

For the operand Ryy, substitute one of these values:

LOCAL to route the output to the host computer.

Rnnnn to route the output to another remote specified by nnnn.

$R ALL,R=Rx,D=Ry

Allows jobs routed to remote Rx to print at either Rx or Ry, whichever is available first. If the operator at remote Ry types this command:

$R PRT,R=Ry,D=Rx

The two remotes share a common print queue. The operator can negate this command by typing the following command:

$R type,R=Rx,D=Rx

This command only affects jobs currently in the queue.

Examples

$R PUN,J=J234,D=LOCAL	Routes the punch output of job 234 to the host computer.
$R ALL,J=J345,D=R3	Routes all job 345s output to remote 3.
$R PRT,J=J345,D=LOCAL	Routes job 345s print output to the host computer.
$R ALL,R=R2,D=R4	Allows jobs routed to remote 2 to print at remote 2 or remote 4.
$R All,R=R2,D=R2	Cancels the alternate option.
$R PRT,R=R1,D=R4	Routes all jobs originally routed to remote 1 to remote 4, including jobs awaiting execution.

$S start

The $S command starts the specified device. This command negates a $P command for devices. If a job is awaiting processing, it becomes active.

Format

$S dev

Where dev identifies the device. Substitute one of these values:

RDn to start reader n.

PRn to start printer n.

PUn to start punch n.

Examples

$S RD1	Starts reader 1.
$S PR1	Starts printer 1.

$T set device option

The $T command sets the devices attributes. The $T command has several operands and uses.

Format

$T dev,K=1	Causes the job currently printing on dev to single space after each print line to the end of the data set and ignore carriage control information supplied by the program. Operators can use this command to prevent a job from skipping lines between data lines because of a programming error. It single spaces to the end of the data set currently printing and can be negated by the $T dev,K=R command.
$T dev,F=ffffffff	Sets the printer to the special form specified by ffffffff, an eight-character special form name. The printer then only prints jobs with that special form name. STD indicates the printer will print only standard or regular forms (no special form was specified in the job). The printer must be inactive for this command to work. Drain the printer first with the $P command and wait until the printer drains before issuing the $T command. After each change of forms from the $T command, the system displays a LOAD FORMS message on the console when the next job starts on the printer. Reply with the $S command.
$T dev,S=ddd	Tells the system whether to print or punch separator (banner and trailer) pages or lines at the beginning and end of each job. The operand ddd is either YES or NO. Operators can use this option to write output to a computer disk.
$T dev,Q (class)	Where class lists from one to eight SYSOUT classes to be processed by this device. The default class is A for printers and B for punches.
$T dev,WS=(criteria)	Specifies the work selection criteria to determine which jobs will be allowed to print on a device and in what order. You can put one slash before or after a selection criterion. A minus sign before the criterion removes that criterion from the list. These criteria are commonly used: W Before the slash, the writer name for the output group must match the devices writer name. After the slash, matching is preferred but not necessary. Q (class) Unless you specify output classes, JES will search all output classes for work; therefore, always use the Q criterion. Before the slash, JES searches output classes in the order specified. After the slash, JES does not prioritize classes. R (destination/route) Before the slash, the output groups destination must match the devices route code (R=). If you specify multiple route codes, JES considers them to be in priority order and prefers a match with the first route code. After the slash, the output groups destination must match the devices route code, but if you specify multiple route codes, JES does not prioritize them. PRM (process mode) Before the slash, the output groups process mode must match the devices process mode (PRMODE=). If you specify multiple process modes, JES considers them to be in priority order. After the slash, the output groups process mode must match the devices process mode, but if you specify more than one mode, JES does not prioritize them. LIM (limit) Before the slash, the amount of output generated by an output group must be within the limits set for the device. JES checks page limits if the data set is in page mode and record limits if the data set is in line mode. After the slash, the limit is preferred but not necessary. F (forms) Before the slash, the forms specification of the output group and output device must match. After the slash, matching is preferred but not necessary. If the two do not match, a setup message ($HASP190) will be sent. FCB Before the slash, the output groups FCB must match the output devices FCB. After the slash, a setup message ($HASP190) will be sent if there are differences in both the FCB and FORMS specifications. UCS/ The output groups UCS must match the devices UCS (UCS=).

Examples

$T PR2,F=2031	Sets printer 2 to form 2031.
$T PR1,F=STD	Sets printer 1 to the standard form.
$T PR3,R=XYZ	Sets printer 3 to route code XYZ.
$T PR2,Q=ACDJS	Sets printer 2 to classes A, C, D, J, and S.
$T PR2,F=STD,Q=AC	Sets printer 2 to the standard form and print classes A and C.
$T PR1,S=N	Deletes header and trailer pages from each job on printer 1.
$T PR2,S=Y	Causes header and trailer pages to print for each job on printer 2.
$T PR1,X=N	Suppresses JES2 translation of lowercase characters and control characters.
$T PR2,S=Y	Causes header and trailer pages to print for each job on printer 2.
$T PR1,WS=(-F)	Removes forms from printer 1s work selection, which means all forms can print.
$T PR1,WS=(F)	Adds forms to printer 1s work selection, and the form on the output group and output device must match (before the slash).
$T PR1,WS=(/F)	Adds forms to printer 1s work selection (after the slash).

$Z halt

The $Z command immediately stops a printer or punch. After the device stops, the operator can restart it one of these ways:

The $E command starts reprinting or repunching the job from the beginning.
The $S command causes the job to resume where the operator stops it.

The operator can use $Z to check items like form alignment and paper feed without affecting the printed output.

Format

$Z dev

Where dev is the device to stop.

Example

$Z PR2

Stops printer 2 immediately.

Order a book or two today - you can download an eBook today for only $1.99!

Just click on a book to learn more!

See also:

Format

Examples

Format

Examples

Format

Examples

Format

Examples

Format

Examples

Format

Examples

Format

Examples

Format

Example

Format

Examples

Format

Examples

Format

Examples

Format

Examples

Format

Examples

Format

Examples

Format

Examples

Format

Example