         TITLE ' IEECMPMC - VMS CONSOLE I/O ROUTINE '                   00300018
*********************************************************************** 00600018
*                                                                       00900018
*                                                                       01200018
* NAME         IEECVPM  COMMUNICATION TASK PROCESS MODULE (PM).         01500018
*                       ACCESS METHOD  BSAM (2540)                      01800018
*                                                                       02100018
*                                                                       02400018
* FUNCTION         THE PURPOSE OF THIS MODULE IS TO MANAGE THE          02700018
*                  INTERFACES WITH IOS AND DATA MANAGEMENT REQUIRED     03000018
*                  FOR I/O ACTIVITY ON A DEVICE SUPPORTED AS A CONSOLE. 03300018
*                  THERE ARE 5 PRIMARY SERVICES PERFORMED..             03600018
*                                                                       03900018
*                                                                       04200018
*                       1. INTERCEPTS CLOSE REQUEST, QUIESES I/O        04500018
*                          DISPOSES OF BUFFER, AND XCTL S TO CLOSE      04800018
*                          MODULE.                                      05100018
*                                                                       05400018
*                       2. INTERCEPTS UNOPENED CONDITION AND XCTL S TO  05700018
*                          OPEN MODULE.                                 06000018
*                                                                       06300018
*                       3. INITIATES I/O ACTIVITY.                      06600018
*                                                                       06900018
*                       4. RESPONDS TO I/O COMPLETION CONDITIONS,       07200018
*                          INCLUDING I/O ERROR CONDITIONS, AND          07500018
*                          RE-INITIATION OF I/O.                        07800018
*                                                                       08100018
*                       5. MANAGES ACQUISITION AND DISPOSITION OF       08400018
*                          BUFFERS.                                     08700018
*                                                                       09000018
*                                                                       09300018
* INPUT            REG 1 POINTS TO PARAMETER LIST MAPPED BY CXSA.       09600018
*                  LIST INCLUDES POINTERS TO THE UCM MODULE, AND THE    09900018
*                  ACTIVE UCM ENTRY.                                    10200018
*                                                                       10500018
*                                                                       10800018
* OUTPUT           UNIT STATUS IN THE UCM ENTRY.                        11100018
*                                                                       11400018
*                                                                       11700018
* EXTERNAL REF.    DCBD                                                 12000018
*                  WAIT                                                 12300018
*                  XCTL                                                 12600018
*                  UCM                                                  12900018
*                  IEECVOC , OPEN/CLOSE MODULE.                         13200018
*                  CXSA                                                 13500018
*                  GETMAIN                                              13800018
*                  FREEMAIN                                             14100018
*                  AUTOMATIC SWITCH ROUTINE                             14400018
*                                                                       14700018
*                                                                       15000018
* EXITS            VIA XCTL...                                          15300018
*                  TO OPEN/CLOSE MODULE FOR RESPECTIVE FUNCTION.        15600018
*                  TO AUTOMATIC SWITCH ROUTINE AFTER CLOSE REQUEST TO   15900018
*                  NEVEN OPENED ENTRY.                                  16200018
*                  VIA RETURN...                                        16500018
*                  TO DEVICE SERVICE ROUTINE NORMALLY.                  16800018
*                                                                       17100018
*                                                                       17400018
* TABLES           UCM                                                  17700018
*                  DCB                                                  18000018
*                  CXSA                                                 18300018
*                  WQE                                                  18600018
*                                                                       18900018
*                                                                       19200018
* OPERATION        1. IF CLOSE REQUEST NOT PENDING, TESTS BUSY.         19500018
*                     TO CLOSE, CHECKS IF OPEN, THEN QUIESES I/O AND    19800018
*                     DISPOSES OF BUFFER. XCTL S TO CLOSE MODULE.       20100018
*                                                                       20400018
*                  2. IF NOT BUSY, TESTS REQUEST FLAGS.                 20700018
*                     IF BUSY, CHECKS FOR I/O COMPLETE. IF NOT FINISHED 21000018
*                     RETURNS TO DEVICE SERVICE. IF FINISHED, ERROR     21300018
*                     CHECKS OPERATION, DISPOSES OF BUFFER, AND TESTS   21600018
*                     REQUEST FLAGS.                                    21900018
*                                                                       22200018
*                  3. IF REQUESTS FLAGS NOT PENDING, RETURNS TO DEVICE  22500018
*                     SERVICE. IF NOT OPEN, EXIT TO OPEN/CLOSE MODULE,  22800018
*                     OTHERWISE ACQUIRES BUFFER AND INITIATES I/O.      23100018
*                     THEN RETURNS TO DEVICE SERVICE.                   23400018
*                                                                       23700018
*                                                                       24000018
*                  4. BUFFER HANDLING (2540, BSAM)                      24300018
*                                                                       24600018
*                       BUFFERS ARE ACQUIRED AND FREED DYNAMICALLY.     24900018
*                       THEY ARE SUBMITTED TO COMMAND SCHEDULERS FOR    25200018
*                       PROCESSING WITH MGCR (SVC 34).                  25500018
*                                                                       25800018
*                  5. ERRORS.                                           26100018
*                       UNCORRECTABLE I/O ERROR RESULT IN AN XCTL TO    26400018
*                       THE AUTOMATIC SWITCH ROUTINE.                   26700018
*                                                                       27000018
*                                                                       27300018
*                                                                       27600018
* COMMENT          THIS MODULE WILL SERVE AND INDEFINITE NUMBER OF      27900018
*                  UCM ENTRIES.                                         28200018
*                                                                       28500018
*                  ACCESS INTER-LOCKS, AS REQUIRED, ARE IMPOSED BY      28800018
*                  DISABLING THE MACHINE. NORMALLY THIS ROUTINE MAY     29100018
*                  RUN ENABLED, PRIVILEGED, WITH PROTECTION KEY=0.      29400018
*                                                                       29700018
*                                                                       30000018
*********************************************************************** 30300018
IEECVPM  CSECT                                                          30600018
*434000,438000  UCB STATUS A BYTE                                  I273 30610019
*               IOB LENGTH IN DCB                                 M4450 30710019
*MODULE CREATED FOR MCS - REL 18                                        30900018
X0       EQU   0             SYSTEM INTERFACING.                        31200018
X1       EQU   1             SYSTEM INTERFACING.                        31500018
X2       EQU   2             SCRATCH.                                   31800018
X3       EQU   3             SCRATCH.                                   32100018
X4       EQU   4             SCRATCH.                                   32400018
X5       EQU   5             LM-BXLE                                    32700018
X6       EQU   6              INDEXING                                  33000018
X7       EQU   7              TRIO,AND SCRATCH.                         33300018
X8       EQU   8             QUEUE ELEMENT BASE (WQE).                  33600018
X9       EQU   9             DCB BASE.                                  33900018
XA       EQU   10            UCM ENTRY BASE.                            34200018
XB       EQU   11            CXSA PTR.                                  34500018
XC       EQU   12            THIS PROGRAM BASE.                         34800018
XD       EQU   13            SAVE AREA BASE.                            35100018
XE       EQU   14            EXIT PTR.                                  35400018
XF       EQU   15            SYSTEM INTERFACING.                        35700018
ZERO     EQU   0                   ZERO                                 35720018
RETURNRG EQU   14                  RETURN REGISTER                      35740018
NUM255   EQU   255                 USE TO REVERSE MASKS                 35760018
ZEROBYTE EQU   X'00'               ZERO BYTE                            35780018
F84      EQU   84                                                       35800018
THRTYFOR EQU   34                  34 FOR SVC                           35820018
GETMBUFF EQU   X'10'               USE TO TEST IF GETMAIN GOT BUFFER    35840018
HEX50    EQU   X'50'               GETMAIN INDICATOR                    35860018
BUFFUSE  EQU   X'40'               MASK TO TEST IF BUFFER IN USE        35880018
BLANK    EQU   X'40'               USE TO BLANK OUT BUFFER AREA         35900018
ONE      EQU   1                                                        35920018
T3       EQU   3                                                    MCS 35950018
T11      EQU   11                                                   MCS 35980018
         BALR  XC,ZERO                 BASE                             36020018
         USING *,XC                    THIS PROGRAM.                    36300018
         LR    XB,X1                                                    36600018
         USING PMXSA,XB                                                 36900018
         ST    RETURNRG,CSAXA          SAVE RETURN REG.                 37200018
         L     XA,CSAUCM               BASE UCM ENTRY.                  37500018
         USING UCMLIST,XA                                               37800018
         L     X9,UCMDCB               BASE DCB                         38100018
         USING IHADCB,X9                                                38400018
         L     X8,DMX                  ACTIVE BUFFER PTR.               38700018
         LA    X8,ZERO(X8)             KILL HIGH BYTE.                  39000018
         USING PMWQE,X8                                                 39300018
*                                      REGISTER SAVING.                 39600018
       GETMAIN R,SP=255,LV=72                                           39900018
         LR    XD,X1                                                    40200018
         SSM   PMENABLE                MUST BE ENABLED FOR WAITS.       40500018
         EJECT                                                          40800018
PMCF     EQU   *                                                        41100018
         TM    UCMSTS,UCMCF            Q. CLOSE REQUEST.                41400018
         BZ    PMBF                    NO.                              41700018
*                                      SECURE BUFFER FOR CLOSE.         42000018
         TM    UCMSTS,UCMBF+UCMAF  IS ANYTHING PENDING              MCS 42200018
         BNZ   PMBF                YES QUIESCE                      MCS 42400018
         TM    UCMSTS,UCMTA        IS AN OPEN PENDING               MCS 42600018
         BNO   PMCLOSE             NO-BRANCH                        MCS 42800018
         NI    UCMSTS,NUM255-UCMTA-UCMCF TURN OFF OPEN CLOSE FLAGS  MCS 43000018
         L     X8,UCMUCB           UCB ADDRESS                      MCS 43200018
         MVI   T11(X8),ZEROBYTE   CLEAR UCBATI FIELD                MCS 43600018
RETURN   LR    X1,XD              RESTORE SAVE AREA ADDR           MCS  43900018
         FREEMAIN R,SP=255,LV=72,A=(1)                              MCS 44000018
         L     XE,CSAXA           RETURN ADDR                       MCS 44100018
         BR    XE                  RETURN TO DEVICE SERVICE ROUTINE MCS 44200018
UCMOPF   EQU   X'08'                                                    44400018
PMCLOSE  EQU   *                                                        44700018
         NI    UCMSTS,NUM255-UCMCF     CF=OFF                           45000018
         MVI   CSACODE,CSACLOSE        LOCAL CLOSE CODE.                45300018
PMCLOPN  EQU   *                                                        45600018
         MVC   CSANAME,PMCFNAME        XCTL OPEN/CLOSE MODULE NAME.     45900018
         SPACE                                                          46200018
PMGONE   EQU   *                                                        46500018
*                                      RELEASE SAVE AREA.               46800018
         LR    X1,XD                                                    47100018
      FREEMAIN R,SP=255,LV=72,A=(1)                                     47400018
PMCEND2  EQU   *                                                      P 47700018
         L     RETURNRG,CSAXA          RESTORE RETURN REG.              48000018
         LR    X1,XB                   CXSA PTR PASSING.                48300018
         LR    XF,XB                   PRE-SET 15.                      48600018
         XCTL  SF=(E,(15))                                              48900018
         EJECT                                                          49200018
PMBF     EQU   *                                                        49500018
         TM    UCMSTS,UCMBF            Q. BUSY.                         49800018
         BZ    PMAPF                   NO.                              50100018
*                                  Q. I/O COMPLETE.                     50400018
         TM    UCMDEVC,UCMDEVE         TEST DEVICE FOR I/O COMPLETE MCS 50700018
         BNO   RETURN                   NO IGNORE THIS REQUEST      MCS 51000018
         B     PMIOC                    CHECK ON IO COMPLETED       MCS 51300018
*                                       ERROR CHECK LOGIC           MCS 51600018
PMERRCK  EQU   *                                                    MCS 51900018
********************************************************************MCS 52200018
         BAL   X3,PMFREEB              FREE THE INPUT BUFFER IN ERR MCS 52500018
         MVI   CSACODE,ZEROBYTE        INDICATE CONSOLE SWITCH      MCS 52800018
         MVC   CSANAME,PMXTRNL         NAME OF AUTO SW RTN          MCS 53100018
         B     PMGONE                  GO XCTL TO IT                MCS 53400018
*        BAL   X3,INPUT BUFFER FREEING  FREE INPUT BUFFER           MCS 53700018
*              NEEDS TO BE DONE HERE IF THIS RTN IS TO XCTL         MCS 54000018
*              OUT OF  THIS ROUTINE                                 MCS 54300018
********************************************************************MCS 54600018
         EJECT                                                          54900018
         DS    0H                                                       55200018
PMIOC    EQU   *                                                        55500018
         NI    UCMDEVC,NUM255-UCMDEVE  TURN OFF I/O COMPLETE FLAG   MCS 55800018
         SR    X1,X1                   SAVE LENGTH OF IOB         M4450 55900019
         IC    X1,DCBIOBL               OVER STORE OF SYNAD ADDR  M4450 56000019
         LA    X7,PMERRCK              SET SYNAD EXIT.                  56100018
         ST    X7,DCBSYNAD                                              56400018
         LA    X7,PMFREEB              SET EODAD EXIT (IGNORE).         56700018
         ST    X7,DCBEODAD                                              57000018
         STC   X1,DCBIOBL              RESTORE IOB LENGTH         M4450 57100019
         LA    X1,DMDECB               CHECK PREV-IOS OPERATION.        57300018
         CHECK (1)                                                      57600018
         SPACE 2                                                        57900018
         XC    PMECB,PMECB              CLEAR ECB.                      58200018
*                                      GIVE IT TO COMMAND HANDLER.      58500018
PMMGCR   EQU   *                                                        58800018
         LA    X1,F84                  MGCR COUNT.                      59100018
         STH   X1,WQENBR               LENGTH TO HEADER                 59400018
         LA    X1,WQENBR               GET ADDR OF COUNT FIELD          59700018
         SR    X0,X0                   ZERO ZERO                    MCS 60000018
         IC    X0,UCMID                INSERT UCM ID                MCS 60300018
         SVC   THRTYFOR                SVC 34                           60600018
         LA    X3,PMAPF                                             MCS 60900018
         SPACE                                                          61200018
PMFREEB  EQU   *                                                        61500018
         NI    UCMSTS,NUM255-UCMBF     NO LONGER BUSY.                  61800018
         USING PMUCM,X1                                                 62100018
         L     X1,CSACTLM               UCM ADDRESS                   P 62400018
         TM    WQEAVAIL,GETMBUFF       BUFFER THRU GETMAIN/FIXED MODE   62700018
         BO    PMRLSE                   YES. DO FREEMAIN.               63000018
         TM    UCMMODE,UCMFIX          IS THIS FIXED BUFFER MODE      P 63300018
         BO    PMCEND4                  YES. DON'T ISSUE FREEMAIN     P 63600018
PMRLSE   EQU   *                                                        63900018
         LR    X1,X8               PTS TO DISCARDED BUFFER         263  64200018
      FREEMAIN R,SP=255,LV=L'WQEXTNT,A=(1)                              64500018
PMCEND4  EQU   *                                                      P 64800018
         DROP  X1                                                       65100018
         TM    UCMSTS,UCMCF            TO BE CLOSED                 MCS 65400018
         BO    PMCF                     YES                         MCS 65700018
         BR    X3                       RETURN TO CALLER(NSI OR ERR)MCS 66000018
         EJECT                                                          66300018
PMAPF    EQU   *                                                        66600018
         TM    UCMSTS,UCMAF+UCMTA  OUTSTANDING ACTION               MCS 66900018
         BZ    RETURN                  NO                           MCS 67200018
         TM    UCMSTS,UCMOPF            IS OPEN STILL PENDING       MCS 67500018
         BNO   PMAF                     NO WE ARE OPEN              MCS 67800018
         MVI   CSACODE,CSAOPEN         NO, SET CODE.                    68100018
         B     PMCLOPN                 GO TO OPEN.                      68400018
PMAF     EQU   *                                                        68700018
         SPACE 2                                                        69000018
PMINPUT  EQU   *                                                        69300018
         SSM   PMENABLE                NEED NOT PREVENT INTERRUPTS.     69600018
         NI    UCMSTS,NUM255-UCMAF     ATTENTION SATISFIED.             69900018
*                                      GET A BUFFER.                    70200018
         USING PMUCM,X1                                                 70500018
         L     X1,CSACTLM               UCM ADDRESS                   P 70800018
         TM    UCMMODE,UCMFIX          IS THIS FIXED BUFFER MODE      P 71100018
         BO    PMCFIX5                  YES. USE FIXED INPUT AREA     P 71400018
       GETMAIN R,SP=255,LV=L'WQEXTNT                                    71700018
         LR    X8,X1                    SET BASE                        72000018
         MVI   WQEAVAIL,HEX50          GETMAIN INDICATOR                72300018
         B     PMCEND5                 TO DO I/O                        72600018
PMCFIX5  LA    X8,UCMINPUT             ADDRESS FIXED INPUT BUFFER   MCS 72900018
         MVI   WQEAVAIL,BUFFUSE        FIXED BUFFER INDICATION          73200018
PMCEND5  EQU   *                                                      P 73500018
         DROP  X1                                                       73800018
         ST    X8,DMX                  CURRENT BUFFER PTR.              74100018
         MVI   DMX,DMXR                CURRENT OPERATION CODE.          74400018
         LA    X2,WQETXT               BUFFER ADDRESS.                  74700018
         MVI   WQETXT,BLANK            START WITH BLANK                 75000018
         MVC   WQETXT+ONE(L'WQETXT-ONE),WQETXT    BUFFER.               75300018
         SPACE 2                                                        75600018
PMEXCP   EQU   *                                                        75900018
         OI    UCMSTS,UCMBF            ITS BUSY NOW.                    76200018
         SPACE                                                          76500018
         LA    X1,DMDECB                                                76800018
         READ  (1),SF,(9),(2),'S',MF=E                                  77100018
         SPACE                                                          77400018
         B     RETURN                   RETURN                      MCS 77700018
         SPACE                                                          78000018
         DS    0D                                                       78300018
PMXTRNL  DC    CL8'IGCXL07B'      EXTERNAL PROCESSOR NAME.              78600018
PMROUTER DC    CL8'IGC0007B'      ROUTER NAME, FIRST LEG.               78900018
PMCFNAME DC    CL8'IGC1I07B'           2540 OPEN/CLOSE MODULE NAME.     79200018
PMENABLE DC    X'FF'                   ENABLING MASK.                   79500018
         TITLE 'PMX   CXSA'                                             79800018
PMXSA    DSECT                                                          80100018
         IEECVMUG CXSA                                                  80400018
         TITLE 'PMX   WQE'                                              80700018
PMWQE    DSECT                                                          81000018
         IEECVMUG WQE                                                   81300018
         TITLE 'PMX   UCM'                                              81600018
PMUCM    DSECT                                                          81900018
         IEECUCM                                                        82200018
         TITLE 'PMX   DCB,IOB,CCW'                                      82500018
         IEEUCDC  MAP                                                   82800018
PMECB    EQU   DMDECB              ACTIVE I/O COMPLETION ECB.           83100018
         CSECT                                                          83400018
         END   IEECVPM                                                  83700018
