HP 3000 Manuals HP 3000 Manuals
JOB
Defines a job to be activated with the STREAM command or an input spooled
device to run in batch mode. (Native Mode)
Syntax
JOB [jobname,]username[/userpass].acctname[/acctpass][,groupname[/grouppass]]
[ {BS}]
[;TIME=cpusecs][;PRI={CS}] [;INPRI=inputpriority] [;RESTART]
[ {DS}] [;HIPRI ]
[ {ES}]
[;OUTCLASS=[[device][,[outputpriority][,numcopies]]]] [;TERM={termtype}]
[;PRIVATE] [;SPSAVE]
Parameters
jobname 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. Default is
that no job name is assigned.
username User name, established by the account manager, that
allows you to log on to this account. The name
must contain from one to eight alphanumeric
characters, beginning with an alphabetic character.
userpass User password, optionally assigned by account
manager. The password must contain from one to
eight alphanumeric characters, beginning with an
alphabetic character. If a password exists, but is
not supplied in the command syntax, the STREAM
command will prompt you for it if:
* The STREAM command is invoked from a
session.
* Neither $STDIN nor $STDLIST is redirected.
* The JOB command is a first level JOB command
(it is not nested within a second level
STREAM command).
If the password is supplied in the command syntax
it must be preceded by a slash (/).
acctname Account name as established by the system manager.
The name must contain from one to eight
alphanumeric characters, beginning with an
alphabetic character. The acctname parameter must
be preceded by a period (.).
acctpass Account password, optionally assigned by the system
manager. The password must contain from one to
eight alphanumeric characters, beginning with an
alphabetic character. If a password exists, but is
not supplied in the command syntax, the STREAM
command will prompt you for it if:
* The STREAM command is invoked from a
session.
* Neither $STDIN nor $STDLIST is redirected.
* The JOB command is a first level JOB command
(it is not nested within a second level
STREAM command).
If the password is supplied in the command syntax
it must be preceded by a slash (/).
groupname Group name to be used for the local file domain and
for CPU-time charges, as established by the account
manager. The name must contain from one to eight
alphanumeric characters, beginning with an
alphabetic character. Default is home group if one
is assigned. (Required if a home group is not
assigned.)
grouppass Group password, optionally assigned by the account
manager. The password must contain from one to
eight alphanumeric characters, beginning with an
alphabetic character. The group password is not
needed when you log on to your home group. It is
needed when you log on under any other group for
which a password exists. If a password is needed,
but is not supplied in the command syntax, the
STREAM command will prompt you for it if:
* The STREAM command is invoked from a
session.
* Neither $STDIN nor $STDLIST is redirected.
* The JOB command is a first level JOB command
(it is not nested within a second level
STREAM command).
If the password is supplied in the command syntax
it must be preceded by a slash (/).
cpusecs Maximum CPU time allowed job, in seconds. When
this limit is reached, the job is aborted. This
must be a value from 1 to 32,767. To specify no
limit, enter a question mark or UNLIM, or omit this
parameter. Default is a system-configured job
limit.
BS, CS, DS, or ES The execution priority queue that the command
interpreter uses for your session. This is also
the default priority for all programs executed
within the session. BS is the highest priority; ES
is the lowest. If you specify a priority that
exceeds the highest priority permitted for your
account or user name by the system, MPE/iX assigns
the highest priority possible below BS. DS and ES
are intended primarily for batch jobs; their use
for sessions is generally discouraged. DS is the
default and the maximum priority, unless modified
by system management.
__________________________________________________
NOTE Use care in assigning the BS queue.
Processes in this priority class can lock out
other processes.
For information on the guidelines for these
priority queues, refer to the TUNE command in
this chapter.
__________________________________________________
inputpriority or Determines the input priority of the job. The
HIPRI inputpriority parameter is the relative input
priority used in checking against access
restrictions imposed by the jobfence. The
inputpriority parameter takes effect 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 set by the system
operator, the job is denied access. Default is 8.
The HIPRI option is used for two different purposes
when logging on. It can be used to override the
system jobfence, or it can be used to override the
job limit. When using the HIPRI option to override
the jobfence, the system first checks to see if 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. In
attempting to override the job limit (to log on
after the maximum number of jobs set by the
operator has been reached), you can specify HIPRI,
but to do so you must have either SM or OP
capability. The system does not override the job
limit automatically. Use of the HIPRI option
without SM or OP capability causes the following
warning to be displayed:
MUST HAVE 'SM' OR 'OP' CAP. TO SPECIFY HIPRI,
MAXIMUM INPRI OF 13 IS USED (CIWARN 1460)
RESTART Request to restart a spooled job that has been
interrupted by the system termination/restart.
This parameter takes effect automatically 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. It is ignored for other
jobs. Default is that spooled jobs are not
restarted after system termination/restart.
device Class name or logical device number (ldev) of the
device to receive listing output. You cannot
specify a magnetic tape unit. If the parameter is
not a valid LDEV or class name, an error is
generated. Default is defined in the system
configuration.
__________________________________________________
NOTE Nonshareable device (ND) file access
capability is required in order to use this
parameter.
__________________________________________________
outputpriority The output priority for job list file, if destined
for spooled line printer. This parameter is used
to select the next spooled device file (on disk)
for output, from among all those contending for a
specific printer. Must be a value from 1 (lowest
priority) to 13 (highest priority). When
outputpriority is 1, output is always deferred.
To have output printed from disk, use an
outputpriority of 2 or greater.
This parameter applies only to output destined for
spooled output devices, and is ignored for other
output. Default is 8.
numcopies Number of copies of job listing to be produced.
This parameter applies only when listing is
directed to a spooled device, and is ignored in
other cases. If the number of copies is less than
1, a warning is issued. The command still executes
with the default value of 1. If the number of
copies is greater than 127, an error message is
printed, and 127 copies are printed. Default is 1.
termtype The TERM= option is obsolete now that the JOB
command cannot be used interactively. In order to
maintain backward compatability, the termtype
parameter is still parsed, but it is not used. If
the TERM= option is used, a warning message will be
displayed.
PRIVATE The PRIVATE option forces the job output $STDLIST
to be a private spoolfile. The spoolfile is only
accessible to privileged users on the system.
Private spoolfiles may not be saved or copied.
They may only be purged, printed, or (within
limits) altered.
SPSAVE If this option is used, the resulting job output
$STDLIST spoolfile is created with an SPSAVE
disposition. This means that the spoolfile is not
to be purged after the last copy of it has been
printed, but is instead retained in the OUT.HPSPOOL
group. SPSAVE may not be used if PRIVATE has been
specified.
NOTE The "&" symbol has no meaning to the input spooler when it reads
records because the CI is not involved at that point.
Operation Notes
The JOB command is not used at the colon prompt (:). Rather, it is used
in interactive mode with the STREAM command at the > prompt, or within an
input jobfile, created to define a batch job. The job defined with this
command is then activated (executed) with the STREAM command.
The JOB command is preceded by an appropriate substitute prompt character
for the colon prompt. By default, MPE/iX expects the exclamation point
(!) to be used. The JOB command must be terminated with an EOJ command.
Refer to the STREAM command.
When MPE/iX begins the job, it displays the following information on the
list device:
* Job number, as assigned by MPE/iX to identify the job.
* Date and time.
* "HP 3000," and the modified and base MPE/iX version.update.fix
numbers.
In the JOB command, as in the HELLO command, you must always supply your
username and acctname, which you obtain from your account manager. If
you omit either of these parameters, or enter them incorrectly, MPE/iX
rejects your job and prints error messages on the standard listing device
and the console. If your job is accepted, MPE/iX begins job processing.
The job is entered with the STREAM command or through a spooled input
device. Then the job is copied to an input spoolfile. The job is
initiated from that spoolfile rather than the originating diskfile (in
the case of the STREAM command) or device (in the case of the input
spooled device). If the standard listing file is a line printer, MPE/iX
prints a header page prior to listing the JOB command. (The system
operator can disable the printing of this header page with the HEADOFF
console command.)
The job number assigned by MPE/iX always uniquely identifies your job to
MPE/iX and other users. MPE/iX assigns such numbers in sequential order
as jobs are accepted. Sometimes, the job acceptance information includes
a message from the system operator following the standard display. When
present, this is the same message output in the logon information for
sessions.
The minimum information needed for job initiation is the user and account
name. However, the following also may be required:
* Logon group name.
* User, account, and/or group passwords.
The cases in which this information is required, and the rules for
supplying it, are the same as those for the HELLO command for sessions,
except that:
* When you enter the JOB command through a device other than a
terminal, and the standard input device is different from the
standard listing device, MPE/iX does not echo passwords.
* When the standard listing device is a line printer and you do not
specify a file group name, central processor time limit, execution
priority, and/or input priority in the JOB command, the default
values assigned by MPE/iX for the omitted parameters appear on the
job listing.
The STREAM command prompts for any necessary passwords that are not
supplied in the command syntax if:
* The STREAM command is invoked from a session.
* Neither $STDIN nor $STDLIST is redirected.
* The JOB command is a first level JOB command (it is not nested
within a second level STREAM command).
All UDCs are available from a job. Any subsystem or UDC that expects
input from $STDIN requires that input within your job stream file.
Use
This command may be issued only from a job file. It may not be used from
a session, program, or in BREAK. Pressing Break has no effect on this
command.
Example
The following example illustrates creating and using an ASCII file to
define a batch job and then executing it with the STREAM command:
RUN EDITOR.PUB.SYS
/ADD
1 !JOB WXYZ,WRITER.TEC
2 !EDITOR
3 TEXT ABC
4 LIST ALL,OFFLINE
5 EXIT
6 !EOJ
//
/KEEP MYJOB
/EXIT
:
STREAM MYJOB
The following example shows using the JOB command in interactive mode
with the STREAM command:
STREAM
>!JOB USER.TECHPUBS;OUTCLASS=12
Related Information
Commands ABORTJOB, ALTJOB, BREAKJOB, SUSPENDJOB, RESUMEJOB,
JOBFENCE, JOBPRI, STREAM, STREAMS, SHOWDEV
Manuals Using the 900 Series HP 3000: Advanced Skills (31126A Opt.
002)
MPE/iX Intrinsics Reference Manual (32650-90028)