HP 3000 Manuals HP 3000 Manuals
JOB
The JOB command is used in conjunction with the STREAM command. You can
create an input job file that contains the JOB command. This file
defines a batch job that you submit with the STREAM command. The JOB
command initiates the batch processing and must be the first command line
in the job file.
Syntax
JOB [jobname,]username[/userpass].acctname[/acctpass]
[,groupname[/grouppass]] [;INPRI=inputpriority] [;RESTART]
[;HIPRI ]
[;OUTCLASS=[[device][,[outputpriority][,numcopies]]]]
Parameters
jobname Specifies an arbitrary name used with username and
acctname parameters to form a job identity. The
name must contain from one to eight alphanumeric
characters, beginning with an alphabetic character.
The default is that no job name is assigned.
username Specifies your user name, established by your
system administrator, that enables you to log on to
this account. The name must contain from one to
eight alphanumeric characters, beginning with an
alphabetic character.
userpass Specifies your user password, optionally assigned
by your system administrator. The password must
contain from one to eight alphanumeric characters,
beginning with an alphabetic character. If you
have a password but you do not supply it in the
command syntax, the STREAM command prompts for it
if you:
* Enter the STREAM command from a session.
* Do not redirect either $STDIN or $STDLIST.
* Do not nest the JOB command within a
second-level STREAM command. (The JOB
command is specified as a first-level JOB
command.)
acctname Specifies the account name that the system
administrator establishes. The name must contain
from one to eight alphanumeric characters,
beginning with an alphabetic character. A period
(.) must precede this parameter.
acctpass Specifies the account password that the system
administrator can optionally assign. The password
must contain from one to eight alphanumeric
characters, beginning with an alphabetic character.
If a password exists but you do not supply it in
the command syntax, the STREAM command prompts you
for it if you:
* Enter the STREAM command from a session.
* Do not redirect either $STDIN or $STDLIST.
* Do not nest the JOB command within a
second-level STREAM command. (The JOB
command is specified as a first-level JOB
command.)
groupname Specifies the group name to be used for the local
file domain and for CPU-time charges, as
established by the system administrator. The name
must contain from one to eight alphanumeric
characters, beginning with an alphabetic character.
The default is the home group if one is assigned.
This parameter is required if a home group is not
assigned.
grouppass Specifies the group password that the system
administrator optionally assigns. The password
must contain from one to eight alphanumeric
characters, beginning with an alphabetic character.
You do not need the group password when you log on
to your home group. You need it when you log on in
any other group for which a password exists. If a
password is required but you do not supply it in
the command syntax, the STREAM command prompts you
for it if you:
* Enter the STREAM command from a session.
* Do not redirect either $STDIN or $STDLIST.
* Do not nest the JOB command within a
second-level STREAM command. (The JOB
command is specified as a first-level JOB
command.)
INPRI Specifies the input priority of the job. The
inputpriority value is the relative input priority
used to check against access restrictions imposed
by the jobfence. The inputpriority value becomes
effective at logon time and must be from 1 (lowest
priority) to 13 (highest priority). If you supply
a value less than or equal to the current jobfence,
the job is denied access. The default is 8.
HIPRI Overrides the system jobfence, or overrides the job
limit. When using the HIPRI parameter to override
the jobfence, the system first determines whether
you have system manager (SM) or system operator
(OP) capability. If you have either of these
capabilities, you are logged on, and your INPRI
defaults to the system's jobfence and execution
limit. If you do not have either of these
capabilities, the system attempts to log you on
using INPRI=13 and succeeds if the jobfence is 12
or less, and if the job limit is not exceeded.
You can also specify HIPRI to override the job
limit, but you must have either SM or OP
capability. The system does not override the job
limit automatically. If you use the HIPRI
parameter without SM or OP capability, the
following warning message appears:
MUST HAVE 'SM' OR 'OP' CAP. TO SPECIFY HIPRI,
MAXIMUM INPRI OF 13 IS USED (CIWARN 1460)
RESTART Restarts a spooled job that was interrupted by a
system termination/restart. This parameter
automatically becomes effective when the system is
subsequently restarted with the START RECOVERY
option. The effect is to resubmit the job in its
original form. This parameter applies only to jobs
initiated on spooled input devices. The default is
that spooled jobs are not restarted after a system
termination and restart.
OUTCLASS Specifies the output class with one or more of the
following values:
device Indicates the class name or
logical device number (LDEV)
of the device to receive
listing output. You cannot
specify a magnetic tape unit.
If the value is not a valid
LDEV or class name, an error
occurs. The default is
defined in the system
configuration. You can only
supply a device if you have
nonshareable device (ND) file
access capability.
outputpriority Indicates the output priority
for the job list file, if
destined for a spooled line
printer. You can use
outputpriority to select the
next spooled device file (on
disk) for output from among
all those contending for a
specific printer. This
parameter applies only to
output destined for spooled
output devices and is ignored
for other output.
The value must range from 1
(lowest priority) to 13
(highest priority). When
outputpriority is 1, output
is always deferred. To print
output from disk, use an
outputpriority of 2 or
greater. The default is 8.
If spooling logging is
disabled, the default is 13.
numcopies Indicates the number of job
listing copies to be
produced. The numcopies
parameter only applies when
the listing is directed to a
spooled device, and it is
ignored in other cases. The
default value is 1. If the
number of copies is less than
1, a warning appears;
however, the command still
executes with the default
value of 1. If the number of
copies is greater than 127,
an error message appears, and
127 copies are printed.
Operation Notes
* Usage
You can enter this command only from a job file. You cannot enter
it from a session, a job, a program, or in break mode. Pressing
Break does not affect this command.
* Requirements
To properly use this command, you must adhere to the following
requirements:
* Terminate the JOB command with an EOJ command.
* Precede the JOB command and EOJ command with an appropriate
substitute prompt character for the colon prompt. By
default, the system expects you to use an exclamation point
(!).
* Supply your username and accountname. If you omit either
of these parameters or enter them incorrectly, the system
rejects your job and prints error messages on the standard
listing device and the console. Depending on how your
system administrator has set up users on the system, you
may also have to supply a logon group name as well as user,
account, and/or group passwords.
* Command process
If the system accepts your job, the system displays the following
information on the list device:
* job number, as assigned by the system to identify the job
* date and time
* Job number
The job number that the system assigns always uniquely identifies
your job to the system and other users. The system assigns these
numbers in sequential order as jobs are accepted.
Examples
* To create a job file and submit it for processing, do the
following:
1. Enter the following command to invoke the EDIT subsystem:
:EDITOR
2. Enter the ADD command, then add job file commands, as
shown:
/ADD
1 !JOB SMITH,USER.TECH
2 !COMMENT THIS JOB RUNS THE MONTHLY UPDATE PROGRAM
3 !FILE INPUT01=TRANS.DATA.ENGR
4 !FILE MASTER;DEV=TAPE
5 !FILE OUTPUT=NEWFILE.PUB.TECH
6 !RUN UPDPROG
7 !EOJ
8 //
Note that the first command is the JOB command and that an
exclamation point (!) precedes each command.
3. Enter the KEEP and END commands to save your file and
terminate the EDITOR subsystem:
/KEEP MYJOB,UNN
/END
4. Submit the job file for processing by using the STREAM
command:
:STREAM MYJOB
Note that the file MYJOB remains on disk after you stream it.
Consequently, you can stream it again at any time, if desired.
Related Commands
EOJ
JOBFENCE
LIMIT
STREAM
STREAMS