HDSP     TITLE 'IHKCHDSP - PRIORITY DISPATCHER'                         00300019
IHKCHDSP CSECT                                                          00600019
* 429000                                                         A24702 00700019
* 582000-585000                                                  A26525 00800019
* 523200-523500                                                  A28210 00850019
* 619800                                                           000D 00870019
*STATUS -                                                             * 00900019
*   CHANGE LEVEL 0                                                    * 01200019
*                                                                     * 01500019
*FUNCTION -                                                           * 01800019
*   THIS ROUTINE IS A MULTIPLE-WAIT, PRIORITY DISPATCHER FOR RJE. IT  * 02100019
*   CONTROLS THE FLOW OF TRAFFIC WITHIN RJE, GIVING CONTROL TO A LINE,* 02400019
*   WHENEVER POSSIBLE, BEFORE GIVING CONTROL TO THE READER, WRITER, OR* 02700019
*   CENTRAL COMMAND SUBTASKS. NO RJE SUBTASK CAN SEIZE CONTROL FROM   * 03000019
*   ANOTHER. ALL SUBTASK SWITCHING IS SUPERVISED BY THIS ROUTINE; IN  * 03300019
*   OTHER WORDS, A SUBTASK RECEIVES CONTROL ONLY FROM THIS DISPATCHER * 03600019
*   AND YIELDS CONTROL ONLY TO THIS DISPATCHER.                       * 03900019
*                                                                     * 04200019
*   DURING WARMSTART PROCEDURES, THE READER, WRITER AND CENTRAL       * 04500019
*   COMMANDS ARE GIVEN PRIORITY BECAUSE THE LINES MUST WAIT ON THESE  * 04800019
*   SUBTASKS TO COMPLETE BEFORE STARTING THEIR OPERATIONS.  AFTER     * 05100019
*   STARTUP IS FINISHED, THE LINES ARE ASSIGNED HISHEST PRIORITY.     * 05400019
*                                                                     * 05700019
*   LINE PRIORITY IS ACCOMPLISHED BY HAVING SEPARATE SUBTASK CONTROL  * 06000019
*   BLOCK (STCB) CHAINS FOR THE LINE STCB'S AND THE OTHER STCB'S. THE * 06300019
*   CHAIN FOR THE READER, WRITER AND CENTRAL COMMAND SUBTASKS IS IN   * 06600019
*   THIS ROUTINE; THE CHAIN FOR THE LINES IS GENERATED BY THE RJELINE * 06900019
*   MACRO AT RJE ASSEMBLY TIME. THE LINE CHAIN IS CHECKED FIRST FOR   * 07200019
*   SOMEONE WISHING CONTROL. IF NO LINE WISHES CONTROL, THE OTHER     * 07500019
*   CHAIN IS CHECKED. IF NO ONE WISHES CONTROL AT A PARTICULAR TIME,  * 07800019
*   A WAIT IS ISSUED. UPON RETURN FROM THE WAIT, THE CHECKING RESUMES.* 08100019
*                                                                     * 08400019
*   THIS ROUTINE ALSO PROVIDES RJE WITH A LOCKED DOOR FUNCTION. IF AT * 08700019
*   ANY TIME, ONE MODULE WISHES TO USE ANOTHER MODULE BUT FINDS IT    * 09000019
*   LOCKED, I.E. ALREADY BEING USED, THE 'LOCKED-OUT' MODULE'S REGIS- * 09300019
*   TERS ARE SAVED AND THE DISPATCHER IS CALLED WITH REGISTER 14 ZERO.* 09600019
*   THE DISPATCHER THEN FLAGS THE SPECIAL ECB IN THE STCB AS WAITING  * 09900019
*   AT A LOCKED DOOR AND TREATS THAT SUBTASK AS IF IT WERE POSTED     * 10200019
*   COMPLETE.                                                         * 10500019
*                                                                     * 10800019
*   IF, AT ANY TIME, AN RJE SUBTASK ABENDS, A MESSAGE IS WRITTEN A24702 10870019
*   TO THE CENTRAL OPERATOR AND RJE IS CLOSED DOWN ABNORMALLY.   A24702 10940019
*                                                                A24702 11010019
*ENTRY POINT -                                                        * 11100019
*                                                                     * 11400019
*   IHKAADSP IS THE ONLY ENTRY POINT.                                 * 11700019
*        REGISTERS AT ENTRY WITH A STANDARD ECB ARE                   * 12000019
*             1-   ECB ADDRESS                                        * 12300019
*             13-  SAVE AREA ADDRESS OF CALLING ROUTINE               * 12600019
*             14-  RETURN ADDRESS                                     * 12900019
*             15-  ADDRESS OF IHKAADSP                                * 13200019
*        REGISTERS AT ENTRY FOR LOCKED DOOR FUNCTION ARE              * 13500019
*             13-  SAVE AREA ADDRESS OF ROUTINE LOCKED OUT            * 13800019
*             14-  ZERO                                               * 14100019
*             15-  ADDRESS OF IHKAADSP                                * 14400019
         EJECT                                                          14700019
*INPUT -                                                              * 15000019
*   REGISTERS DESCRIBED ABOVE.                                        * 15300019
*                                                                     * 15600019
*OUTPUT -                                                             * 15900019
*   ADDRESS OF POSTED ECB IN REGISTER 1.                              * 16200019
*                                                                     * 16500019
*EXTERNAL ROUTINES -                                                  * 16800019
*   O/S MULTIPLE WAIT MACRO INSTRUCTION.                              * 17100019
*                                                                     * 17400019
*EXITS,NORMAL -                                                       * 17700019
*   CONTROL IS PASSED TO SUBTASK WHOSE POSTED ECB ADDRESS IS IN       * 18000019
*   REGISTER 1.                                                       * 18300019
*                                                                     * 18600019
*EXITS,ERROR -                                                   A24702 18700019
*   CONTROL IS PASSED TO IHKXJBGN IF AN RJE SUBTASK ABENDS.      A24702 18800019
*TABLES/WORK AREAS -                                                  * 18900019
*   1. SUBTASK CONTROL BLOCK (STCB) FOR EACH RJE SUBTASK. THE FIELDS  * 19200019
*      OF AN STCB ARE AS FOLLOWS -                                    * 19500019
*        WORD1 - POINTER TO NEXT STCB IN CHAIN.                       * 19800019
*        WORD2 - POINTER TO ECB LIST ENTRY FOR THIS SUBTASK.          * 20100019
*        WORD3 - POINTER TO SAVE AREA FOR THIS SUBTASK.               * 20400019
*        WORD4 - DUMMY ECB USED FOR STARTUP AND LOCKED DOOR FUNCTION. * 20700019
*   2. RJE ECBLIST. THIS LIST CONTAINS THE MOST RECENT ECB ADDRESS FOR* 21000019
*      EACH RJE SUBTASK.                                              * 21300019
*                                                                     * 21600019
*ATTRIBUTES -                                                         * 21900019
*   THIS ROUTINE IS NEITHER RE-ENTRANT NOR REUSABLE.                  * 22200019
*********************************************************************** 22500019
         SPACE 4                                                        22800019
*                        REGISTER EQUATES                               23100019
R0       EQU   0                   PARAMETER REGISTER            A28210 23200019
R1       EQU   1                   ADDRESS OF ECB                       23400019
R2       EQU   2                   BASE FOR STCB DSECT                  23700019
R3       EQU   3                                                        24000019
R4       EQU   4                   WORK REGISTER                        24300019
R5       EQU   5                                                        24600019
R6       EQU   6                  RETURN REGISTER                       24900019
R7       EQU   7                   LINK REGISTER                        25200019
R8       EQU   8                   ADDRESS OF ECB FOR COMMANDS          25500019
R9       EQU   9                   ADDRESS OF COMMUNICATIONS SWITCHES   25800019
R10      EQU   10                  WORK REGISTER                        26100019
R12      EQU   12                  BASE REGISTER                        26400019
R13      EQU   13                  SAVE REGISTER                        26700019
R14      EQU   14                  RETURN REGISTER                      27000019
R15      EQU   15                  RETURN REGISTER                      27300019
         EJECT                                                          27600019
IHKAADSP DS    0H                                                       27900019
         ENTRY IHKAADSP                                                 28200019
         USING STCBSECT,R2         SET UP ADDRESSABILITY FOR STCB DSECT 28500019
         USING CURRENT,R5          ADDRESSABILITY FOR CURRENT DSECT     28800019
         USING *,R15                                                    29100019
         SPACE 2                                                        29400019
         B     AROUNDID            BRANCH AROUND ID                     29700019
         DC    C'IHKAADSP'                                              30000019
AROUNDID DS    0H                                                       30300019
         SPACE 4                                                        30600019
*                        TEST FOR ROUTINE AT LOCKED DOOR                30900019
         LTR   R14,R14             R14 HAS ZERO FOR LOCKED DOOR         31200019
         BNZ   NOTLOCK                                                  31500019
         SPACE 3                                                        31800019
*                        THE ROUTINE WHOSE SAVE AREA PTR                32100019
*                        IS IN R13 TRIED TO ENTER A LOCKED              32400019
*                        DOOR. THE LOCKED ROUTINE SAVED                 32700019
*                        REGISTERS AND ZEROED R14.                      33000019
         SPACE 2                                                        33300019
         L     R2,PRESENT          GET PRESENT STCB                     33600019
         LA    R1,WAIT             POINT TO SPECIAL POSTED ECB          33900019
         MVI   0(R1),WAITREUS      TURN OFF COMPLETION CODE             34200019
         B     COMMON                                                   34500019
         SPACE 4                                                        34800019
*                        REGULAR ENTRY TO WAIT IN DISPATCHER            35100019
NOTLOCK  SAVE  (14,12)                                                  35400019
         L     R2,PRESENT          GET PRESENT STCB                     35700019
         MVI   WAIT,COMPLETE       SET COMPLETION CODE                  36000019
         SPACE 2                                                        36300019
*                        COMMON CODE FOR LOCKED DOOR AND WAIT           36600019
COMMON   BALR  R12,0                                                    36900019
         USING *,R12               ADDRESSABILITY FOR MODULE            37200019
         DROP  R15                                                      37500019
         EJECT                                                          37800019
*                        PUT SAVE AREA PTR IN STCB                      38100019
         ST    R13,SAVE                                                 38400019
*                        PUT ADDRESS OF ECB IN ECBLIST,                 38700019
*                        SAVING HIGH ORDER BYTE.                        39000019
         L     R3,ECB              GET ECB ADDRESS PTR                  39300019
         IC    R4,0(0,R3)          SAVE HIGH-ORDER BYTE                 39600019
         ST    R1,0(0,R3)          STORE ECB PTR                        39900019
         STC   R4,0(0,R3)          RESTORE HIGH-ORDER BYTE              40200019
         SPACE 2                                                        40500019
         L     R9,IHKZZRCS         GET ADDRESS OF WARMSTART SWITCHES    40800019
         BAL   R7,TEST             SEE WHO GETS PRIORITY                41100019
         SPACE 4                                                        41400019
*                        LOOP THROUGH STCB'S TO FIND ONE                41700019
*                        WHICH IS POSTED. AFTER LOOPING                 42000019
*                        THROUGH LINES, LOOP THROUGH RDR,               42300019
*                        WTR,AND COMMANDS, AND THEN WAIT.               42600019
         L     R8,VH1ECBAD         GET ADDR OF VHU'S ECB         A24702 42900019
         MVI   0(R8),NOTEND        WARMSTART IS OVER, SERVICE LINES     43200019
         SPACE 2                                                        43500019
LOOP     CLC   LINK+1(3),NOW+1     TEST FOR COMPLETE LOOP               43800019
         BE    CHECKEND            YES, SEE IF WAIT NEXT                44100019
         SPACE 1                                                        44400019
LOOP2    L     R2,LINK             BASE FOR NEXT STCB                   44700019
         CLI   WAIT,WAITREUS       TEST FOR LOCKED DOOR                 45000019
         BE    CHECK               CHECK ON LOCKED DOOR                 45300019
         SPACE 2                                                        45600019
         L     R3,ECB              GET ECB ADDRESS PTR                  45900019
         L     R1,0(0,R3)          GET ECB ADDRESS                      46200019
         TM    0(R1),COMPLETE      CHECK FOR POSTED ECB                 46500019
         BZ    LOOP                NO, CONTINUE                         46800019
         SPACE 2                                                        47100019
         BAL   R6,STORE            GET READY TO LEAVE                   47400019
         RETURN (14,12)                                                 47700019
        EJECT                                                           48000019
*                        DETERMINE WHICH LOOP IS DONE                   48300019
CHECKEND CLI   LINK,THREE          SEE IF LINE LOOP                     48600019
         BL    GOWAIT              NO, WAIT                             48900019
         ST    R2,NOW              REMEMBER POSITION STARTED FROM       49200019
         SPACE 1                                                        49500019
READER   DS    0H                                                       49800019
         LA    R5,OTHER            SETUP FOR READER LOOP                50100019
         L     R2,NOW              GET CURRENT STCB                     50400019
         B     LOOP2                                                    50700019
         SPACE 2                                                        51000019
*                        WAIT UNTIL ECB IS POSTED                       51300019
GOWAIT   L     R1,ECBLIST          GET PTR TO ECBLIST                   51600019
         ST    R2,NOW              SAVE CURRENT STCB POINTER            51900019
         WAIT  ECBLIST=(1)         WAIT                                 52200019
         SPACE 1                                                 A24702 52230019
         USING DSPDSECT,R10        SET UP ADDRESSABILITY         A24702 52260019
         L     R10,DSPBGN          GET BASE FOR DSECT            A24702 52290019
         TM    VH1ECB,COMPLETE     SEE IF IHKBBRII ABENDED       A24702 52380019
         BO    CLOSE               YES, CLOSE DOWN RJE           A24702 52410019
         TM    BGNQMECB,COMPLETE   SEE IF IHKQMNGR ABENDED       A28210 52440019
         BO    CLOSEQM             YES, CLOSEDOWN                A28210 52470019
         SPACE 1                                                        52500019
         LA    R7,LOOP2            SET RETURN TO LOOP2                  52800019
         SPACE 3                                                        53100019
*                     SUBROUTINE TO SEE WHO GETS PRIORITY               53400019
         SPACE 1                                                        53700019
TEST     DS    0H                                                       54000019
         TM    0(R9),WARM          CHECK FOR WARMSTART                  54300019
         BNZ   READER              GIVE PRIORITY TO READER              54600019
         LA    R5,LINE             SET UP FOR LINE LOOP                 54900019
         L     R2,NOW              GET CURRENT STCB                     55200019
         BR    R7                                                       55500019
         SPACE 3                                                        55800019
*                        EXIT FROM DISPATCHER TO ATTEMPT                56100019
*                        TO ENTER PREVIOUSLY LOCKED MODULE.             56400019
CHECK    DS    0H                                                       56700019
         LA    R7,GOWAIT          GO TO WAIT EVER0 F-0RT& TI-E   A26525 56800019
*                                  LOCKED DOOR IN READER LOOP    A26525 56900019
         CLI   LINK,THREE          IS LOCKED DOOR IN READER LOOP        57000019
         BL    REUSMOD             YES, GO DIRECTLY TO MODULE           57300019
         LA    R7,READER          GO TO READER LOOP EVERY FOURTH A26525 57370019
*                                  TIME LOCKED DOOR IN LINE LOOP A26525 57440019
REUSMOD  DS    0H                                                A26525 57510019
         UNPK  BYTE,BYTE                                                57600019
         XC    LOCK,BYTE                                                57900019
         BCR   8,R7                GO TO READER LOOP OR WAIT     A26525 58300019
         BAL   R6,STORE            GET READY TO LEAVE                   58800019
         LM    R14,R12,12(R13)     RESTORE REGISTERS                    59100019
         BR    R15                 RETURN                               59400019
         SPACE 3                                                        59700019
*                       SUBROUTINE TO STORE CURRENT STCB                60000019
*                       IN PROPER LOCATION.                             60300019
STORE    DS    0H                                                       60600019
         L     R13,SAVE            RESTORE SAVE REGISTER                60900019
         ST    R2,NOW              STORE CURRENT  STCB                  61200019
         ST    R2,PRESENT          KEEP PRESENT STCB PTR FOR RETURN     61500019
         BR    R6                                                       61800019
         SPACE 3                                                 A24702 61830019
*              ABNORMAL CLOSEDOWN FROM SUBTASK                   A24702 61860019
         SPACE 1                                                 A24702 61890019
CLOSEQM  DS    0H                                                A28210 61893019
         LA    R0,EOD              SET FOR EODAD                 A28210 61896019
         L     R1,RIPOST           GET ECB ADDRESS               A28210 61899019
         POST  (1),(0)             POST RII                      A28210 61902019
         L     R1,RIWAIT           GET ECB ADDRESS FOR WAIT      A28210 61905019
         XC    0(4,R1),0(R1)       CLEAR ECB                     A28210 61908019
         WAIT  ECB=(1)             WAIT FOR COMPLETION           A28210 61911019
         TM    3(R1),X01           MAKE SURE EODAD               A28210 61914019
         BZ    CLOSEQM             IF NOT TRY AGAIN              A28210 61917019
CLOSE    DS    0H                                                A24702 61920019
         OI    0(R9),ABNORM        INDICATE ABNORMAL END         A24702 61950019
         WTO   'IHK068I RJE SUBTASK ABENDED',ROUTCDE=(2),DESC=(2)  000D 61980019
         L     R15,EODAD           ENTRY IN IHKXJBGN FOR CLOSE   A24702 62010019
         BR    R15                   DOWN OF RJE                 A24702 62040019
         EJECT                                                          62100019
*                        CONSTANTS                                      62400019
         SPACE 4                                                        62700019
*                        EQUATES                                        63000019
X01      EQU   X'01'               CLOSE DOWN INDICATOR          A28210 63100019
WARM     EQU   X'28'               WARMSTART SWITCHES FOR STARTUP       63300019
COMPLETE EQU   X'40'                                                    63600019
WAITREUS EQU   X'00'                                                    63900019
NOTEND   EQU   X'00'                                                    64200019
YES      EQU   X'FF'               LOCKED DOOR ENCOUNTERED              64500019
THREE    EQU   3                   FIRST LINE ID IN STCB LINK FIELD     64800019
ABNORM   EQU   3                   INDICATE ABNORMAL END OF RJE  A24702 64840019
         EXTRN IHKBGNIN,ECBVH1,IHKEODAD                          A24702 64880019
EODAD    DC    A(IHKEODAD)         ADDRESS OF CLOSEDOWN ENTRY    A24702 64920019
VH1ECBAD DC    A(ECBVH1)           ADDRESS OF ECB FOR VH1 SUBTSK A24702 64960019
DSPBGN   DC    A(IHKBGNIN)         BASE FOR DSECT OF ECBS        A24702 65000019
         SPACE 1                                                 A24702 65040019
         SPACE 3                                                        65100019
LOCK     DC    X'00'               LOCKED DOOR INDICATOR                65400019
BYTE     DC    X'0F'                                                    65700019
IHKZZRCS DC    V(IHKCDRCS)                                              66000019
         EXTRN IHKCBRDP,IHKCBRDE                                 A28210 66060019
RIPOST   DC    A(IHKCBRDE)         ECB ADDRESS FOR POST          A28210 66120019
RIWAIT   DC    A(IHKCBRDP)         ECB ADDRESS FOR WAIT          A28210 66180019
EOD      DC    X'0C000000'         EODAD CONSTANT FOR RII        A28210 66240019
         SPACE 1                                                        66300019
*                        CURRENT STCB IN EACH GROUP                     66600019
LINE     DC    V(IHKCSTCB)         CURRENT LINE (ORIGINALLY FIRST LINE) 66900019
OTHER    DC    A(IHKAAST0)         CURRENT OTHER (ORIGINALLY READER)    67200019
PRESENT  DC    A(IHKAAST0)         PRESENT STCB (ORIG. READER)          67500019
         SPACE 4                                                        67800019
*                        WRITER STCB                                    68100019
IHKAASTW DS    0D                                                       68400019
         DC    A(IHKAAST0)         PTR TO READER STCB                   68700019
         DC    V(ECBWTR)           PTR TO PTR TO ECB FOR WRITER         69000019
         DC    V(IHKWTRSV)         WRITER SAVE AREA PTR                 69300019
IHKPOST1 DC    X'40000000'                                              69600019
*                        READER STCB                                    69900019
IHKAAST0 DC    AL1(1)                                                   70200019
         DC    AL3(IHKAASTB)       PTR TO COMMAND STCB                  70500019
ECBLIST  DC    V(IHKAALST)         PTR TO ECBLIST FOR WAIT              70800019
         DC    A(0)                                                     71100019
         DC    X'40000000'                                              71400019
*                        COMMAND PROCESSOR STCB                         71700019
IHKAASTB DC    AL1(2)                                                   72000019
         DC    AL3(IHKAASTW)       PTR TO WRITER STCB                   72300019
CMDECB   DS    0F                                                       72600019
         DC    V(ECBCMD)           PTR TO PTR TO ECB FOR COMMAND        72900019
         DC    V(IHKCMDSV)         COMMAND SAVE AREA PTR                73200019
IHKPOST2 DC    X'40000000'                                              73500019
         SPACE 2                                                        73800019
         ENTRY IHKAAST0,IHKAASTB,IHKPOST1,IHKPOST2                      74100019
         SPACE 2                                                        74400019
STCBSECT DSECT           DSECT FOR A STCB                               74700019
LINK     DC    A(IHKAAST0)         PTR TO NEXT STCB IN CHAIN            75000019
ECB      DC    A(0)                PTR TO PTR TO ECB                    75300019
SAVE     DC    A(0)                STORED ADDRESS OF SAVE AREA          75600019
WAIT     DC    X'40000000'         DUMMY POSTED ECB                     75900019
         SPACE 2                                                        76200019
CURRENT  DSECT           DSECT FOR CURRENT STCB                         76500019
NOW      DC    A(0)                                                     76800019
         SPACE 3                                                 A24702 76830019
DSPDSECT DSECT                     DSECT OF ECBS IN !GN          A24702 76860019
BGNTCB   DS    F                   TCB FOR QMGR SUBTASK          A24702 76890019
         DS    F                   UNUSED                        A24702 76920019
BGNQMECB DS    F                   ECB FOR QMGR COMPLETED        A24702 76950019
VH1ECB   DS    F                   ECB FOR R/I SUBTASK COMPLETED A24702 76980019
VH1TCB   DS    F                   TCB FOR R/I SUBTASK           A24702 77010019
         END                                                            77100019
