Job Statement
Job Statement Format
The job statement names a job, supplies accounting information, and supplies options that affect the processing of the job.
Format (A caret (^) indicates a space.):
//jobname^JOB^(*),username,TIME=(n,nn ),NOTIFY=*,
// CLASS=a,MSGLEVEL=(n,n),MSGCLASS=a,TYPRUN=aaaa
In this and the following examples, a represents an alphanumeric value and n represents a numeric value. You will need to supply these values.
Jobname
The jobname can be your userid or any name you select. The first character of the jobname must be alphabetic. The name may contain up to eight characters including the national characters, $, #, and @. To view your output via TSO and the OUTPUT command, you must include your userid in the jobname. To view your output via TSO and the IOF command, you may use any properly coded name.
Examples:
TRNSCRPT
U12345A
CHK#3
Accounting Information
The asterisk allows the system to supply the accounting information from your userid.
Username
The username is the name of the person the job belongs to. It must be enclosed in single quotes if it contains blanks or special characters and may be a maximum of twenty characters including the quotes.
Examples:
JACKSON
‘DEREK JACKSON’
‘C. R. JACKSON, III’ (maximum length)
Class Parameter
Format:
CLASS=a
The class parameter is used to group similar jobs together according to time requirements and tape or printer resource needs. Replace a with one of the following options.
Class Parameter Options
1. Five seconds or less with no tape mounts
2. (default) One minute or less with no tape mounts
3. No time limit and no tape mounts
4. Time available processing with no time limit and no tape mounts (The cost for Class 4 processing is 10% of the first shift rate. This class is designed for large research projects only and permission from CIS is required. There is no guarantee that a Class 4 job will run on the same day that it is submitted. Additional information is available in this module in the section titled Second and Third Shift Processing.)
C No limits (restricted to ISS Production use)D Less than one minute with no more than one tape mount (restricted to ISS Development use)X Less than or equal to one minute with a maximum of three tape mounts (at a time) availableY Less than or equal to five minutes with a maximum of three tape mounts (at a time) availableZ No time limit with a maximum of three tape mounts (at a time) available
Time Parameter
Format:
TIME=(n,nn)
The time parameter specifies the processing time limit in minutes and seconds. The first positional subparameter, n, represents 0 to 9 minutes. The second positional subparameter, nn, represents 00 to 60 seconds.
Notify Parameter
Format:
NOTIFY=*
The notify parameter specifies who the system should notify under TSO when the job has completed processing. The asterisk indicates that the person who submitted the job will be notified.
Message Level Parameter
Format:
MSGLEVEL=(n,n)
The message level parameter controls the printing of allocation messages and JCL. Replace the first positional subparameter, n, with one of the JCL subparameter options. Replace the second positional subparameter, n, with one of the allocation subparameter options.
JCL Subparameter Options
1. All user supplied JCL and the JCL used in executed catalogued procedures will be printed.
2. (default) Only user supplied JCL will be printed.
Allocation Subparameter Options
1. (default) No allocation messages are printed unless the job terminates abnormally.
2. All data set allocation and de-allocation messages are printed.
Message Class Parameter
Format:
MSGCLASS=a
The message class parameter is used to specify the format of the output. Some special message classes specify laser printer formats. They are defined in this module in the section titled SYSOUT Data Sets. Replace a with one of the following options.
Message Class Options
A Output will be printed on the impact printer in the Machine Room or on any other printer depending upon the print destination specified.X Output will be held under TSO so that it may be scanned before being released to print through IOF or OUTPUT. Output will be deleted after 72 hours if not released to print.Y Output will be held for one hour and then deleted. To print the output, change the "Y" before the output is deleted.
Type Run Parameter
Format:
TYPRUN=aaaa
The type run parameter is optional. If, you choose to include it in your job statement, replace aaaa with one of the following options.
Type Run Parameter Options
HOLD The job will not be scheduled for processing until it is released. SCAN The JCL will be scanned for correct syntax. The only output will be the JCL and any error messages. The actual processing of the job will not be started until the job is resubmitted without the scan option.
Second and Third Shift Processing
Processing time on the IBM 3090 mainframe computer is divided into three sections (shifts).
1. 7:00 a.m. to 6:00 p.m.
2. 6:00 p.m. to midnight
3. midnight to 7:00 a.m.
Jobs may be run during the second or third shift at a lower cost than during the first shift. The rate for the second shift is 70% of the first shift rate. The rate for the third shift is 40% of the first shift rate.
Format (A caret (^) indicates a space.):
//jobnam@m^JOB^(*),username,TIME=(n,nn),NOTIFY=*,
// CLASS=a,MSGLEVEL=(n,n),MSGCLASS=a,TYPRUN=HOLD
The shift designator, @m, must be the last two characters in the jobname. Use @2 to release a job at 6:00 p.m. or @3 to release a job at midnight. If the job is submitted during the second or third shift, the type run parameter is not necessary. (If the job is not finished processing by 7:00 a.m., it will be cancelled.) Additional information is available in this module in the section titled CLASS Parameter.
Job Statement Examples
Example (A caret (^) indicates a space.):
//SAMPLE@2^JOB^(*),’KAREN A. HOLT’,TIME=(0,5),
// CLASS=1,TYPRUN=HOLD,MSGLEVEL=(1,1),NOTIFY=*
The jobname is SAMPLE@2. The accounting information is automatically supplied from the TSO userid by the use of the asterisk. The username is KAREN A. HOLT. It is enclosed in single quotes because it contains spaces and a period.
The time parameter requests that the maximum processing time allotted to this job be five seconds.
The class 1 parameter is used because there are no tape mounts and the maximum time allotment for Class 1 is five seconds.
The type run parameter and the @2 shift designator request that this job be held until the beginning of the second shift (6:00 p.m.).
The message level parameter requests that all JCL and allocation messages be included in the output.
The notify parameter requests that a message be sent (via a TSO terminal) to the person who submitted the job.
Example (A caret (^) indicates a space.):
//B19999A^JOB^(*),KIMBERLY,TIME=2,CLASS=3,TYPRUN=SC AN
The jobname is B19999A. The userid, B19999A, permits viewing the output via TSO and the OUTPUT command.
The accounting information is automatically supplied from the TSO userid by the use of the asterisk.
The username is KIMBERLY. It does not require quotes to be used.
The time parameter requests that the maximum processing time allotted to this job be two minutes.
The class 3 parameter is used because there are no tape mounts and there is no time limit for Class 3.
The type run parameter requests that this JCL be scanned for errors.
