DATE: 11/06/85

SECTION: JOB CONTROL LANGUAGE REVISED:

SUBJECT: GENERAL INFORMATION

THE FOLLOWING CHAPTER IS INTENDED TO ESTABLISH THE JCL STANDARDS TO BE USED BY THE COMPUTER SERVICES DIVISION. IT IS NOT EXPECTED TO SERVE AS A TECHNICAL MANUAL FOR THE PREPARATION OF JCL. FOR ANSWERS CONCERNING THE EXACT FORMAT OF COVERED SUBJECTS, OR DISCUSSION OF OMITTED SUBJECTS, PLEASE REFER TO THE IBM JCL MANUAL.

CHAPTER: PROGRAMMING NUMBER: 5.1.02.01

DATE: 11/06/85

SECTION: JOB CONTROL LANGUAGE REVISED: 08/15/89

SUBJECT: JOB STATEMENT

THE JOB STATEMENT MARKS THE BEGINNING OF A JOB AND IS REQUIRED AT THE BEGINNING OF ALL JCL JOB STREAMS. THE REQUIREMENTS FOR TESTING JOBS AND FOR PRODUCTION TURNOVER DIFFER SLIGHTLY. THE JOB STATEMENT PARAMETERS ILLUSTRATED BELOW ARE THE MINIMUM REQUIRED FOR PRODUCTION TURNOVER AND TESTING OF JOBS.

//JOBNAME JOB (ACCOUNTING DATA),'PROGRAMMER NAME',
// USER=USERID,PASSWORD=PASSWORD,
// TIME=(MM,SS),MSGLEVEL=(J,A)

JOBNAME -REFER TO 2.3.03.01

ACCOUNTING DATA ACCOUNTING DATA IS INSTALLATION DEFINED AND HAS BEEN DEFINED BY COMPUTER SERVICES DIVISION IN THE FOLLOWING FORMAT:

(ACCTNUMB,LINES,CARDS,FORMS,COPIES,LINECNT)

A. ACCTNUMB THE EIGHT CHARACTER ACCOUNT NUMBER ASSIGNED TO THE DEPARTMENT, AGENCY, OR APPLICATION AREA FOR BILLING PURPOSES.

B. LINES THE NUMBER OF LINES, IN THOUSANDS TO BE PRINTED BY THE JOB. THE SYSTEM DEFAULT IS ONE THOUSAND (1000) LINES. THE JOB WILL ABNORMALLY END WITH A SYSTEM CODE S722 IF THE SPECIFIED OR DEFAULT LINES ARE EXCEEDED. THE MAXIMUM ACCEPTABLE LINES FOR PRO- DUCTION JOBS IS ONE HUNDRED THOUSAND (100,000). ANY JOB WITH MORE PRINT OUTPUT THAN THIS MUST BE SPOOLED TO TAPE OR MASS STORAGE AND PRINTED WITH THE USCPRINT OR MSSPRINT UTILITIES.

C. CARDS THE NUMBER OF CARDS, IN TENS, TO BE PUNCHED BY THE JOB. THE SYSTEM DEFAULT IS ZERO (0) CARDS. THE JOB WILL ABNORMALLY TERMINATE IF THE SPECIFIED OR DEFAULT CARDS ARE EXCEEDED. THE MAXIMUM NUMBER OF PUNCHED CARDS ACCEPTABLE FOR PRODUCTION WORK IS TWENTY-FIVE THOUSAND (25,000). ANY JOB WITH MORE PUNCH OUTPUT THAN THIS MUST BE SPOOLED TO TAPE OR MASS STORAGE AND PUNCHED WITH THE USCPUNCH OR MSSPUNCH UTILITIES.

CHAPTER: PROGRAMMING NUMBER: 5.1.02.02

DATE: 11/06/85

SECTION: JOB CONTROL LANGUAGE REVISED: 11/21/91

D. FORMS THIS IS THE FORM NUMBER TO BE USED FOR PRINTING THIS JOB'S OUTPUT. THIS SUB-PARAMETER SHOULD BE USED INSTEAD OF THE FORM OPTION OF THE SYSOUT PARAMETER IF THE ENTIRE JOB IS TO BE PRINTED ON OTHER THAN ONE-PART 14 7/8 X 11 LINED STOCK.

E. COPIES CODING OF THIS SUB-PARAMETER WILL CAUSE MULTIPLE PRINTING OF ALL OUTPUT FOR THIS JOB, INCLUDING JCL AND TERMINATION/ALLOCATION MESSAGES. THIS MAY BE USED WHEN MORE THAN ONE ORIGINAL IS REQUIRED OR WHEN COPIES REQUIRED EXCEED FIVE (5).

F. LINECNT SPECIFIES THE NUMBER OF LINES TO BE PRINTED ON A _E_&L0H_&A8L BEFORE PAGE OVERFLOW IS PERFORMED.

USERID THE ONE TO SEVEN CHARACTER PRODUCTION RACF IDENTIFICATION CODE ASSIGNED TO THE APPLICATION AREA OR INDIVIDUAL.

PASSWORD PASSWORDS ARE FIVE TO EIGHT CHARACTERS IN LENGTH. THE PASSWORD SPECIFIED IS THE PASSWORD CURRENTLY ASSIGNED TO THE PREVIOUSLY SPECIFIED USERID. WHEN SUBMITTING JOBS, OR STORING JOB STREAMS IN TSO OR CMS THE PASSWORD SHOULD CONTAIN EIGHT QUESTION MARKS '????????'. AT THE TIME OF SUBMISSION, THE SYSTEM WILL REPLACE THE QUESTION MARKS WITH YOUR CURRENT PASSWORD. E.G. PASSWORD=????????

IF IT BECOMES NECESSARY TO CHANGE THIS PASSWORD IN TESTING APPLICATIONS, THIS KEYWORD PARAMETER SHOULD BE CODED AS:

PASSWORD=(CURRPSWD,NEWPSWD),

CHAPTER: PROGRAMMING NUMBER: 5.1.02.03

DATE: 11/06/85

SECTION: JOB CONTROL LANGUAGE REVISED: 08/15/89

TIME=(MM,SS)
THE AMOUNT OF CPU TIME REQUIRED TO RUN THE JOB, WHERE MM REPRESENTS MINUTES AND SS REPRESENTS SECONDS. THE SYSTEM DEFAULT IS TEN (10) SECONDS.

MSGLEVEL=(J,A)
THE MESSAGES WHICH WILL BE WRITTEN AS OUTPUT FROM THE JOB WHERE "J" SPECIFIES THE JOB CONTROL STATMENTS AND "A" SPECIFIES THE ALLOCATION/TERMINATION MESSAGES. THE SYSTEM DEFAULT IS (2,0). ALL PRODUCTION JOBS REQUIRE MSGLEVEL=(1,1).

CHAPTER: PROGRAMMING NUMBER: 5.1.03.01

DATE: 11/06/85

SECTION: JOB CONTROL LANGUAGE REVISED: 11/21/91

SUBJECT: EXEC STATEMENT

THE EXEC STATEMENT IS THE FIRST STATEMENT OF EACH JOB STEP. ITS PRINCIPAL FUNCTION IS TO IDENTIFY THE PROGRAM TO BE EXECUTED OR THE CATALOGUED PROCEDURE TO BE CALLED. EVERY STEP NAME MUST BE UNIQUE IN A GIVEN JOB. THE FORMAT OF THE EXEC STATEMENT IS ILLUSTRATED BELOW:

STEPNAME THE STEPNAME MUST BE THE SAME AS THE PROGRAM IDENTIFICATION (REFER TO 2.3.02.01) ASSIGNED THE PROGRAM, OR BE A STANDARDS-ASSIGNED UTILITY STEPNAME FOR A UTILITY OR CATALOGUED PROCEDURE BEING EXECUTED. THE ONLY ALLOWABLE EXCEPTION TO THIS RULE WILL BE THOSE CASES WHERE ONE JOB EXECUTES THE SAME APPLICATION PROGRAM MORE THAN ONCE. IN THESE CASES, A DIFFERENT STEPNAME WILL BE ASSIGNED BY STANDARDS AND PROCEDURES ACCORDING TO THE APPLICATION AREA AND CONTAIN AN 'E', FOR 'EXECUTE ONLY', IN POSITION 7 OF THE STEPNAME.

PGM=PROGRAM NAME -THE PROGRAM NAME THAT IS TO BE EXECUTED.

PROC=PROCEDURE NAME

PROCEDURE NAME -THE NAME OF A CATALOGUED PROCEDURE OR AN IN-STREAM PROCEDURE THAT WILL BE CALLED AND EXECUTED. EITHER OF THE TWO FORMATS MAY BE USED.

THE PROC AND PGM PARAMETERS ARE MUTUALLY EXCLUSIVE. IF ONE IS CODED THE OTHER CANNOT BE CODED. IF THE PGM PARAMETER IS OMITTED THE SYSTEM WILL DEFAULT TO PROC.

FOR IMS PROGRAM STEPS, CODE THE EXEC CARD IN THE FOLLOWING FORMAT:

//STEPNAME EXEC IMSBPROD,MBR=PGMNAME,PSB=PSBNAME

//STEPNAME EXEC IMSBPROD,MBR=PGMNAME

 CHAPTER: PROGRAMMING NUMBER: 5.1.04.01

DATE: 11/06/85

SECTION: JOB CONTROL LANGUAGE REVISED: 07/13/88

SUBJECT: DATA DEFINITION STATEMENT

THE DD STATEMENT IS A DATA DEFINITION WITHIN A JOB STEP THAT SPECIFIES INPUT AND OUTPUT FACILITIES REQUIRED TO USE A DATA SET. THIS STATEMENT IS REQUIRED FOR EACH DATA SET USED IN A STEP. THE FORMAT FOR THE DD STATEMENT IS ILLUSTRATED BELOW:
 

//DDNAME

DD

OPERANDS

COMMENTS

THERE ARE NO PARAMETERS WHICH ARE REQUIRED IN ALL CASES. THERE ARE SEVERAL, HOWEVER, WHICH ARE USED VERY FREQUENTLY AND ARE TO BE CODED AS FOLLOWS:

DATA SET NAME (DSN) -THE DSN PARAMETER MUST BE CODED FOR ALL DISK OR TAPE DATA SETS OTHER THAN THOSE USED AS TEMPORARY WORKFILES WITHIN A SINGLE JOB STEP. THE DATA SET NAME MUST ADHERE TO THE NUMBERING STANDARDS SPECIFIED FOR FILE IDENTIFICATION IN SECTION 2.3.10.01.

ONLY SEVENTEEN CHARACTERS FROM THE DATA SET NAME WILL BE USED BY THE OPERATING SYSTEM FOR THE IDENTIFICATION OF A TAPE DATA SET (AS OPPOSED TO FORTY-FOUR CHARACTERS FOR DISK AND MASS STORAGE DATA SETS).

DISPOSITION (DISP) - WHEN CODING DISPOSITIONAL (DISP) PARAMETERS FOR DD STATEMENTS THE PROGRAMMER MUST ALWAYS CONSIDER THE EFFECT OF PREMATURE TERMINATION OF A JOB, AND WHENEVER POSSIBLE, PROVIDE SUFFICIENT FLEXIBILITY FOR RESTART OF THE JOB AT VARIOUS STEPS. FOR THIS REASON, BACKWARD REFERENCES TO DATA SETS OUTSIDE THIS PARTICULAR STEP MAY NOT BE USED. CONDITIONAL DISPOSITIONS ARE VERY IMPORTANT TO INSURE THE AVAILABILITY OF FILES FOR RESTART PURPOSES.

PRODUCTION JOBS MUST HAVE ALL THREE DISPOSITION PARAMETERS INCLUDED FOR TAPE, DISK, AND MASS STORAGE DATA SETS BEING CREATED.

FOR EXISTING DATA SETS, ALL THREE DISPOSITIONAL PARAMETERS MUST ALSO BE CODED, UNLESS SHR IS USED. SHR SHOULD BE USED IN ALL CASES EXCEPT WHEN THE DATA SET IS BEING MODIFIED, WHICH REQUIRES OLD AND TWO DISPOSITIONS. THE MOD DISPOSITION IS NOT ACCEPTABLE FOR PRODUCTION JOBS BECAUSE IT PREVENTS STEP-RESTARTING A JOB THAT ENDS ABNORMALLY.

ALL PERMANENT DATA SETS MUST BE CATALOGUED AS THEY ARE CREATED. FOR TAPES WITH MORE THAN ONE DATA SET, HOWEVER, ONLY THE FIRST DATA SET CREATED MUST BE CATALOGUED. ALL TEMPORARY DISK DATA SETS OR DATA SETS TO BE SUBSEQUENTLY USED AFTER COMPLETION OF THE STEP THAT CREATED THEM MUST BE CATALOGUED AS THEY ARE CREATED. ALL DISK DATA SETS AND TEMPORARY WORK DATA SETS MUST BE DELETED BY THE

CHAPTER: PROGRAMMING NUMBER: 5.1.04.02

DATE: 11/06/85

SECTION: JOB CONTROL LANGUAGE REVISED: 03/15/91

DELETE DISPOSITIONAL SUB-PARAMETER IN THE LAST JOB STEP USING THE DATA SET.

THE USE OF THE CONDITIONAL DISPOSITION IS VERY IMPORTANT IN CASE THE JOB ABENDS. USUALLY THE PROGRAMMER SHOULD INDICATE A CONDITIONAL DISPOSITION OF CATLG FOR ALL TAPE OR DISK INPUT FILES; WHEN CREATING TEMPORARY DISK DATA SETS, THE DISPOSITION PARAMETER MUST BE (NEW,CATLG,DELETE). THIS WILL ASSURE THE AVAILABILITY OF THOSE FILES FOR RESTART PURPOSES WITHOUT CHANGES IN JCL. FOR THIS SAME REASON, "PASSED" DATA SETS (WHERE THE "PASS" DISPOSITION IS CODED OR IMPLIED) WILL NOT BE ACCEPTED FOR PRODUCTION WORK.

UNIT - THE UNIT PARAMETER MUST BE SPECIFIED ON ALL NEW DATASETS BEING CREATED. THE UNIT PARAMETER MUST NOT BE SPECIFIED ON EXISTING DATASETS, EXCEPT FOR TAPES BEING READ WITH A LABEL PARAMETER ARGUMENT OF BLP OR NL, OR EXTERNAL TAPES. USE OF THE UNIT ADDRESS (UNIT=ADDRESS) IS NOT PERMITTED.
 

UNIT=SYSDA	MUST BE USED FOR SORT WORK DATA SETS ONLY.
UNIT=CTAPE	MUST BE USED FOR ALL CSD PRODUCTION TAPES
UNIT=T6250	MUST BE USED FOR ALL 9 TRACK TAPES
UNIT=3380	MUST BE USED ONLY FOR DATA SETS WHICH MUST EXPLICITLY RESIDE ON THE IBM 3380 DISK DRIVES
UNIT=HSMDA	MUST BE USED FOR SYSTEM STORAGE DATA SETS WITH NON-SPECIFIC ASSIGNMENTS FOR ALL USC-COLUMBIA PRODUCTION DATASETS.
UNIT=DASD	MUST BE USED FOR SYSTEM STORAGE DATA SETS WITH NON-SPECIFIC ASSIGNMENTS FOR ALL NON USC-COLUMBIA PRODUCTION DATASETS.

THE USE OF ANY UNIT DESIGNATION OTHER THAN THE ABOVE LISTED MUST HAVE PRIOR APPROVAL BY THE SYSTEMS SUPPORT GROUP. THIS APPROVAL MUST BE INDICATED ON THE SCHEDULING AND RETENTION FORM AT THE TIME OF PRODUCTION TURNOVER.

AS A GENERAL RULE, PRODUCTION DATA SETS THAT DO NOT REQUIRE SPECIFIC ASSIGNMENTS AND ARE NOT VSAM DATASETS, WILL BE PLACED DIRECTLY ON SYSTEM STORAGE (HSMDA).

TAPE SHOULD ONLY BE USED WHEN OFF-SITE ROTATION IS REQUIRED, WHEN THE TAPE IS CREATED FOR THE PLOTTER, WHEN TAPE WAS PRODUCED BY AN OFFLINE DEVICE (KEYDISK, IBM 3881 OPTICAL SCANNER, ETC.) OR WHEN THE DATA SET IS EXTREMELY LARGE. (SEE SPACE PARAMETER BELOW).

CHAPTER: PROGRAMMING NUMBER: 5.1.04.03

DATE: 11/06/85

SECTION: JOB CONTROL LANGUAGE REVISED: 12/17/92

SPACE - SPACE PARAMETERS MUST BE CODED IN THE NUMBER OF TRACKS TO BE ALLOCATED FOR ALL DISK DATA SETS. THE MAXIMUM SIZE DATA SET TO BE PLACED ON DISK STORAGE IS 2000 TRACKS INCLUDING THE PRIMARY SPACE REQUEST AND FIFTEEN TIMES THE SECONDARY SPACE REQUEST. THE USE OF ANY SPACE ALLOCATION GREATER THAN THE 2000 TRACK LIMIT OR THE USE OF THE CYL ARGUMENT OF THE SPACE PARAMETER MUST HAVE PRIOR APPROVAL BY THE SYSTEMS SUPPORT GROUP. THIS APPROVAL MUST BE INDICATED ON THE SCHEDULING AND RETENTION FORM AT THE TIME OF PRODUCTION TURNOVER.

DIRECTORY CONTROL BLOCK (DCB) FOR GENERATION DATA GROUP (GDG) DATA SETS, THE RESERVED WORD USCGDG MUST BE THE FIRST SUB-PARAMETER OF THE DCB. WITH THE ADDITION OF THE IDRC (IMPROVED DATA RECORDING CAPABILITY) FEATURE OF MVS, ALL CTAPE'S ARE WRITTEN IN COMPRESSED FORMAT WITHOUT ANY SPECIAL JCL CODING. THE OPTIONAL DCB PARAMETER TRTCH MAY BE USED TO CREATE TAPES THAT ARE NOT COMPRESSED ONLY IF THE TAPES ARE FOR OFF-SITE USE WHERE IDRC COMPRESSED TAPES CANNOT BE READ. IN THESE SPECIAL SITUATIONS CODE THE DCB AS FOLLOWS:

NOTE: FOR MULTI-FILE CTAPE'S, ALL FILES MUST BE EITHER COMPRESSED OR NOT COMPRESSED - THE MODES CANNOT BE MIXED BETWEEN FILES.

VOLUME (VOL) - NON-SPECIFIC ALLOCATION OF DISK SPACE IS REQUIRED FOR ALL DISK DATA SETS UNLESS OTHERWISE INSTRUCTED. DO NOT USE THE VOL=SER= (SERIAL NUMBER) PARAMETER IN THESE INSTANCES.

THE VOLUME PARAMETER SHOULD NOT BE USED FOR TAPE DATA SETS EXCEPT FOR THOSE JOBS WHICH REQUIRE OTHER THAN THE CURRENT CATALOGUED DATA SET. IN THOSE INSTANCES WHERE IT IS REQUIRED THE VOLUME PARAMETER MUST BE ON A SEPARATE CARD FROM THE OTHER DD PARAMETERS AND MUST BE THE LAST CARD FOR THE DATA SET.

SYSOUT - THE SYSOUT PARAMETER MUST BE CODED FOR ALL PRINTED OR PUNCHED DATA SETS IN THE FOLLOWING FORMAT.

SYSOUT=(CLASS,,FORM OR CARD NUMBER)
CLASS WILL SPECIFY THE UNIT TO BE USED WHERE:
A=PRINTER
B=PUNCH

 CHAPTER: PROGRAMMING NUMBER: 5.1.04.04

DATE: 11/06/85

SECTION: JOB CONTROL LANGUAGE REVISED: 11/21/91

THE SYSOUT PARAMETER FOR SYSUDUMP OUTPUT IS TO BE CODED WITH A SPECIAL CLASS OF 'G' AND A SPECIAL OUTPUT DESTINATION PARAMETER OF 'DUMP'. THE REQUIRED SYSUDUMP CODING FORMAT FOR PRODUCTION JOBS IS:

//SYSUDUMP DD SYSOUT=G,DEST=DUMP

OUTPUT - USE THE OUTPUT PARAMETER WITH THE SYSOUT PARAMETER TO ASSOCIATE A SYSOUT DATA SET WITH AN OUTPUT JCL STATEMENT. JES PROCESSES THE SYSOUT DATA SET USING THE OPTIONS FROM THIS DD STATEMENT COMBINED WITH THE OPTIONS FROM THE REFERENCED OUTPUT JCL STATEMENT.

WHEN THE OUTPUT PARAMETER REFERENCES MORE THAN ONE OUTPUT JCL STATEMENT, THE SYSTEM PRODUCES SEPARATE OUTPUT FOR EACH OUTPUT JCL STATEMENT.

SYNTAX:
    OUTPUT=REFERENCE
        (REFERENCE,REFERENCE...)
A REFERENCE IS ONE OF THE FOLLOWING:
1) *.NAME - REFERS TO AN EARLIER OUTPUT JCL STATEMENT WITH NAME IN ITS NAME FIELD. THE SYSTEM SEARCHES FOR THE OUTPUT JCL STATEMENT FIRST IN THE SAME STEP, THEN BEFORE THE FIRST EXEC STATEMENT OF THE JOB.

2) *.STEPNAME.NAME - REFERS TO AN EARLIER OUTPUT JCL STATEMENT, NAME, IN THIS STEP OR AN EARLIER STEP, STEPNAME, IN THE SAME JOB.

3) *.STEPNAME.PROCNAME.NAME - REFERS TO AN OUTPUT JCL STATEMENT IN A CATALOGUED OR INSTREAM PROCEDURE. STEPNAME IS THE NAME OF THIS JOB STEP OF AN EARLIER JOB STEP THAT CALLS THE PROCEDURE, PROCNAME IS THE NAME OF THE PROCEDURE STEP THAT CONTAINS THE OUTPUT JCL STATEMENT, AND NAME IS THE NAME FIELD OF THE OUTPUT JCL STATEMENT.

CHAPTER: PROGRAMMING NUMBER: 5.1.04.05

DATE: 11/06/85

SECTION: JOB CONTROL LANGUAGE REVISED: 07/13/88

IF THE OUTPUT PARAMETER IS NOT CODED ON A SYSOUT DD STATEMENT, JES OBTAINS THE PROCESSING OPTIONS FOR THE SYSOUT DATA SET IN THE FOLLOWING ORDER:

1) FROM EACH OUTPUT JCL STATEMENT CONTAINING DEFAULT=YES IN THE STEP.
2) FROM EACH OUTPUT JCL STATEMENT CONTAINING DEFAULT=YES BEFORE THE FIRST EXEC STATEMENT IN THE JOB, PROVIDED THAT THE STEP CONTAINS NO OUTPUT JCL STATEMENTS WITH DEFAULT=YES.
3) ONLY FROM THE SYSOUT DD STATEMENT, PROVIDED THAT NEITHER THE JOB NOR THE STEP CONTAINS ANY OUTPUT JCL STATEMENTS WITH DEFAULT=YES.

CHAPTER: PROGRAMMING NUMBER: 5.1.05.01

DATE: 04/13/87

SECTION: JOB CONTROL LANGUAGE REVISED:

SUBJECT: OUTPUT JCL STATEMENT.

USE THE OUTPUT JCL STATEMTENT TO SPECIFY PROCESSING OPTIONS FOR A SYSTEM OUTPUT (SYSOUT) DATA SET. THESE PROCESSING OPTIONS ARE USED ONLY WHEN THE OUTPUT JCL STATEMENT IS REFERENCED, EXPLICITLY OR IMPLICITLY, BY A SYSOUT DD STATEMENT. JES COMBINES THE OPTIONS FROM THIS OUTPUT JCL STATEMENT WITH THE OPTIONS FROMT THE REFERENCING DD STATEMENT.

OUTPUT JCL STATEMENTS ARE USEFUL IN PROCESSING THE OUTPUT OF ONE SYSOUT DATA SET IN SEVERAL WAYS. FOR EXAMPLE, THE OUTPUT FROM ONE SYSOUT DATA SET MAY BE SENT TO SEVERAL DESTINATIONS WHILE ALSO VARYING THE NUMBER OF COPIES AT EACH DESTINATION.

THE OUTPUT JCL STATEMENT CONSISTS OF THE CHARACTERS '//' IN COLUMNS 1 AND 2 AND FOUR FIELDS: NAME, OPERATION, PARAMETER(S), AND COMMENTS.

SYNTAX:
    //NAME OUTPUT PARAMETER1,PARAMETER2... COMMENTS

NAME FIELD: A NAME MUST BE CODED IN EACH NAME FIELD OF EVERY OUTPUT JCL STATEMENT. EACH OUTPUT JCL STATEMENT MUST BE UNIQUE WITHIN A JOB. IT MUST BEGIN IN COLUMN 3. IT IS COMPOSED OF 1-8 ALPHANUMERIC OR NATIONAL CHARACTERS WITH THE FIRST CHARACTER BEING ALPHABETIC OR NATIONAL. THE NAME FIELD MUST BE FOLLOWED BY AT LEAST 1 BLANK.

OPERATION FIELD: THE OPERATION FIELD CONSISTS OF THE CHARACTERS OUTPUT AND MUST BE PRECEDED AND FOLLOWED BY AT LEAST 1 BLANK. IT CAN BEGIN IN ANY COLUMN.

PARAMETER FIELD: THE OUTPUT JCL STATEMENT CONTAINS ONLY KEYWORD PARAMETERS. THE PARAMETERS MAY BE CODED IN ANY ORDER IN THE PARAMETER FIELD. WHEN MORE THAN ONE PARAMETER IS CODED, SEPERATE PARAMETERS WITH A COMMA AS SHOWN IN THE ABOVE FORMAT. THE FOLLOWING PARAMETERS ARE SOME OF THE MOST FREQUENTLY USED:

COPIES - USE THE COPIES PARAMETER TO SPECIFY HOW MANY COPIES OF THE SYSOUT DATA SET ARE TO BE PRINTED.

SYNTAX:
    COPIES=NNN
    WHERE NNN IS 1-3 DECIMAL NUMBERS IN THE RANGE OF 1-255.

CHAPTER: PROGRAMMING NUMBER: 5.1.05.02

DATE: 04/13/87

SECTION: JOB CONTROL LANGUAGE REVISED:

DEFAULT - USE THE DEFAULT PARAMETER TO SPECIFY THAT THIS OUTPUT JCL STATEMENT CAN OR CANNOT BE IMPLICITLY REFERENCED BY A SYSOUT DD STATEMENT. AN OUTPUT JCL STATEMENT THAT CONTAINS THE DEFAULT=YES PARAMETER IS CALLED A DEFAULT OUTPUT JCL STATEMENT.

SYNTAX:
    DEFAULT=YES OR Y
                     NO OR N

NO INDICATES THAT THIS OUTPUT JCL STATEMENT CANNOT BE IMPLICITLY REFERENCED BY SYSOUT DD STATEMENTS.

AN IMPLICIT REFERENCE IS WHEN A JCL STREAM CONTAINS AN OUTPUT JCL STATEMENT WITH A DEFAULT=YES PARAMETER AND A SYSOUT DD STATEMENT THAT DOES NOT CONTAIN AN OUTPUT PARAMETER. AN EXPLICIT REFERENCE IS WHEN THE SYSOUT DD STATEMENT HAS AN OUTPUT PARAMETER THAT SPECIFIES THE NAME OF AN OUTPUT JCL STATEMENT.

DEST - USE THE DEST PARAMETER TO SPECIFY A DESTINATION FOR THE SYSOUT DATA SET. THE DEST PARAMETER CAN SEND A SYSOUT DATA SET TO A REMOTE OR LOGICAL TERMINAL, A NODE, A NODE AND REMOTE WORK STATION, A LOCAL DEVICE OR GROUP OF DEVICES, OR A NODE AND USERID.

SYNTAX:
    DEST=DESTINATION
    WHERE DESTINATION CAN BE ONE OF THE FOLLOWING:

1) LOCAL - ANY LOCAL DEVICE

2) NAME - IDENTIFIES A LOCAL OR REMOTE DEVICE BY A SYMBOLIC NAME. 1-8 ALPHANUMERIC OR NATIONAL CHARACTERS.

3) NNNNN - IDENTIFIES A NODE. NNNN IS 1-4 DECIMAL NUMBERS IN A RANGE OF 1-1000.

4) NNNRMMMM
    NNNNRMMM
    NNNNNRMM
IDENTIFIES A NODE AND REMOTE WORK STATION CONNECTED TO THE NODE. THE NODE NUMBER (N) IS 1-4 DECIMAL NUMBERS FROM 1-1000. THE REMOTE WORK STATION NUMBER (M) IS 1-4 DECIMAL NUMBERS FROM 1-4000. DO NOT CODE LEADING 0 IN (N) OR (M). THE MAXIMUM NUMBER OF DIGITS FOR (N) AND (M) IS 6.

CHAPTER: PROGRAMMING NUMBER: 5.1.05.03

DATE: 04/13/87

SECTION: JOB CONTROL LANGUAGE REVISED:

5) NODENAME.USERID - IDENTIFIES A DESTINATION NODE AND A TSO OR VM USER ID AT THAT NODE. USE THIS PARAMETER TO ROUTE A SYSOUT DATA SET BETWEEN JES2 NODES AND NON-JES2 NODES. THE NODENAME IS A SYMBOLIC 1-8 ALPHANUMERIC OR NATIONAL CHARACTERS. THE USERID MUST BE DEFINED AT THE NODE; USERID FOR TSO IS 1-7 ALPHANUMERIC OR NATIONAL CHARACTERS AND FOR VM IS 1-8 ALPHANUMERIC OR NATIONAL CHARACTERS.

6) RNNNN
    RMNNNN
    RMTNNNN
                    IDENTIFIES A REMOTE TERMINAL. NNNN IS 1-4 DECIMAL NUMBERS FROM
                    1TO 4000.
7) UNNN
                     IDENTIFIES A LOCAL TERMINAL WITH SPECIAL ROUTING.
                     NNN IS 1-3 DECIMAL NUMBERS FROM 1-255.                     

IF THE DEST PARAMETER IS NOT CODED, JES DIRECTS THE SYSOUT DATA SETS TO THE DEFAULT DESTINATION FOR THE INPUT DEVICE FROM WHICH THE JOB WAS SUBMITTED. A DEST PARAMETER CODED ON THE SYSOUT DD STATEMENT OVERRIDES THE OUTPUT JCL DEST PARAMETER.

FCB USE THE FCB PARAMETER TO SPECIFY:
1) THE FORMS CONTROL BUFFER (FCB) IMAGE JES IS TO USE TO GUIDE PRINTING OF THE SYSOUT DATA SET BY A 3211 PRINTER, 3203 PRINTER MODEL 5, 3800 PRINTING SUBSYSTEM, OR 4249 PRINTER, OR BY A PRINTER SUPPORTED BY SYSTEM NETWORK ARCHITECTURE (SNA) REMOTE JOB ENTRY (RJE).

2) THE CARRIAGE CONTROL TAPE JES IS TO USE TO CONTROL PRINTING OF THE SYSOUT DATA SET BY A 1403 PRINTER OR A PRINTER SUPPORTED BY SNA RJE.

3) THE DATA PROTECTION IMAGE JES IS TO USE TO CONTROL OUTPUT BY A 3525 CARD PUNCH.

THE FCB IMAGE SPECIFIES HOW MANY LINES ARE TO BE PRINTED PER INCH AND THE LENGTH OF THE FORM. JES LOADS THE IMAGE INTO THE PRINTER'S FORMS CONTROL BUFFER.

SYNTAX:
        FCB=FCB-NAME
                STD
WHERE FCB-NAME IDENTIFIES THE FCB IMAGE. THE NAME IS 1-4 ALPHANUMERIC OF NATIONAL CHARACTERS AND IS THE LAST 4 CHARACTERS OF A SYS1.IMAGELIB MEMBER NAME:

1) FCB2XXXX MEMBER, FOR A 3211, A 3203 MODEL 5, OR A PRINTER SUPPORTED BY SNA.

CHAPTER: PROGRAMMING NUMBER: 5.1.05.04

DATE: 04/13/87

SECTION: JOB CONTROL LANGUAGE REVISED:

2) FCB3XXXX MEMBER, FOR A 3800.
3) FCB4XXXX MEMBER, FOR A 4248.

IF THE FCB PARAMETER IS NOT CODED, THE SYSTEM CHECKS THE FCB IMAGE IN THE PRINTER'S FORMS CONTROL BUFFER; IF IT IS A DEFAULT IMAGE, JES USES IT. IF IT IS NOT A DEFAULT IMAGE, JES LOADS THE FCB IMAGE THAT IS THE INSTALLATION DEFAULT SPECIFIED AT JES INITIALIZATION. AN FCB PARAMETER ON THE SYSOUT DD STATEMENT OVERRIDES THE OUTPUT JCL FCB PARAMETER.

 FORMS - USE THE FORMS PARAMETER TO IDENTIFY THE FORMS ON WHICH THE SYSOUT DATA SET IS TO PRINTED OR PUNCHED.

SYNTAX:
        FORMS=FORM-NAME
                        STD
WHERE FORM-NAME IDENTIFIES THE PRINT OR PUNCH FORM. FORM-NAME IS 1-8 ALPHANUMERIC OR NATIONAL CHARACTERS. REFER IN THE STANDARDS MANUAL TO 6.3.02.01, 6.3.03.01, AND 6.3.04.01 FOR STANDARD AND SPECIAL FORMS AND CARDS. STD INDICATES THAT JES3 IS TO USE THE STANDARD FORM SPECIFIED AT JES3 INITIALIZATION. STD IS SUPPORTED ONLY ON JES3 SYSTEMS.

IF THE FORMS PARAMETER IS OMITTED, JES USES THE INSTALLATION DEFAULT DEFINED AT INITIALIZATION. THE FORM-NAME SUBPARAMETER OF THE SYSOUT PARAMETER ON THE SYSOUT DD STATEMENT OVERRIDES THE OUTPUT JCL FORMS PARAMETER. NOTE THAT THE SYSOUT FORM-NAME SUBPARAMETER CAN BE ONLY 4 CHARACTERS MAXIMUM, WHILE THE OUTPUT JCL FORMS FORM-NAME AND THE JES INITIALIZATION DEFAULT FORM-NAME CAN BE 8 CHARACTERS MAXIMUM.

JESDS - USE THE JESDS PARAMETER TO PROCESS THE JOB'S SYSTEM-MANAGED DATA SETS ACCORDING TO THE PARAMETERS ON THE OUTPUT JCL STATEMENT. THE SYSTEM-MANAGED DATA SETS CONSIST OF:

1) THE JOB LOG, WHICH IS A RECORD OF THE JOB-RELATED INFORMATION FOR THE PROGRAMMER. PRINTING OF THE JOB LOG IS CONTROLLED BY TWO JOB STATEMENT PARAMETERS: THE MSGLEVEL PARAMETER CONTROLS WHAT IS PRINTED AND THE MSGCLASS PARAMETER CONTROLS THE SYSTEM OUTPUT CLASS.

2) THE JOB'S HARD-COPY LOG, WHICH IS A RECORD OF ALL MESSAGE TRAFFIC FOR THE JOB TO AND FROM THE OPERATOR CONSOLE.

3) SYSTEM MESSAGES FOR THE JOB.

DATE: 04/13/87

SECTION: JOB CONTROL LANGUAGE REVISED:

THE CLASS FOR THE SYSTEM-MANAGED DATA SETS IS, IN OVERRIDE ORDER, (1) THE CLASS SPECIFIED IN THE JOB STATEMENT MSGCLASS PARAMETER OR (2) THE CLASS IN THE CLASS PARAMETER ON THE OUTPUT JCL STATEMENT CONTAINING JESDS.

 SYNTAX:
        JESDS=ALL
                     JCL
                     LOG
                     MSG
WHERE ALL INDICATES ALL OF THE JOB'S SYSTEM-MANAGED DATA SETS.

JCL INDICATES ALL JOB CONTROL STATEMENTS IN THE INPUT STREAM, THAT IS, ALL JCL STATEMENTS AND JES2 OR JES3 STATEMENTS PLUS ALL PROCEDURE STATEMENTS FROM ANY INSTREAM OR CATALOGUED PROCEDURES A JOB STEP CALLS, PLUS ALL MESSAGES ABOUT JOB CONTROL STATEMENTS.

LOG INDICATES THE JOB'S HARD-COPY LOG, WHICH CONTAINS THE JES AND OPERATOR MESSAGES ABOUT THE JOB'S PROCESSING: ALLOCATION OF DEVICES AND VOLUMES, EXECUTION, AND TERMINATION OF JOB STEPS AND THE JOB, AND DISPOSITION OF DATA SETS.

MSG INDICATES ANY SYSTEM MESSAGES FOR THIS JOB.

COMMENTS FIELD - THE COMMENTS FIELD FOLLOWS THE PARAMETER FIELD AFTER AT EAST ONE INTERVENING BLANK.

LOCATION IN THE JCL - THE OUTPUT JCL STATEMENT MUST BE PLACED IN THE INPUT STREAM BEFORE ANY SYSOUT DD STATEMENT THAT REFERS TO IT.

AT COMPUTER SERVICES DIVISION, ALL PRODUCTION JOBS ARE SET UP WITH TWO OUTPUT JCL STATEMENTS ALREADY THERE. THEY ARE AS FOLLOWS:

THE FIRST OUTPUT JCL STATEMENT WILL CAUSE ALL SYSTEM-MANAGED SYSOUT DATA SETS AS WELL AS ALL OTHER SYSOUT DATA SETS TO PRINT AT THE DEFAULT DESTINATION FOR THIS JOB. THE SECOND OUTPUT JCL STATEMENT WILL CAUSE ALL SYSTEM-MANAGED SYSOUT DATA SETS TO BE ROUTED TO PRODJCL (THE PRODUCTION JCL ARCHIVAL SYSTEM), WHICH WILL STORE THE JCL AND SYSTEM-MANAGED DATA SETS ON MICROFICHE. DEST=PRODJCL MAY ONLY BE USED IN PRODUCTION JOBS. SYSOUT DATA SETS LARGER THAN 5 PAGES SHOULD NOT REFERENCE PRODJCL.

CHAPTER: PROGRAMMING NUMBER: 5.1.05.06

DATE: 04/13/87

SECTION: JOB CONTROL LANGUAGE REVISED:

IF THERE ARE OTHER SYSOUT DATA SETS THAT SHOULD REFERENCE DIFFERENT OUTPUT JCL STATEMENTS, THE OTHER OUTPUT JCL STATEMENTS SHOULD BE INCLUDED IN THE JCL STREAM WHEN IT IS TURNED OVER TO PRODUCTION STATUS.