JES2 operator commands allow remote terminal A terminal that is located at a site removed from the computer to which it is attached. Remote terminals rely on modems and telephone lines to communicate with the host computer. operators to communicate with the JES2 system. This section lists the most commonly used JES2 remote commands, command types, command format, and job control.
There are two categories of JES2 commands.
Commands used to display information about the system, devices, or jobs in the system.
Commands used to control the JES2 system and operations for the jobs and devices under the operators jurisdiction.
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 on data lines, you must begin them with /* as follows.
|
/*$verb operand1,operand2 |
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 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 |
|
$C cancel |
job |
|
$D display |
job, queue |
|
$H hold |
job |
|
$P purge |
job |
|
$R route |
job, queue |
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.
|
$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. |
|
$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. |
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.
|
$C Jnnnn |
Where nnnn is the number of a job to cancel. |
|
$C J545 |
Cancels job 545. |
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.
|
$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:
|
|
$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 jobname |
Displays a list of all jobs in the system with that job name, including jobs not under the operators jurisdiction. |
|
$D J244 |
Displays job 244. |
|
$D J234,J534 |
Displays jobs 234 and 534. |
|
$D J1-99999 |
Displays all jobs in the system under the operators jurisdiction. |
|
$D MR0,yes |
Sends a yes message to the host computer operator. |
|
$D U,LGN |
Displays the VTAM APPLID for JES2. |
|
$D DATA |
Displays information about the job(s) named DATA. |
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.
|
$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. |
|
$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. |
The $P command stops job activity after the 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.
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.
|
$P Jnnnn |
Where nnnn is the number of the job to purge. |
|
$P J333 |
Purges job 333. |
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.
|
$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:
For the operand Ryy, substitute one of these values:
|
|
$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. |
|
$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. |