JEC Language Reference Manual

This is part of the Heirloom Computing Elastic Batch Platform forum on paas.heirloomcomputing.com. 

IBM z/OS JES2 V2R2 Job Execution Control language is used to define Job Groups which describe the interrelationships of jobs for scheduling purposes.  For example the following JEC job deck describes the job group MYGROUP:

//*  DEPENDENCY NETWORK:
//*
//*                JOBC
//*                  |
//*             JOBE===JOBA
//*                  |
//*                JOBX
//*
//*
//*-----------------------------
//MYGROUP  JOBGROUP
//*
//JOBA     GJOB
//*
//JOBE     GJOB
//         CONCURRENT NAME=JOBA
//*
//JOBC     GJOB
//         BEFORE NAME=JOBA
//*
//JOBX     GJOB
//         AFTER  NAME=JOBA
//*
//MYGROUP  ENDGROUP

Then the following sequence of JCL jobs with the SCHEDULE statement refer to it. Note this example will fail if the jobs are not run under control of the Job Group because dependent datasets may not exist.

//* :....1....:....2....:....3....:....4....:....5....:....6....:....7.
//* Sequence of jobs running under control of JOBGROUP=MYGROUP

//JOBX     JOB  (22,DEPT22,22IKJ22),'job group',CLASS=B,MSGCLASS=A,
//              MSGLEVEL=(2,2),NOTIFY=USERID
//         SCHEDULE JOBGROUP=MYGROUP
//CREATEA EXEC PGM=IEFBR14,
//              PARM='SYSOUT=CREATED+BY+JOBX'
//SYSOUT   DD   DISP=(NEW,CATLG),DSN=JOBX.DAT
//DEPEND1  DD   DISP=(SHR,KEEP),DSN=JOBA.DAT
//DEPEND2  DD   DISP=(SHR,KEEP),DSN=JOBC.DAT
//DEPEND3  DD   DISP=(SHR,KEEP),DSN=JOBE.DAT

//JOBA     JOB  (22,DEPT22,22IKJ22),'job group',CLASS=B,MSGCLASS=A,
//              MSGLEVEL=(2,2),NOTIFY=USERID
//         SCHEDULE JOBGROUP=MYGROUP
//CREATEA EXEC PGM=IEFBR14,
//              PARM='SLEEP=30 SYSOUT=CREATED+BY+JOBA'
//SYSOUT   DD   DISP=(NEW,CATLG),DSN=JOBA.DAT
//DEPEND1  DD   DISP=(SHR,KEEP),DSN=JOBC.DAT

//JOBC     JOB  (22,DEPT22,22IKJ22),'job group',CLASS=B,MSGCLASS=A,
//              MSGLEVEL=(2,2),NOTIFY=USERID
//         SCHEDULE JOBGROUP=MYGROUP
//CREATEA EXEC PGM=IEFBR14,
//              PARM='SYSOUT=CREATED+BY+JOBC'
//SYSOUT   DD   DISP=(NEW,CATLG),DSN=JOBC.DAT

 

//JOBE     JOB  (22,DEPT22,22IKJ22),'job group',CLASS=B,MSGCLASS=A,
//              MSGLEVEL=(2,2),NOTIFY=USERID
//         SCHEDULE JOBGROUP=MYGROUP
//CREATEA EXEC PGM=IEFBR14,
//              PARM='SLEEP=30 SYSOUT=CREATED+BY+JOBE'
//SYSOUT   DD   DISP=(NEW,CATLG),DSN=JOBE.DAT
//DEPEND1  DD   DISP=(SHR,KEEP),DSN=JOBC.DAT

All jobs referenced in the group must be submittied and ready to run for any part of the job group to start.  If duplicates of jobs are submitted, one is chosen to be part of the group at the time the group becomes active.  When the entire group of jobs finish, then the group will become active again when a new set of jobs are submitted.

Job Groups are defined by submitting decks to EBP where a job class of type JEC has been defined at at least one initiator is available to process the definition.  Definitions persist EBP shutdown / start-up.  Groups can be displayed as an XML representation of the JEC dec with the LIST service.  To delete a group, submit a JEC job deck which contains only a JOBGROUP and ENDGROUP of the same name (empty job group).

The implementation of the IBM z/OS JES2 Job Execution Control syntax accepted EBP is described below in extended Bachus-Naur form and syntax "railroad" diagrams.

Rules

1. job
2. jobgroup
3. groupcards
4. jobsets
5. setcards
6. gjob
7. modifiers
8. commentcard
9. jobgroupcard
10. jobgroupname
11. jgpositional
12. accounting
13. programmer
14. jgkeyword
15. endgroupcard
16. jobsetcard
17. jobsetid
18. jskeyword
19. endsetcard
20. sjobcard
21. gjobcard
22. gjobcardid
23. gjkeyword
24. aftercard
25. after
26. beforecard
27. before
28. backeyword
29. morenames
30. action
31. concurrentcard
32. concurrent
33. cckeyword
34. comment
35. ifcontin
36. ifexpr
37. andorexpr
38. reloper
39. relexpr
40. booloper
41. anyexpr
42. quotedstring
43. anything
44. idres
45. idnonexprres
46. idresint
47. idresvar
48. idresintvar
49. intvar
50. intidres
51. idintvar
52. ID
53. variable
54. comma
55. reserved
56. nonexprreserved
57. exprreserved
58. INT
59. HEX
60. NEWLINE
61. WS
62. SPECIAL
63. INTL

Rules

• job Top

  A JES2 Execution Control deck includes JEC statements only https://www-01.ibm.com/support/knowledgecenter/SSLTBW_2.2.0/com.ibm.zos.v2r2.ieab600/jes2zone.htm

  Text notation:

  job : commentcard* jobgroup EOF ;

  Visual notation:

  

• jobgroup Top

   

  Text notation:

  jobgroup : jobgroupcard groupcards* endgroupcard? ;

  Visual notation:

  

• groupcards Top

   

  Text notation:

  groupcards : commentcard | gjob | jobsets ;

  Visual notation:

  

• jobsets Top

   

  Text notation:

  jobsets : jobsetcard setcards endsetcard ;

  Visual notation:

  

• setcards Top

   

  Text notation:

  setcards : commentcard | sjobcard ;

  Visual notation:

  

• gjob Top

   

  Text notation:

  gjob : gjobcard modifiers* ;

  Visual notation:

  

• modifiers Top

   

  Text notation:

  modifiers : aftercard | beforecard | concurrentcard ;

  Visual notation:

  

• commentcard Top

  Comment cards contain arbitrary comments (Note: starting in column 5).

  Text notation:

  commentcard : '//*' ~( NEWLINE )* NEWLINE ;

  Visual notation:

  

• jobgroupcard Top

  Job Group Card defines the begging of a Job Group

  Text notation:

  jobgroupcard : '//' jobgroupname WS JOBGROUP jgpositional ( comma jgkeyword )* comment NEWLINE ;

  Visual notation:

  

• jobgroupname Top

   

  Text notation:

  jobgroupname : idres ;

  Visual notation:

  

• jgpositional Top

   

  Text notation:

  jgpositional : WS accounting | WS accounting comma programmer | ;

  Visual notation:

  

• accounting Top

   

  Text notation:

  accounting : idresint | quotedstring ;

  Visual notation:

  

• programmer Top

   

  Text notation:

  programmer : idresint | quotedstring ;

  Visual notation:

  

• jgkeyword Top

   

  Text notation:

  jgkeyword : GROUP '=' idres | PASSWORD '=' idres | SECLABEL '=' idres | TYPE '=' SCAN | HOLD '=' ( NO | YES ) | ERROR '=(' ifexpr ifcontin ')' | ONERROR '=' ( STOP | SUSPEND | FLUSH ) | SYSAFF '=' idres | SYSTEM '=' idres | SCHENV '=' idres ;

  Visual notation:

  

• endgroupcard Top

  End Job Group Card defines the end of a Job Group

  Text notation:

  endgroupcard : '//' idres WS ENDGROUP comment NEWLINE ;

  Visual notation:

  

• jobsetcard Top

  Job Set Card defines a set of jobs within a Job Group

  Text notation:

  jobsetcard : '//' jobsetid WS JOBSET ( WS jskeyword )? comment NEWLINE ;

  Visual notation:

  

• jobsetid Top

   

  Text notation:

  jobsetid : idres ;

  Visual notation:

  

• jskeyword Top

   

  Text notation:

  jskeyword : FLUSHTYP '=' ALLFLUSH | FLUSHTYP '=' ANYFLUSH ;

  Visual notation:

  

• endsetcard Top

  End Job Set Card defines a ending of a set of jobs within a Job Group

  Text notation:

  endsetcard : '//' idres WS ENDSET comment NEWLINE ;

  Visual notation:

  

• sjobcard Top

  Set Job Card specifies a job name within a Job Set

  Text notation:

  sjobcard : '//' idres WS SJOB comment NEWLINE ;

  Visual notation:

  

• gjobcard Top

  Global Job Card specifies a global job name within a Job Group

  Text notation:

  gjobcard : '//' gjobcardid WS GJOB ( WS gjkeyword )? comment NEWLINE ;

  Visual notation:

  

• gjobcardid Top

   

  Text notation:

  gjobcardid : idres ;

  Visual notation:

  

• gjkeyword Top

   

  Text notation:

  gjkeyword : FLUSHTYP '=' ALLFLUSH | FLUSHTYP '=' ANYFLUSH ;

  Visual notation:

  

• aftercard Top

  After Card modifies GJOB and JOBSET cards indicating which jobs they come bafter

  Text notation:

  aftercard : '//' WS after WS backeyword ( comma backeyword )* comment NEWLINE ;

  Visual notation:

  

• after Top

   

  Text notation:

  after : AFTER ;

  Visual notation:

  

• beforecard Top

  Before Card modifies a GJOB and JOBSET cards indicating which jobs they come before

  Text notation:

  beforecard : '//' WS before WS backeyword ( comma backeyword )* comment NEWLINE ;

  Visual notation:

  

• before Top

   

  Text notation:

  before : BEFORE ;

  Visual notation:

  

• backeyword Top

   

  Text notation:

  backeyword : NAME '=' idres | NAME '=(' idres morenames* ')' | WHEN '=(' ifexpr ifcontin ')' | ACTION '=' action | OTHERWISE '=' action ;

  Visual notation:

  

• morenames Top

   

  Text notation:

  morenames : comma idres ;

  Visual notation:

  

• action Top

   

  Text notation:

  action : SATISFY | FLUSH | FAIL ;

  Visual notation:

  

• concurrentcard Top

  Concurrent Card modifies a GJOB card indicating which jobs it runs concurrent with

  Text notation:

  concurrentcard : '//' WS concurrent WS cckeyword comment NEWLINE ;

  Visual notation:

  

• concurrent Top

   

  Text notation:

  concurrent : CONCURRENT ;

  Visual notation:

  

• cckeyword Top

   

  Text notation:

  cckeyword : NAME '=' idres ;

  Visual notation:

  

• comment Top

  Most cards may contain comments after white-space (WS) and contain anything other than a new-line (NEWLINE) character up until column 72. A non-blank character in column 72 continues the comment onto the next card

  Text notation:

  comment : WS ~( NEWLINE )* | ;

  Visual notation:

  

• ifcontin Top

   

  Text notation:

  ifcontin : ( WS* NEWLINE '//' )* WS ;

  Visual notation:

  

• ifexpr Top

   

  Text notation:

  ifexpr : ( NOT | '!' ) ifcontin andorexpr | andorexpr ;

  Visual notation:

  

• andorexpr Top

   

  Text notation:

  andorexpr : re1=relexpr ( booloper re2=relexpr )* ;

  Visual notation:

  

• reloper Top

   

  Text notation:

  reloper : ( EQ | '=' | '==' ) | ( NE | '!=' | '<>' | '~=' ) | ( GT | '>' ) | ( GE | '>=' ) | ( LT | '<' ) | ( LE | '<=' ) ;

  Visual notation:

  

• relexpr Top

   

  Text notation:

  relexpr : left=anyexpr ifcontin* reloper ifcontin* right=anyexpr | '(' ifcontin* ifexpr ifcontin* ')' | TRUE | FALSE | ABEND | sn1=idnonexprres '.' ABEND ;

  Visual notation:

  

• booloper Top

   

  Text notation:

  booloper : WS ( AND | '&' | '&&' ) ifcontin | WS ( OR | '|' | '||' ) ifcontin ;

  Visual notation:

  

• anyexpr Top

   

  Text notation:

  anyexpr : sn1=idnonexprres | TRUE | FALSE | RC | ABEND | INT | variable | quotedstring ;

  Visual notation:

  

• quotedstring Top

  Use a quoted string for parameters, datasets, symbolic parameters. Double enclosed apostrophes.

  Text notation:

  quotedstring : ( '\'' anything '\'' )* '\'' anything '\'' ;

  Visual notation:

  

• anything Top

   

  Text notation:

  anything : ~( NEWLINE | '\'' )* ;

  Visual notation:

  

• idres Top

  identifier or reserved word

  Text notation:

  idres : ID | reserved ;

  Visual notation:

  

• idnonexprres Top

   

  Text notation:

  idnonexprres : ID | nonexprreserved ;

  Visual notation:

  

• idresint Top

  identifier, reserved word or int

  Text notation:

  idresint : idres | INT ;

  Visual notation:

  

• idresvar Top

  identifier, reserved word or variable

  Text notation:

  idresvar : idres | variable ;

  Visual notation:

  

• idresintvar Top

  identifier, reserved word, integer or variable

  Text notation:

  idresintvar : idresint | variable ;

  Visual notation:

  

• intvar Top

  integer or variable

  Text notation:

  intvar : INT | variable ;

  Visual notation:

  

• intidres Top

  integer possibly followed by an ID or reserved word

  Text notation:

  intidres : INT ( idres ) ? ;

  Visual notation:

  

• idintvar Top

  identifier, integer or variable

  Text notation:

  idintvar : intvar | ID ;

  Visual notation:

  

• ID Top

  Heirloom Computing EBP Identifiers consist of $, #, @ and A through Z followed by up to 7 of the same. Symbolic Parameters start with &, IDs with embedded & indicate a concatenation of two symbolic parameters.

  Text notation:

  ID : ('a'..'z'|'A'..'Z'|'$'|'#'|'@') ('a'..'z'|'A'..'Z'|'0'..'9'|'$'|'#'|'@'|'-'|'_')* ;

  Visual notation:

  

• variable Top

   

  Text notation:

  variable : ( '&' idres ( ( '.' )? | ( '.' idresint )? ) )+ ;

  Visual notation:

  

• comma Top

  keyword parameter values that contain comma-separated lists may span lines

  Text notation:

  comma : ',' | ',' comment NEWLINE '//'? WS ;

  Visual notation:

  

• reserved Top

   

  Text notation:

  reserved : exprreserved | nonexprreserved ;

  Visual notation:

  

• nonexprreserved Top

   

  Text notation:

  nonexprreserved : ACTION | AFTER | ALLFLUSH | ANYFLUSH | BEFORE | CONCURRENT | ENDGROUP | ENDSET | ERROR | FAIL | FLUSH | FLUSHTYP | GJOB | GROUP | HOLD | JOBGROUP | JOBSET | NAME | NO | ONERROR | OTHERWISE | PASSWORD | SATISFY | SCAN | SCHENV | SJOB | STOP | SUSPEND | SYSAFF | SYSTEM | SECLABEL | TYPE | WHEN | YES ;

  Visual notation:

  

• exprreserved Top

   

  Text notation:

  exprreserved : ABEND | ABENDCC | AND | EQ | FALSE | NE | NOT | OR | RC | TRUE ;

  Visual notation:

  

• INT Top

   

  Text notation:

  INT : ('0'..'9')+ ;

  Visual notation:

  

• HEX Top

   

  Text notation:

  HEX : ('0'..'9' | 'a'..'f' | 'A'..'F')+ ;

  Visual notation:

  

• NEWLINE Top

   

  Text notation:

  NEWLINE : '\r'? '\n' ;

  Visual notation:

  

• WS Top

   

  Text notation:

  WS : (' '|'\t')+ ;

  Visual notation:

  

• SPECIAL Top

  SPECIAL token not used but required to define all other chars

  Text notation:

  SPECIAL : ( '~' | '`' | '!' | '@' | '#' | '$' | '%' | '^' | '&' | '*' | '(' | ')' | '-' | '_' | '+' | '\'' | '"' | '=' | '{' | '}' | '[' | ']' | '|' | ':' | ';' | ',' | '.' | '<' | '>' | '?' | '/' | '\\' | INTL ) ;

  Visual notation:

  

• INTL Top

   

  Text notation:

  INTL : . ;

  Visual notation: