JOB


JOB


Initiates a batch job.

SYNTAX


JOB [jobname,]username[/userpass].acctname[/acctpass][,groupname[/grouppass]]
[;TIME=cpusecs]
[;PRI= {BS} | {CS} | {DS} | {ES} ]
[{;INPRI=inputpriority}]
{;HIPRI }
[;RESTART]
[;OUTCLASS=[device][,outputpriority[,numcopies]]]
[;TERM={termtype}]
[;PRIVATE]
[;SPSAVE]
[;JOBQ={queuename} ]

NOTE When this command appears immediately after the prompt
is part of an input spool file it is preprocessed by the
input spooler before it is interpreted by the CI. It
cannot be hidden or protected by continuation "&" or by
quotation "'" or '"' characters.

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

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 a
alphabetic character. The acctpass parameter 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 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 Account
Manager. The password must contain from one to
eight alphanumeric characters, beginning with an
alphabetic character. (The grouppass parameter must
be preceded by a slash (/). The grouppass parameter
is not needed when you log on to your home group.

cpusecs Maximum CPU time allowed job, in seconds. When this
limit is reached, 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 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 highest priority, ES is lowest.
If you specify a priority that exceeds the highest
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.

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.

inputpriority Determines the input priority of the job. The
inputpriority option is the relative input priority
used in checking against access restrictions
imposed by the jobfence. The inputpriority
option 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.

HIPRI 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 will
first check to see if you have system manager
(SM) or system operator (OP) capability. If you
have either of these capabilities, you will be
logged on and your INPRI will default to the
system's jobfence and execution limit. If you
do not have either of these capabilities, the
system will attempt to log you on using INPRI=13
and will succeed 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 will 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 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 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 will be generated.
Default is defined in the system configuration.

NOTE


Nonsharable 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 next spooled devicefile (on disk) for output,
from among all those contending for a specific
printer. Must be a value from 1 (one) (lowest
priority) to 13 (highest priority). Note that when
the outputpriority is 1, output is always deferred.
Thus, you should use an outputpriority of 2 or
greater if you wish output printed from disk.

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 (one) a
warning will be issued. The command will still
execute with the default value of 1. If it is
greater than 127, an error message will be printed
and 127 copies will be printed. Default is 1 (one).

termtype Determines the terminal-type characteristics. The
termtype parameter determines the type of terminal
used for input. MPE/iX uses this parameter to
determine device dependent characteristics such as
delay factors for carriage returns. It must be 10
or 18. The default value for termtype is assigned by
the system supervisor during system configuration.
This is a required parameter to ensure correct
listings if your terminal is not the default
termtype.

If group or account names are omitted, the proposed
logon group and/or account name is substituted.

PRIVATE The PRIVATE option forces the job output $STDLIST to
be a private file. The file 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. If
you specify PRIVATE, you may not specify SPSAVE.

SPSAVE If this option is used, the resulting job output
$STDLIST spoolfile is created with the SPSAVE
disposition. This means the spoolfile is not to be
purged after the last copy of it has been printed.
It is retained in the OUT.HPSPOOL account. If you
specify SPSAVE, you may not specify PRIVATE.

queuename Name of the job queue into which the job should logon.

NOTE

     The "&" symbol has no meaning to the input spooler when it reads
records because the CI is not involved at that point.

OPERATION


Initiates a batch job by establishing contact with MPE/iX.
When MPE/iX begins the job, it displays the following
information on the list device

o Job Number, as assigned by MPE/iX to identify the job.

o Date and time.

o "HP 3000", and the modified and base MPE/iX
version.update.fix numbers.

This command may be issued only from a job. It may not be
used from a session, program or in BREAK. Pressing [Break]
has no effect on this command.

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 names, 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. If the
job is entered through a spooled input device, the job is
copied to a disk file and initiated from that file rather
than the originating 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 page via the console command HEADOFF.)

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. Under certain circumstances, however, you
may need to furnish the following additional information in
your JOB command.

o Logon Group Name.

o 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

o When you omit a required password from the JOB command,
MPE/iX rejects your access attempt without prompting you for
the password.

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

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

All UDCs are available from a job. Any subsystem or UDC that
expects input from $STDIN will require that input in your job stream.

Users can specify the job queuename into which a particular job
should logon using the ;JOBQ parameter. Otherwise the default
system job queue will be used. If a job queue is specified with the
STREAM command, then it overrides the queue specified in the JOB command.

EXAMPLE(S)

     !JOB WXYZ,WRITER.TEC
     !EDITOR TEXT ABC
     LIST ALL,OFFLINE
     EXIT
     !EOJ

     !JOB ABC,MANAGER.SYS;JOBQ=myjobq
     !SHOWME
     !EOJ

ADDITIONAL INFORMATION

Commands:   STREAM

Manuals :   Performing System Operation Tasks (32650-90137)
            MPE/iX Intrinsics Reference Manual (32650-90028)