         TITLE ' VMS CONSOLE I/O ROUTINE.'                              00020000
*********************************************************************** 00040000
*                                                                       00060000
*                                                                       00080000
* NAME         IEECVPM  COMMUNICATION TASK PROCESS MODULE (PM).         00100000
*                       ACCESS METHOD  BSAM (2540).                     00120000
*                                                                       00140000
*                                                                       00160000
* FUNCTION         THE PURPOSE OF THIS MODULE IS TO MANAGE THE          00180000
*                  INTERFACES WITH IOS AND DATA MANAGEMENT REQUIRED     00200000
*                  FOR I/O ACTIVITY ON A DEVICE SUPPORTED AS A CONSOLE. 00220000
*                  THERE ARE 5 PRIMARY SERVICES PERFORMED..             00240000
*                                                                       00260000
*                                                                       00280000
*                       1. INTERCEPTS CLOSE REQUEST, QUIESES I/O        00300000
*                          DISPOSES OF BUFFER, AND XCTL S TO CLOSE      00320000
*                          MODULE.                                      00340000
*                                                                       00360000
*                       2. INTERCEPTS UNOPENED CONDITION AND XCTL S TO  00380000
*                          OPEN MODULE.                                 00400000
*                                                                       00420000
*                       3. INITIATES I/O ACTIVITY.                      00440000
*                                                                       00460000
*                       4. RESPONDS TO I/O COMPLETION CONDITIONS,       00480000
*                          INCLUDING I/O ERROR CONDITIONS, AND          00500000
*                          RE-INITIATION OF I/O.                        00520000
*                                                                       00540000
*                       5. MANAGES ACQUISITION AND DISPOSITION OF       00560000
*                          BUFFERS.                                     00580000
*                                                                       00600000
*                                                                       00620000
* INPUT            REG 1 POINTS TO PARAMETER LIST MAPPED BY CXSA.       00640000
*                  LIST INCLUDES POINTERS TO THE UCM MODULE, AND THE    00660000
*                  ACTIVE UCM ENTRY.                                    00680000
*                                                                       00700000
*                                                                       00720000
* OUTPUT           UNIT STATUS IN THE UCM ENTRY.                        00740000
*                                                                       00760000
*                                                                       00780000
* EXTERNAL REF.    DCBD                                                 00800000
*                  WAIT                                                 00820000
*                  XCTL                                                 00840000
*                  UCM                                                  00860000
*                  IEECVCTR, ROUTER                                     00880000
*                  IEECVOC , OPEN/CLOSE MODULE.                         00900000
*                  CXSA                                                 00920000
*                  GETMAIN                                              00940000
*                  FREEMAIN                                             00960000
*                  IEECVCTX, EXTERNAL PROCESS MODULE.                   00980000
*                                                                       01000000
*                                                                       01020000
* EXITS            ALWAYS BY XCTL...                                    01040000
*                  TO OPEN/CLOSE MODULE FOR RESPECTIVE FUNCTION.        01060000
*                  TO EXTERNAL PROCESSOR AFTER CLOSE REQUEST TO         01080000
*                  NEVER OPENED ENTRY.                                  01100000
*                  TO ROUTER NORMALLY.                                  01120000
*                                                                       01140000
*                                                                       01160000
* TABLES           UCM                                                  01180000
*                  DCB                                                  01200000
*                  CXSA                                                 01220000
*                  WQE                                                  01240000
*                                                                       01260000
*                                                                       01280000
* OPERATION        1. IF CLOSE REQUEST NOT PENDING, TESTS BUSY.         01300000
*                     TO CLOSE, CHECKS IF OPEN, THEN QUIESES I/O AND    01320000
*                     DISPOSES OF BUFFER. XCTL S TO CLOSE MODULE.       01340000
*                                                                       01360000
*                  2. IF NOT BUSY, TESTS REQUEST FLAGS.                 01380000
*                     IF BUSY, CHECKS FOR I/O COMPLETE. IF NOT FINISHED 01400000
*                     RETURNS TO ROUTER. IF FINISHED, ERROR CHECKS      01420000
*                     OPERATION, DISPOSES OF BUFFER, AND TESTS REQUEST  01440000
*                     FLAGS.                                            01460000
*                                                                       01480000
*                  3. IF REQUESTS FLAGS NOT PENDING, RETURNS TO ROUTER. 01500000
*                     IF NOT OPEN, EXIT TO OPEN/CLOSE MODULE, OTHERWISE 01520000
*                     ACQUIRES BUFFER AND INITIATES I/O. THEN RETURNS   01540000
*                     TO ROUTER.                                        01560000
*                                                                       01580000
*                                                                       01600000
*                  4. BUFFER HANDLING (2540, BSAM)                      01620000
*                                                                       01640000
*                       BUFFERS ARE ACQUIRED AND FREED DYNAMICALLY.     01660000
*                       THEY ARE SUBMITTED TO COMMAND SCHEDULERS FOR    01680000
*                       PROCESSING WITH MGCR (SVC 34).                  01700000
*                                                                       01720000
*                  5. ERRORS.                                           01740000
*                       UNCORRECTABLE I/O ERROR RESULT IN A MESSAGE,    01760000
*                       USING WTO, AND A RETURN TO THE ROUTER.          01780000
*                                                                       01800000
*                                                                       01820000
*                                                                       01840000
* COMMENT          THIS MODULE WILL SERVE AND INDEFINITE NUMBER OF      01860000
*                  UCM ENTRIES.                                         01880000
*                                                                       01900000
*                  ACCESS INTER-LOCKS, AS REQUIRED, ARE IMPOSED BY      01920000
*                  DISABLING THE MACHINE. NORMALLY THIS ROUTINE MAY     01940000
*                  RUN ENABLED, PRIVILEGED, WITH PROTECTION KEY=0.      01960000
*                                                                       01980000
*                                                                       02000000
*********************************************************************** 02020000
IEECVPM  CSECT                                                          02040000
*               IOB LENGTH IN DCB                                 M4450 02045019
*1241055400-055600,056200                                          000A 02050015
X0       EQU   0             SYSTEM INTERFACING.                        02060000
X1       EQU   1             SYSTEM INTERFACING.                        02080000
X2       EQU   2             SCRATCH.                                   02100000
X3       EQU   3             SCRATCH.                                   02120000
X4       EQU   4             SCRATCH.                                   02140000
X5       EQU   5             LM-BXLE                                    02160000
X6       EQU   6              INDEXING                                  02180000
X7       EQU   7              TRIO,AND SCRATCH.                         02200000
X8       EQU   8             QUEUE ELEMENT BASE (WQE).                  02220000
X9       EQU   9             DCB BASE.                                  02240000
XA       EQU   10            UCM ENTRY BASE.                            02260000
XB       EQU   11            CXSA PTR.                                  02280000
XC       EQU   12            THIS PROGRAM BASE.                         02300000
XD       EQU   13            SAVE AREA BASE.                            02320000
XE       EQU   14            EXIT PTR.                                  02340000
XF       EQU   15            SYSTEM INTERFACING.                        02360000
         BALR  XC,0                    BASE                             02380000
         USING *,XC                    THIS PROGRAM.                    02400000
         LR    XB,X1                                                    02420000
         USING PMXSA,XB                                                 02440000
         ST    14,CSAXA                SAVE RETURN REG.                 02460000
         L     XA,CSAUCM               BASE UCM ENTRY.                  02480000
         USING UCMLIST,XA                                               02500000
         L     X9,UCMDCB               BASE DCB                         02520000
         USING IHADCB,X9                                                02540000
         L     X8,DMX                  ACTIVE BUFFER PTR.               02560000
         LA    X8,0(X8)                KILL HIGH BYTE.                  02580000
         USING PMWQE,X8                                                 02600000
*                                      REGISTER SAVING.                 02620000
         USING PMUCM,XD                                                 02640000
         L     XD,CSACTLM               UCM ADDRESS                   P 02660000
         TM    UCMMODE,UCMFIX           FIXED BUFFER MODE?            P 02680000
         BO    PMCFIX                   YES. SKIP SAVE AREA GETMAIN   P 02700000
       GETMAIN R,SP=255,LV=72                                           02720000
         B     PMCEND                                                 P 02740000
PMCFIX   LA    X1,UCMSAVE1             ADDRESS FIXED SAVE AREA.         02760000
PMCEND   EQU   *                                                      P 02780000
         DROP  XD                                                       02800000
         LR    XD,X1                                                    02820000
         SSM   PMENABLE                MUST BE ENABLED FOR WAITS.       02840000
         EJECT                                                          02860000
PMCF     EQU   *                                                        02880000
         TM    UCMSTS,UCMCF            Q. CLOSE REQUEST.                02900000
         BZ    PMBF                    NO.                              02920000
*                                      SECURE BUFFER FOR CLOSE.         02940000
         LTR   X9,X9                   Q. OPEN.                         02960000
         BNE   PMBFCK                  YES                              02980000
         MVC   CSANAME,PMXTRNL         NEVER OPENED                     03000000
         B     PMGONE                  NO CLOSE.                        03020000
PMBFCK   EQU   *                                                        03040000
         TM    UCMSTS,UCMBF            Q. BUSY.                         03060000
         BZ    PMCLOSE                 CLOSE.                           03080000
*                                      I/O QUIESCE.                     03100000
         WAIT  ECB=PMECB                                                03120000
         B     PMOK                    FREE ANY INPUT BUFFER            03140000
PMCLOSE  EQU   *                                                        03160000
         NI    UCMSTS,255-UCMCF        CF=OFF.                          03180000
         MVI   CSACODE,CSACLOSE        LOCAL CLOSE CODE.                03200000
PMCLOPN  EQU   *                                                        03220000
         MVC   CSANAME,PMCFNAME        XCTL OPEN/CLOSE MODULE NAME.     03240000
         SPACE                                                          03260000
PMGONE   EQU   *                                                        03280000
*                                      RELEASE SAVE AREA.               03300000
         USING PMUCM,X1                                                 03320000
         L     X1,CSACTLM               UCM ADDRESS                   P 03340000
         TM    UCMMODE,UCMFIX           FIXED BUFFER MODE?            P 03360000
         BO    PMCEND2                  YES. DON'T FREE SAVE AREA     P 03380000
         LR    X1,XD                                                    03400000
      FREEMAIN R,SP=255,LV=72,A=(1)                                     03420000
PMCEND2  EQU   *                                                      P 03440000
         DROP  X1                                                       03460000
         L     14,CSAXA                RESTORE RETURN REG.              03480000
         LR    X1,XB                   CXSA PTR PASSING.                03500000
         LR    XF,XB                   PRE-SET 15.                      03520000
         XCTL  SF=(E,(15))                                              03540000
         EJECT                                                          03560000
PMBF     EQU   *                                                        03580000
         TM    UCMSTS,UCMBF            Q. BUSY.                         03600000
         BZ    PMAPF                   NO.                              03620000
*                                  Q. I/O COMPLETE.                     03640000
         TM    PMECB,X'40'                                              03660000
         BO    PMIOC                   YES.                             03680000
*                                      NO, IGNORE THIS REQUEST.         03700000
PMEXIT   EQU   *                       RE-TRY ROUTER.                   03720000
         MVC   CSANAME,PMROUTER        XCTL NAME INSERTION.             03740000
         B     PMGONE                                                   03760000
*                                      ERROR CHECK LOGIC.               03780000
PMERRCK  EQU   *                                                        03800000
*                            ERROR ANALYSIS.                            03820000
         LR    X5,XE                    SAVE DM RETURN.                 03840000
*                                      SPACE FOR A MESSAGE.             03860000
         USING PMUCM,X1                                                 03880000
         L     X1,CSACTLM               UCM ADDRESS                   P 03900000
         TM    UCMMODE,UCMFIX           FIXED BUFFER MODE?            P 03920000
         BZ    PMCVAR3                  NO. DO GETMAIN FOR ERROR MSG. P 03940000
         LA    1,PMMSGA                 ELSE USE FIXED MSG.AREA       P 03960000
         SVC   35                                                     P 03980000
         B     PMCEND3                                                P 04000000
PMCVAR3  EQU   *                                                      P 04020000
       GETMAIN R,SP=255,LV=PMMSG                                        04040000
         LR    X7,X1                   SAVE LOCATION.                   04060000
         MVC   0(PMMSG,X7),PMMSGA      INSERT PRE-FORMATTED TEXT.       04080000
         L     X6,UCMUCB               UCB PTR.                         04100000
         MVC   12(3,X7),13(X6)         INSERT UCB NAME.                 04120000
         WTO   MF=(E,(1))                                               04140000
         LR    X1,X7                   RELEASE MESSAGE CORE.            04160000
      FREEMAIN R,SP=255,LV=PMMSG,A=(1)                                  04180000
PMCEND3  EQU   *                                                      P 04200000
         DROP  X1                                                       04220000
         LA    X3,PMFREEB               IGNORE ERROR INPUT.             04240000
         ST    X3,CSANAME                                               04260000
*                                       RETURN TO DM TO CONTINUE.       04280000
         LR    XE,X5                                                    04300000
         RETURN                                                         04320000
         SPACE                                                          04340000
PMMSGA   WTO   'IEECV2I      CONSOLE PERM. ERR.',MF=L                   04360000
PMMSG    EQU   *-PMMSGA                                                 04380000
         EJECT                                                          04400000
         DS    0H                                                       04420000
PMIOC    EQU   *                                                        04440000
         LA    X3,PMOK                  ASSUME NO SYNAD EXIT.           04460000
         ST    X3,CSANAME                                               04480000
         SR    X1,X1                   SAVE LENGTH OF IOB         M4450 04486019
         IC    X1,DCBIOBL               OVER STORE OF SYNAD ADDR  M4450 04492019
         LA    X7,PMERRCK              SET SYNAD EXIT.                  04500000
         ST    X7,DCBSYNAD                                              04520000
         LA    X7,PMFREEB              SET EODAD EXIT (IGNORE).         04540000
         ST    X7,DCBEODAD                                              04560000
         STC   X1,DCBIOBL              RESTORE IOB LENGTH         M4450 04570019
         LA    X1,DMDECB               CHECK PREV-IOS OPERATION.        04580000
         CHECK (1)                                                      04600000
         SPACE 2                                                        04620000
         XC    PMECB,PMECB              CLEAR ECB.                      04640000
         L     X3,CSANAME                                               04660000
         BR    X3                       Q. AFTER SYNAD EXIT.            04680000
PMOK     EQU   *                                                        04700000
*                                      GIVE IT TO COMMAND HANDLER.      04720000
PMMGCR   EQU   *                                                        04740000
         LA    X1,84                   MGCR COUNT.                      04760000
         STH   X1,WQENBR               LENGTH TO HEADER                 04780000
         LA    1,WQENBR                                                 04800000
         SR    X0,X0              CLEAR REG 0 FOR SVC            A40671 04810021
         SVC   34                                                       04820000
         SPACE                                                          04840000
PMFREEB  EQU   *                                                        04860000
         NI    UCMSTS,255-UCMBF        NO LONGER BUSY.                  04880000
         USING PMUCM,X1                                                 04900000
         L     X1,CSACTLM               UCM ADDRESS                   P 04920000
         TM    WQEAVAIL,X'10'           BUFFER THRU GETMAIN?/FIXED MODE 04940000
         BO    PMRLSE                   YES. DO FREEMAIN.               04960000
         TM    UCMMODE,UCMFIX           FIXED BUFFER MODE?            P 04980000
         BO    PMCEND4                  YES. DON'T ISSUE FREEMAIN     P 05000000
PMRLSE   EQU   *                                                        05020000
         LR    X1,X8               PTS TO DISCARDED BUFFER         263  05040000
      FREEMAIN R,SP=255,LV=L'WQEXTNT,A=(1)                              05060000
PMCEND4  EQU   *                                                      P 05080000
         DROP  X1                                                       05100000
         TM    UCMSTS,UCMCF                                             05120000
         BO    PMCLOSE                                                  05140000
         EJECT                                                          05160000
PMAPF    EQU   *                                                        05180000
         TM    UCMSTS,UCMAF            Q. PENDING REQUEST.              05200000
         BZ    PMEXIT                  NO.                              05220000
         LTR   X9,X9                   ARE WE                           05240000
         BNE   PMAF                    OPEN.                            05260000
         MVI   CSACODE,CSAOPEN         NO, SET CODE.                    05280000
         B     PMCLOPN                 GO TO OPEN.                      05300000
PMAF     EQU   *                                                        05320000
         SPACE 2                                                        05340000
PMINPUT  EQU   *                                                        05360000
         SSM   PMENABLE                NEED NOT PREVENT INTERRUPTS.     05380000
         NI    UCMSTS,255-UCMAF        ATTENTION SATISFIED.             05400000
*                                      GET A BUFFER.                    05420000
         USING PMUCM,X1                                                 05440000
         L     X1,CSACTLM               UCM ADDRESS                   P 05460000
         TM    UCMMODE,UCMFIX           FIXED BUFFER MODE?            P 05480000
         BO    PMCFIX5                  YES. USE FIXED INPUT AREA     P 05500000
       GETMAIN R,SP=255,LV=L'WQEXTNT                                    05520000
         LR    X8,X1                    SET BASE                        05530015
         MVI   WQEAVAIL,X'50'           GETMAIN INDICATION              05540015
         B     PMCEND5                                                  05550015
PMCFIX5  LA    X8,UCMREAD               ADDRESS FIXED INPUT BUFFER      05560015
         MVI   WQEAVAIL,X'40'           FIXED BUFFER INDICATION         05570015
PMCEND5  EQU   *                                                      P 05580000
         DROP  X1                                                       05600000
         ST    X8,DMX                  CURRENT BUFFER PTR.              05640000
         MVI   DMX,DMXR                CURRENT OPERATION CODE.          05660000
         LA    X2,WQETXT               BUFFER ADDRESS.                  05680000
         MVI   WQETXT,X'40'                  START WITH BLANK           05700000
         MVC   WQETXT+1(L'WQETXT-1),WQETXT  BUFFER.                     05720000
         SPACE 2                                                        05740000
PMEXCP   EQU   *                                                        05760000
         OI    UCMSTS,UCMBF            ITS BUSY NOW.                    05780000
         SPACE                                                          05800000
         LA    X1,DMDECB                                                05820000
         READ  (1),SF,(9),(2),'S',MF=E                                  05840000
         SPACE                                                          05860000
         B     PMEXIT                                                   05880000
         SPACE                                                          05900000
         DS    0D                                                       05920000
PMXTRNL  DC    CL8'IGCXL07B'      EXTERNAL PROCESSOR NAME.              05940000
PMROUTER DC    CL8'IGC0007B'      ROUTER NAME, FIRST LEG.               05960000
PMCFNAME DC    CL8'IGC1I07B'           2540 OPEN/CLOSE MODULE NAME.     05980000
PMENABLE DC    X'FF'                   ENABLING MASK.                   06000000
         TITLE 'PMX   CXSA'                                             06020000
PMXSA    DSECT                                                          06040000
         IEECVMUG CXSA                                                  06060000
         TITLE 'PMX   WQE'                                              06080000
PMWQE    DSECT                                                          06100000
         IEECVMUG WQE                                                   06120000
         TITLE 'PMX   UCM'                                              06140000
PMUCM    DSECT                                                          06160000
         IEECUCM                                                        06180000
         TITLE 'PMX   DCB,IOB,CCW'                                      06200000
         IEEUCDC  MAP                                                   06220000
PMECB    EQU   DMDECB              ACTIVE I/O COMPLETION ECB.           06240000
         CSECT                                                          06260000
         END   IEECVPM                                                  06280000
