 TITLE  'IHKCBUID - USERID COMMAND '                                    00600015
IHKCBUID CSECT                                                          01200015
*                                                                     * 01800015
*STATUS.                                                              * 02400015
*   CHANGE LEVEL 0                                                    * 03000015
*                                                                     * 03600015
*FUNCTION/OPERATION.                                                  * 04200015
*   THIS ROUTINE ADDS OR DELETES USERS FROM THE USER DIRECTORY. THE   * 04800015
*   COMMAND CAN BE SUBMITTED ONLY AT THE CENTRAL. ALL MESSAGES ORIGIN-* 05400015
*   ATING IN IHKCBUID ARE RETURNED TO THE CENTRAL CONSOLE. IF THE     * 06000015
*   COMMAND IS AN ADDITION, THE USER ID AND PROTECTION KEY ARE        * 06600015
*   INSERTED INTO AN EMPTY ENTRY, AND AN 'ADDED TO USER DIRECTORY'    * 07200015
*   MESSAGE IS SENT. IF THE USER DIRECTORY HAS NO EMPTY ENTRIES, A    * 07800015
*   'USER DIRECTORY FULL' MESSAGE IS RETURNED, AND NO FURTHER ACTION  * 08400015
*   IS TAKEN.                                                         * 09000015
*   IF THE COMMAND IS A DELETION, ALL FIELDS OF THE ENTRY ARE FILLED  * 09600015
*   WITH BLANKS EXCEPT FOR THE TTR POINTER. THE STATUS BYTE IS THEN   * 10200015
*   CLEARED TO ZERO, AND A 'DELETED FROM USER DIRECTORY' MESSAGE IS   * 10800015
*   SENT. IF THE COMMAND HAS A USER ID WHICH IS FOUND IN THE USER     * 11400015
*   DIRECTORY BUT THE PROTECTION KEYS DO NOT MATCH, THEN AN 'INVALID  * 12000015
*   PROTECTION KEY' MESSAGE IS RETURNED.                              * 12600015
*   FOR VALID ADDITIONS AND DELETIONS, ONCE THE ENTRIES ARE REVISED,  * 13200015
*   THE NEW VERSION IS WRITTEN TO DISK.                               * 13800015
*                                                                     * 14400015
*ENTRY POINTS.                                                        * 15000015
*        IHKCBUID IS THE ONLY ENTRY POINT. THE CALLING SEQUENCE IS-   * 15600015
*                                                                     * 16200015
*        LOAD  EP=IHKCBUID                                            * 16800015
*        LR    15,0                                                   * 17400015
*        LA    1,PARAMETER LIST                                       * 18000015
*        BALR  14,15                                                  * 18600015
*        DELETE EP=IHKCBUID                                           * 19200015
*                                                                     * 19800015
*INPUT.                                                               * 20400015
*   REGISTER ONE POINTS TO A PARAMETER LIST WHICH HAS THE FORMAT-     * 21000015
*        BYTES      CONTENTS                                          * 21600015
*        0-79       CARD IMAGE OF USERID COMMAND                      * 22200015
*        80         U                                                 * 22800015
*        81-83      USER ID                                           * 23400015
*        84-86      PROTECTION KEY                                    * 24000015
*        87-94      BLANK                                             * 24600015
*                                                                     * 25200015
*OUTPUT.                                                              * 25800015
*   AN APPROPRIATE SYSTEM MESSAGE IS SENT TO THE CENTRAL OPERATOR. IF * 26400015
*   THE COMMAND IS VALID THE ADDITION OF DELETION IS PERFORMED AND THE* 27000015
*   UPDATED CORE VERSION IS WRITTEN TO DISK.                          * 27600015
*                                                                     * 28200015
*EXTERNAL ROUTINES.                                                   * 28800015
*        IHKCCSUD - SEARCHES THE USER DIRECTORY ON THE USER ID.       * 29400015
*        IHKCDUMR - WRITES THE UPDATED ENTRY TO DISK.                 * 30000015
*        IHKCBLDM - ENQUEUES SYSTEM MESSAGES TO CENTRAL OPERATOR.     * 30600015
*                                                                     * 31200015
*EXITS-NORMAL.                                                        * 31800015
*   RETURN TO CALLING PROGRAM.                                        * 32400015
*                                                                     * 33000015
*EXITS-ERROR.                                                         * 33600015
*   N/A                                                               * 34200015
*                                                                     * 34800015
*ATTRIBUTES.                                                          * 35400015
*   SERIALLY REUSABLE AND NON-RESIDENT.                               * 36000015
*                                                                     * 36600015
*NOTES.                                                               * 37200015
*   N/A                                                               * 37800015
*                                                                     * 38400015
*                                                                     * 39000015
*                        GENERAL REGISTER UTILIZATION                 * 39600015
*                                                                     * 40200015
*                                                                     * 40800015
R0       EQU   0         PARAMETER PASSING                              41400015
R1       EQU   1         PARAMETER PASSING                              42000015
R2       EQU   2         POINTER TO INPUT (EXTENDED CARD IMAGE)         42600015
R3       EQU   3                                                        43200015
R4       EQU   4         MESSAGE OFFSET FOR BUILD MESSAGE               43800015
R5       EQU   5         LENGTH OF MESSAGE TEXT FOR BUILD MESSAGE       44400015
R6       EQU   6                   POINTER TO INPUT PARAMETER LIST      45000015
R11      EQU   11        SAVE AREA POINTER                              45600015
R12      EQU   12        BASE REGISTER                                  46200015
R13      EQU   13        SAVE AREA POINTER                              46800015
R14      EQU   14        RETURN POINT                                   47400015
R15      EQU   15        ENTRY POINT                                    48000015
         SAVE  (14,12)             SAVE REGISTERS                       48600015
         BALR  R12,R0                                                   49200015
         USING *,R12               SET UP ADDRESSABILITY                49800015
         LA    R11,SAVE                                                 50400015
         ST    R11,8(R13)          SET UP SAVE AREAS FOR TRACE          51000015
         ST    R13,4(R11)                                               51600015
         LR    R13,R11             ADDRESS OF IHKCBRJS SAVE AREA        52200015
         LR    R6,R1                                                    52800015
         L     R2,4(R6)  SAVE POINTER TO CARD IMAGE                     53400015
         MVC   PARM3+1(3),81(R2)                                        54000015
         L     R1,PARM3+1                                               54600015
         L     R15,44(R6)          ADDRESS OF IHKCCSUD                  55200015
         BALR  R14,R15             SEARCH USER DIRECTORY FOR USER'S     55800015
*                                  ENTRY                                56400015
         LTR   R1,R1               WAS USER ENTRY FOUND                 57000015
         BE    ADD                 IF NOT REQUEST IS AN ADDITION        57600015
         CLI   87(R2),C'D'         ADD OR DELETE                        58200015
         BNE   BADUSID             IF ADD    RETURN INVALID MESSAGE     58800015
         CLC   12(3,R1),84(R2)     IF FOUND COMPARE PROTECTION KEYS     59400015
         BNE   INVALID             IF KEYS NOT EQUAL, RETURN ERROR CODE 60000015
         MVI   0(R1),X'40'         IF EQUAL, FREE USER DIRECTORY ENTRY  60600015
         MVC   1(14,R1),0(R1)      BY  ZEROING OUT ENTRY.               61200015
         MVI   8(R1),X'00'         ZERO STATUS BYTE                     61800015
         LA    R4,14               MESSAGE OFFSET                       62400015
         B     UPDATE                                                   63000015
ADD      CLI   87(R2),C'A'         ADD OR DELETE                        63600015
         BNE   BADUSID             IF DELETE RETURN INVALID MESSAGE     64200015
         L     R1,BLANK            SET UP SEARCH FOR EMPTY USER ENTRY   64800015
         BALR  R14,R15             SEARCH FOR EMPTY ENTRY               65400015
         LTR   R1,R1               EMPTY ENTRY FOUND                    66000015
         BE    FULL                IF NOT SEND DIRECTORY FULL MESSAGE   66600015
         MVC   9(6,R1),81(R2)      IF FOUND INSERT USERID AND KEY       67200015
         LA    R4,26               MESSAGE OFFSET                       67800015
UPDATE   L     R15,52(R6)          ADDRESS OF IHKCDUMR                  68400015
         BALR  R14,R15             WRITE UPDATED USER ENTRY ON DISK     69000015
PREMSG   LA    R5,7                LENGTH                               69600015
         MVC   PARM3(3),81(R2)     USER ID                              70200015
         MVI   PARM3+3,C' '        BLANK                                70800015
         MVC   PARM3+4(3),84(R2)   KEY                                  71400015
BUILDMSG STH   R4,PARM1                                                 72000015
         STC   R5,PARM2                                                 72600015
         LA    R1,PARM                                                  73200015
         L     R15,20(R6)          ADDRESS OF IHKCBLDM                  73800015
         BALR  R14,R15             ENQUEUE MESSAGE                      74400015
         L     R13,SAVE+4                                               75000015
         RETURN (14,12),T,RC=0                                          75600015
FULL     LA    R4,35               MESSAGE OFFSET                       76200015
         B     PREMSG                                                   76800015
BADUSID  LA    R4,1                MESSAGE OFFSET                       77400015
         B     PREERROR                                                 78000015
INVALID  LA    R4,2                MESSAGE OFFSET                       78600015
PREERROR LA    R5,15                                                    79200015
         MVC   PARM3(6),=C'USERID' COMMAND                              79800015
         MVC   PARM3+6(9),71(R2)   SEQUENCE NUMBER                      80400015
         B     BUILDMSG                                                 81000015
*                                                                     * 81600015
*   CONSTANTS                                                         * 82200015
*                                                                     * 82800015
SAVE     DS    18F                 SAVE AREA                            83400015
BLANK    DC    C'    '             BLANKS FOR SEARCH IN ADD             84000015
PARM     DC    F'0'                TERMINAL DESTINATION                 84600015
PARM1    DS    H                   MESSAGE OFFSET                       85200015
PARM2    DS    C                   LENGTH                               85800015
PARM3    DS    CL15                MESSAGE TEXT                         86400015
*                                  PARAMETERS FOR BUILDMSG - IHKCBLDM   87000015
         END                                                            87600015
