Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
JOB Initiates a batch job.
JOB [jobname,]username[/userpass].acctname[/acctpass] [,groupname[/grouppass]] [;TIME=cpusecs] {BS} {CS} [;PRI= ] {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.
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 or HIPRI 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. 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.
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.
The "&" symbol has no meaning to the input spooler when it reads records because the CI is not involved at that point.
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.
!JOB WXYZ,WRITER.TEC !EDITOR TEXT ABC LIST ALL,OFFLINE EXIT !EOJ !JOB ABC,MANAGER.SYS;JOBQ=myjobq !SHOWME !EOJ
Commands: STREAM Manuals : Performing System Operation Tasks (32650-90137) MPE/iX Intrinsics Reference Manual (32650-90028) Back to Main Index