JES2 commands

RJE Console

The mainframe job entry system (MVS/JES2) views BARR/RJE as a remote device. This topic provides a quick reference to the most-used JES2 remote commands. For more information about these commands, see your IBM manual or consult your host programmer.

See also:


JES2 command types

There are two categories of JES2 commands.

JES2 command format

Enter JES2 commands from a console as follows.

$verb operand1,operand2

Parameter

Description

$

The JES2 command identification character. You can insert blanks anywhere in the command after the initial $, but they are usually not necessary.

verb

A single-character verb that identifies the action to take.

operand

Modifies the verb or command or identifies the job or system facility to act on. Use commas to separate operands when you specify more than one operand.

When you enter JES2 commands embedded in JCL, you must begin them with /* as follows.

/*$verb operand1,operand2

JES2 device names

RJE devices (readers, printers, and punches) are operands in many of the commands. Device names consist of two parts: device type and device number. For example, RD1 is reader 1 and PR2 is printer 2.

Because many remote terminals Terminals that are located at sites removed from the computers to which they are attached. Remote terminals rely on modems and telephone lines to communicate with the host computer. have only one reader, one punch (if any), and one printer, most examples in this section use RD1, PU1, or PR1. You can specify up to 4 readers, 4 punches, or 7 printers, depending on the number and type of devices supported at your remote.

JES2 job control

JES2 commands limit job or device manipulation to the remote operators jurisdiction. A job is under the operators jurisdiction if the jobs output is routed to that node or if the job was submitted from that node. If a job submitted to JES2 has not been routed by a /*ROUTE statement or a DEST parameter, the job output automatically routes back to the same facility that submitted it.

Operator command restrictions prevent outside manipulation or loss of a job and ensure the systems integrity.

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.

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.

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.

  1. Hold the job currently printing.

  2. Interrupt the printer.

  3. 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.

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 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.