* %      GOTO JSOLBSL;                                                  00300020
* /*******************************************************************/ 00600020
* /*                                                                 */ 00900020
* /* STATUS --                                                       */ 01200020
* /*    RELEASE 20, MODIFICATION LEVEL 00                            */ 01500020
* /*    A 0-999999                                            S20029 */ 01800020
* /*                                                                 */ 02100020
* /* FUNCTION --                                                     */ 02400020
* /*    DEFINE THE STRUCTURE AND PROPER USE OF THE JOB SCHEDULING    */ 02700020
* /*    OPTIONS LIST (JSOL)                                          */ 03000020
* /*                                                                 */ 03300020
* /* ENTRY POINTS --                                                 */ 03600020
* /*         NONE                                                    */ 03900020
* /*                                                                 */ 04200020
* /* INPUT --                                                        */ 04500020
* /*    NONE                                                         */ 04800020
* /*                                                                 */ 05100020
* /* OUTPUT --                                                       */ 05400020
* /*    DATA CONSTANTS (ASSEMBLER) OR DECLARATIONS OF THE VARIABLES  */ 05700020
* /*    WHICH CONSTITUTE THE JSOL.                                   */ 06000020
* /*                                                                 */ 06300020
* /* EXTERNAL REFERENCES --                                          */ 06600020
* /*         NONE                                                    */ 06900020
* /*                                                                 */ 07200020
* /* EXITS, NORMAL --                                                */ 07500020
* /*         NONE                                                    */ 07800020
* /*                                                                 */ 08100020
* /* EXITS, ERROR --                                                 */ 08400020
* /*         NONE                                                    */ 08700020
* /*                                                                 */ 09000020
* /* TABLE/WORK AREAS --                                             */ 09300020
* /*         NONE                                                    */ 09600020
* /*                                                                 */ 09900020
* /* ATTRIBUTES --                                                   */ 10200020
* /*         NOT APPLICABLE                                          */ 10500020
* /*                                                                 */ 10800020
* /* NOTES --                                                        */ 11100020
* /*    NONE                                                         */ 11400020
* /*                                                                 */ 11700020
* /*******************************************************************/ 12000020
* /* START OF SPECIFICATIONS ****                                       12300020
*1MODULE-NAME = IEFVJSOL                                                12600020
*  2PROCESSOR = ASSEMBLER, BSL                                          12900020
**********************************************************************/ 13200020
* /******************************************************************** 13500020
***** THE RELEASE FOR WHICH THIS MODULE WAS MOST RECENTLY UPDATED ***** 13800020
*1STATUS = 20 MODIFICATION LEVEL 00                                     14100020
**********************************************************************/ 14400020
* /******************************************************************** 14700020
*1DESCRIPTIVE-NAME = JOB SCHEDULING OPTIONS LIST MAPPING MACRO          15000020
**********************************************************************/ 15300020
* /******************************************************************** 15600020
*1DESCRIPTION = DEFINITION OF A JOB SCHEDULING OPTIONS LIST & ITS    -  15900020
*PROPER USE. THE JSOL IS A CONTROL BLOCK WHICH ALLOWS THE INVOKER OF -  16200020
*THE JOB SCHEDULING SUBROUTINE TO SPECIFY SPECIAL PROCESSING         -  16500020
*OPTIONS. IT IS A MANDATORY INPUT TO THE JOB SCHEDUING SUBROUTINE    -  16800020
*(JSS) AND GENERALLY IS USED TO SPECIFY THOSE OPTIONS OF THAT        -  17100020
*SUBROUTINE WHICH CANNOT CURRENTLY BE SPECIFIED THROUGH THE EBCDIC   -  17400020
*OPTIONS LIST PASSED AS THE FIRST ARGUMENT TO THE SUBROUTINE. THE    -  17700020
*SPECIFIC OPTIONS WHICH MAY BE SPECIFIED THROUGH THE JSOL ARE        -  18000020
*ENUMERATED IN THE FOLLOWING DISCUSSION.                                18300020
**********************************************************************/ 18600020
* /******************************************************************** 18900020
*1ASSUMPTIONS = THE JOB SCHEDULING SUBROUTINE REQUIRES THAT THE      -  19200020
*JSELJSOL POINTER IN THE JOB SCHEDULING ENTRANCE LIST ADDRESS A JSOL -  19500020
*STORED IN SUBPOOL ZERO WHERE IT WILL BE FREED AFTER THE OPTIONS ARE -  19800020
*INTERPRETED BY THE JSS.                                                20100020
**********************************************************************/ 20400020
* /******************************************************************** 20700020
*1FUNCTION = SEE DESCRIPTION ABOVE.                                     21000020
**********************************************************************/ 21300020
* /******************************************************************** 21600020
*1MODULE-TYPE = MACRO                                                   21900020
**********************************************************************/ 22200020
* /******************************************************************** 22500020
*1GLOBAL-ARITHMETIC-VARIABLES = LENJSOL                                 22800020
**********************************************************************/ 23100020
* /******************************************************************** 23400020
*1MACRO-SIZE = 325 CARDS                                                23700020
**********************************************************************/ 24000020
* /******************************************************************** 24300020
*1PARAMETER-RECEIVED = PREFIX                                           24600020
*1HOW-PASSED = KEYWORD                                                  24900020
*1PARAMETER-TYPE = CHARACTER STRING                                     25200020
*1LENGTH+MODE = VARIABLE                                                25500020
*1STRING-VALUE = A 1 TO 4 BYTE CHARACTER STRING, THE FIRST BYTE OF   -  25800020
*WHICH MUST BE ALPHABETIC AND THE REMAINING CHARACTER STRING MUST BE -  26100020
*ALPHANUMERIC.  THIS STRING WILL BE PREFIXED TO ALL SYMBOLS PRODUCED -  26400020
*BY THE MACRO-INSTRUCTION IN PLACE OF THE DEFAULT PREFIX 'JSOL'.        26700020
**********************************************************************/ 27000020
* /******************************************************************** 27300020
*1SYSTEM-MACROS = NONE                                                  27600020
**********************************************************************/ 27900020
* /******************************************************************** 28200020
*1EXTERNAL-TABLE = JSOL                                                 28500020
*  2TABLE-SCOPE = EXTERNAL                                              28800020
*  2TABLE-SIZE = 32 BYTES                                               29100020
*  2MAPPING-MACRO = IEFVJSOL                                            29400020
*  *******************************************************************/ 29700020
*  /******************************************************************* 30000020
*  2FIELD = JSOLLGTH                                                    30300020
*    3REFERENCE-TYPE = READ                                             30600020
*    3FIELD-DISPLACEMENT = 0 BYTES                                      30900020
*    3FIELD-TYPE = ARITHMETIC                                           31200020
*    3MODE = BINARY                                                     31500020
*    3LENGTH = 15 BITS                                                  31800020
*    3SIGN = SIGNED                                                     32100020
*    3SCALING = 0                                                       32400020
*    3VALUE = THE NUMBER OF BYTES IN THE JSOL                           32700020
*  *******************************************************************/ 33000020
*  /******************************************************************* 33300020
*  2FIELD = JSOLFLAG                                                    33600020
*    3REFERENCE-TYPE = READ                                             33900020
*    3FIELD-DISPLACEMENT = 2 BYTES                                      34200020
*    3FIELD-TYPE = TABLE                                                34500020
*    3SCOPE = EXTERNAL                                                  34800020
*    3TABLE-SIZE = 1 BYTE                                               35100020
*    3MAPPING-MACRO = IEFVJSOL                                          35400020
*    *****************************************************************/ 35700020
*    /***************************************************************** 36000020
*    3FIELD = JSOLPKO                                                   36300020
*      4REFERENCE-TYPE = READ                                           36600020
*      4FIELD-DISPLACEMENT = 0 BITS                                     36900020
*      4FIELD-TYPE = BIT STRING                                         37200020
*      4BITS-USED = BIT 1                                               37500020
*      4FUNCTION = INDICATE WHETHER THE INVOKER OF THE JOB           -  37800020
*      SCHEDULING SUBROUTINE HAS SUPPLIED A PROTECTION KEY TO BE     -  38100020
*      USED IF THE JOB IT SPECIFIED CONSISTS OF STEPS CONTAINING     -  38400020
*      PROGRAMS OTHER THAN THOSE NAMED IN IEEVLNKT.                     38700020
*      4VALUE = IF THIS BIT IS ONE, THE INVOKER HAS SUPPLIED A       -  39000020
*      PROTECTION KEY.                                                  39300020
*    *****************************************************************/ 39600020
*    /***************************************************************** 39900020
*    3FIELD = JSOLSMF                                                   40200020
*      4REFERENCE-TYPE = READ                                           40500020
*      4FIELD-DISPLACEMENT = 1 BIT                                      40800020
*      4FIELD-TYPE = BIT STRING                                         41100020
*      4BITS-USED = BIT 1                                               41400020
*      4FUNCTION = INDICATE WHETHER THE INVOKER OF THE JSS DESIRES   -  41700020
*      SMF PROCESSING FOR THE JOB TO BE INVOKED                         42000020
*      4VALUE = IF THIS BIT IS ONE, SMF PROCESSING WILL BE PERFORMED.   42300020
*    *****************************************************************/ 42600020
*    /***************************************************************** 42900020
*    3FIELD = JSOLSMF2                                                  43200020
*      4REFERENCE-TYPE = READ                                           43500020
*      4FIELD-DISPLACEMENT = 2 BITS                                     43800020
*      4FIELD-TYPE = BIT STRING                                         44100020
*      4BITS-USED = BIT 1                                               44400020
*      4FUNCTION = INDICATE WHETHER THE INVOKER OF THE JSS HAS       -  44700020
*      EXPLICITLY PROVIDED AN SMF OPTIONS BYTE IN THE JSOL OR        -  45000020
*      WHETHER THE SMF OPTIONS BYTE FOR THE SYSTEM SHOULD BE USED.      45300020
*      4VALUE = IF THIS BIT IS ONE, THE SMF OPTIONS BYTE WILL BE     -  45600020
*      TAKEN FROM THE JSOLSMFO FIELD.                                   45900020
*    *****************************************************************/ 45908020
*    /***************************************************************** 45916020
*    3FIELD = JSOLPSYS                                                  45924020
*      4REFERENCE-TYPE = READ                                           45932020
*      4FIELD-DISPLACEMENT = 3 BITS                                     45940020
*      4FIELD-TYPE = BIT STRING                                         45948020
*      4BITS-USED = BIT 1                                               45956020
*      4FUNCTION = INDICATE WHETHER SYSTEM TASKS SHOULD BE PERMITTED -  45964020
*      TO BE INVOKED OR WHETHER SUCH AN INVOCATION SHOULD BE         -  45972020
*      PROHIBITED.                                                      45980020
*      4VALUE = IF THIS BIT IS ONE, SYSTEM TASK INVOCATION IS TO BE  -  45988020
*      PROHIBITED.                                                      45996020
*    *****************************************************************/ 46004020
*    /***************************************************************** 46012020
*    3FIELD = JSOLSMS1                                                  46020020
*      4REFERENCE-TYPE = READ                                           46028020
*      4FIELD-DISPLACEMENT = 4 BITS                                     46036020
*      4FIELD-TYPE = BIT STRING                                         46044020
*      4BITS-USED = BIT 1                                               46052020
*      4FUNCTION = INDICATE WHETHER THE MESSAGES ISSUED BY THE JOB   -  46060020
*      SCHEDULING SUBROUTINE ARE TO BE SUPPRESSED.                      46068020
*      4VALUE = IF THIS BIT IS ONE, THE MESSAGES ARE TO BE SUPPRESSED.  46076020
*    *****************************************************************/ 46084020
*    /***************************************************************** 46092020
*    3FIELD = JSOLSMS2                                                  46100020
*      4REFERENCE-TYPE = READ                                           46108020
*      4FIELD-DISPLACEMENT = 5 BITS                                     46116020
*      4FIELD-TYPE = BIT STRING                                         46124020
*      4BITS-USED = BIT 1                                               46132020
*      4FUNCTION = INDICATE WHETHER THE MESSAGE 'INIT=JOBNAME' IS TO -  46140020
*      BE SUPPRESSED FOR JOBS SCHEDULED BY THE JOB SCHEDULING        -  46148020
*      SUBROUTINE.                                                      46156020
*      4VALUE = IF THIS BIT IS ONE, THE MESSAGE IS TO BE SUPPRESSED.    46164020
*  *******************************************************************/ 46200020
*   /*****************************************************************  46220020
*   3FIELD=JSOLSTK                                                      46240020
*     4REFERENCE-TYPE=READ                                              46260020
*     4FIELD-DISPLACEMENT=7 BITS                                        46280020
*     4FIELD-TYPE= BIT STRING                                           46300020
*     4BITS-USED=BIT1                                                   46320020
*     4FUNCTION=INDICATE TO JOB SCHEDULING SUBROUTINE THAT ADDRESS OF   46340020
*     CSCBS'S QMPA IS TO BE PASSED TO THE INTERPRETER VIA THE NEL       46360020
*     FIELD - NELQMPS.                                                  46380020
*     4VALUE=IF THIS BIT IS ONE, THE ADDRESS IS TO BE PASSED.           46400020
*  *******************************************************************/ 46420020
*  /******************************************************************* 46500020
*  2FIELD = JSOLPKEY                                                    46800020
*    3REFERENCE-TYPE = READ                                             47100020
*    3FIELD-DISPLACEMENT = 3 BYTES                                      47400020
*    3FIELD-TYPE = ARITHMETIC                                           47700020
*    3MODE = BINARY                                                     48000020
*    3LENGTH = 8 BITS                                                   48300020
*    3SIGN = UNSIGNED                                                   48600020
*    3SCALING = 0                                                       48900020
*    3VALUE = THE PROTECTION KEY TO BE USED BY THE JSS FOR THE       -  49200020
*    SCHEDULING OF THE JOB PASSED IF THAT JOB CONSISTS OF PROGRAMS   -  49500020
*    NOT ENUMERATED IN IEEVLNKT AND THE JSOLPKO BIT IS ONE.             49800020
*  *******************************************************************/ 50100020
*  /******************************************************************* 50400020
*  2FIELD = JSOLSMFO                                                    50700020
*    3REFERENCE-TYPE = READ                                             51000020
*    3FIELD-DISPLACEMENT = 4 BYTES                                      51300020
*    3FIELD-TYPE = ARITHMETIC                                           51600020
*    3MODE = BINARY                                                     51900020
*    3LENGTH = 8 BITS                                                   52200020
*    3SIGN = UNSIGNED                                                   52500020
*    3SCALING = 0                                                       52800020
*    3VALUE = THE SMF OPTIONS BYTE TO BE USED BY THE JSS FOR THE     -  53100020
*    SCHEDULING OF THE JOB PASSED IF BOTH THE JSOLSMF & THE JSOLSMF2 -  53400020
*    BITS ARE ONE.                                                      53700020
*  *******************************************************************/ 54000020
*  /******************************************************************* 54300020
*  2FIELD = *                                                           54600020
*    3FIELD-DISPLACEMENT = 5 BYTES                                      54900020
*    3FIELD-TYPE = RESERVED                                             55200020
*  *******************************************************************/ 55500020
*  /******************************************************************* 55800020
*  2FIELD = JSOLTPR                                                     56100020
*    3REFERENCE-TYPE = READ                                             56400020
*    3FIELD-DISPLACEMENT = 8 BYTES                                      56700020
*    3FIELD-TYPE = TABLE                                                57000020
*    3PURPOSE = DESCRIBE A TIOT PROLOGUE TO BE USED TO CONSTRUCT A   -  57300020
*    DUMMY TIOT, ONE THAT WILL BE USED BY THE JOB SCHEDULING         -  57600020
*    SUBROUTINE UNTIL THE TIOT FOR THE JOB TO BE SCHEDULED IS        -  57900020
*    AVAILABLE.                                                         58200020
*    3SCOPE = EXTERNAL                                                  58500020
*    3TABLE-SIZE = 24 BYTES                                             58800020
*    3MAPPING-MACRO = IEFVJSOL                                          59100020
*    *****************************************************************/ 59400020
*    /***************************************************************** 59700020
*    3FIELD = JSOLTJOB                                                  60000020
*      4REFERENCE-TYPE = READ                                           60300020
*      4FIELD-DISPLACEMENT = 0 BYTES                                    60600020
*      4FIELD-TYPE = CHARACTER STRING                                   60900020
*      4LENGTH+MODE = 8 CHARACTERS                                      61200020
*      4STRING-VALUE = JOBNAME/IDENTIFIER                               61500020
*    *****************************************************************/ 61800020
*    /***************************************************************** 62100020
*    3FIELD = JSOLTSTE                                                  62400020
*      4REFERENCE-TYPE = READ                                           62700020
*      4FIELD-DISPLACEMENT = 0 BYTES                                    63000020
*      4FIELD-TYPE = CHARACTER STRING                                   63300020
*      4LENGTH+MODE = 8 CHARACTERS                                      63600020
*      4STRING-VALUE = STEPNAME                                         63900020
*    *****************************************************************/ 64200020
*    /***************************************************************** 64500020
*    3FIELD = JSOLTPRO                                                  64800020
*      4REFERENCE-TYPE = READ                                           65100020
*      4FIELD-DISPLACEMENT = 0 BYTES                                    65400020
*      4FIELD-TYPE = CHARACTER STRING                                   65700020
*      4LENGTH+MODE = 8 CHARACTERS                                      66000020
*      4STRING-VALUE = PROCSTEPNAME                                     66300020
*                                                                       66600020
**** END OF SPECIFICATIONS ***/                                         66900020
         MACRO                                                          67200020
&NAME    IEFVJSOL &PREFIX=JSOL /*                                       67500020
&NAME    DS   0D             ALIGN THE JSOL ON A DOUBLEWORD BOUNDARY    67800020
&PREFIX.LGTH DC AL2(&PREFIX.END-&PREFIX)    LENGTH OF THE JSOL          68100020
&PREFIX.FLAG DC X'00'        FLAG BYTE                                  68400020
&PREFIX.PKO EQU X'80'        PROTECTION KEY OPTION SELECTION FLAG       68700020
&PREFIX.SMF EQU X'40'        SMF PROCESSING SELECTION FLAG              69000020
&PREFIX.SMF2 EQU X'20'       SMF SUPPORT CODE PROVIDED BIT              69300020
&PREFIX.PSYS EQU  X'10'      PROHIBIT SYSTEM TASKS                      69600020
&PREFIX.SMS1 EQU  X'08'      SUPPRESS SYSTEM TASK CONTROL MESSAGES      69900020
&PREFIX.SMS2 EQU  X'04'      SUPPRESS 'INIT=JOBNAME' WARM START MSG     70200020
*    EQU  X'02'              RESERVED                                   70400020
&PREFIX.STK  EQU  X'01'      INDICATES CSCB'S QMPA TO BE PASSED TO      70600020
*                            INTERPRETER VIA NEL                        70800020
&PREFIX.PKEY DC AL1(0)       PROTECTION KEY TO BE USED FOR PROGRAMS    *71100020
                             NOT LISTING IN THE LINKAGE TABLE IF THE   *71400020
                             PROTECTION KEY OPTION IS SELECTED.         71700020
&PREFIX.SMFO DC AL1(0)       SMF OPTIONS FOR THE JOB(S) TO BE RUN      *72000020
                             BY THE JOB SCHEDULING SUBROUTINE           72300020
             DC AL3(0)       RESERVED                                   72600020
&PREFIX.TPR  DS CL24         TIOT PROLOGUE TO BE SUBSTITUTED FOR THE   *72900020
                             PROLOGUE OF THE MODEL TIOT                 73200020
         ORG  &PREFIX.TPR                                               73500020
&PREFIX.TJOB DC CL8' '       JOBNAME FIELD FOR TIOT PROLOGUE            73800020
&PREFIX.TSTE DC CL8' '       STEPNAME FIELD FOR TIOT PROLOGUE           74100020
&PREFIX.TPRO DC CL8' '       PROCSTEPNAME FIELD FOR TIOT PROLOGUE       74400020
&PREFIX.END EQU *            END OF JOB SCHEDULING OPTIONS LIST         74700020
         ORG  &PREFIX.LGTH                                              75000020
&PREFIX  DS   CL(&PREFIX.END-&PREFIX.LGTH)                              75300020
         MEND                                                           75600020
**/ %    JSOLBSL: ;                                                     75900020
* /*******************************************************************/ 76200020
* /*      DEFINE THE JOB SCHEDULING OPTIONS LIST                     */ 76500020
* /*******************************************************************/ 76800020
* DECLARE                                                               77100020
* 1       IEFVJSOL BASED( JSOLPTR) BOUNDARY( DWORD),                    77400020
*                                                                       77700020
*         /*    HALFWORD BINARY INTEGER FIELD PROVIDING THE LENGTH   */ 78000020
*         /*    OF THE JSOL IN BYTES                                 */ 78300020
*         2     JSOLLGTH FIXED(15),                                     78600020
*                                                                       78900020
*         /*    EIGHT-BIT BIT STRING FIELD                           */ 79200020
*         2     JSOLFLAG BIT(8),                                        79500020
*                                                                       79800020
*               /* PROTECTION KEY OPTION FLAG                        */ 80100020
*               3  JSOLPKO BIT(1),                                      80400020
*                                                                       80700020
*               /* SMF PROCESSING SELECTION FLAG                     */ 81000020
*               3  JSOLSMF BIT(1),                                      81300020
*                                                                       81600020
*               /* BIT INDICATING THAT AN SMF SUPPORT CODE HAS BEEN  */ 81900020
*               /* PROVIDED                                          */ 82200020
*               3  JSOLSMF2 BIT(1),                                     82500020
*                                                                       82520020
*               /* BIT INDICATING THAT SYSTEM TASKS ARE PROHIBITED   */ 82540020
*               3  JSOLPSYS BIT(1),                                     82560020
*                                                                       82580020
*               /* BIT INDICATING THAT SYSTEM TASK CONTROL MESSAGES  */ 82600020
*               /* ARE TO BE SUPPRESSED                              */ 82620020
*               3  JSOLSMS1 BIT(1),                                     82640020
*                                                                       82660020
*               /* BIT INDICATING THAT THE WARM START MESSAGE,       */ 82680020
*               /* 'INIT=JOBNAME', IS TO BE SUPPRESSED               */ 82700020
*               3  JSOLSMS2 BIT(1),                                     82720020
*                                                                       82820020
*               /* RESERVED BIT. MUST BE ZERO TO ASSURE              */ 82920020
*               /* COMPATIBILITY WITH FUTURE EXTENSIONS TO THE JOB   */ 83020020
*               /* SCHEDULING SUBROUTINE.                            */ 83120020
*               3  * BIT(1),                                            83220020
*                                                                       83320020
*               /* BIT INDICATING TO JSS THAT ADDRESS OF CSCB'S QMPA */ 83420020
*               /* IS TO BE PASSED TO THE INTERPRETER VIA THE NEL    */ 83520020
*               /* FIELD - NELQMPA.                                  */ 83620020
*               3  JSOLSTK BIT(1),                                      83720020
*                                                                       84300020
*         /*    PROTECTION KEY TO BE USED FOR THE JOB                */ 84600020
*         2     JSOLPKEY POINTER(8),                                    84900020
*                                                                       85200020
*         /*    SMF-SUPPORT CODE                                     */ 85500020
*         2     JSOLSMFO POINTER(8),                                    85800020
*                                                                       86100020
*         /*    RESERVED                                             */ 86400020
*         2     * POINTER(24),                                          86700020
*                                                                       87000020
*         /*    TIOT PROLOGUE FIELD                                  */ 87300020
*         2     JSOLTPR CHARACTER(24),                                  87600020
*                                                                       87900020
*               /*   TIOT PROLOGUE JOBNAME FIELD                     */ 88200020
*               3    JSOLTJOB CHARACTER(8),                             88500020
*                                                                       88800020
*               /*   TIOT PROLOGUE STEPNAME FIELD                    */ 89100020
*               3    JSOLTSTE CHARACTER(8),                             89400020
*                                                                       89700020
*               /* TIOT PROLOGUE PROCSTEPNAME FIELD   */                90000020
*               3  JSOLTPRO CHARACTER(8);                               90300020
*%        DECLARE                                                       90600020
*         LENJSOL FIXED;                                                90900020
*%        LENJSOL = 32;                                                 91200020
