Table of Contents

DMKALG Abstract

Statistics

Type ASSEMBLE
Source Lines : 278
Fixes Applied : 4
Most Recent Version : Thursday, December 7, 1978
Last Fix ID : [HRC101DK]

Synopsis

Function

       PROCESS THE AUTOLOG COMMAND - A COMMAND WHICH CAUSES
       ONE USER TO BE LOGGED ON BY ANOTHER

Attributes

       REENTRANT, PAGEABLE, CALLED VIA SVC

Operation

       THE FOLLOWING ROUTINE WILL ATTEMPT TO LOGON ANOTHER
       USER AND PLACE HIM IN DISCONNECTED STATE.  ANY DATA
       ON THE COMMAND LINE BEYOND THE PASSWORD WILL BE PASSED
       AS A COMMAND TO SATISFY THE FIRST VIRTUAL MACHINE
       CONSOLE READ.  GENERAL STEPS TAKEN IN THIS PROCESS
       INCLUDE THE FOLLOWING:

       FROM DMKALG, CALL DMKBLD TO GET A NEW VMBLOK; THEN
       CALL DMKLOGB TO
       REQUEST THE USER BE LOGGED ON.  ANY LOG ERROR MESSAGES
       (AS OPPOSED TO LNK) RESULTING FROM THIS PROCESS WILL
       BE SENT TO THE USER WHO ISSUED THE AUTOLOG COMMAND.
       ALL OTHER ERROR MESSAGES WILL BE SENT TO THE NEW
       USER.

       ON RETURN FROM DMKLOGB, DMKALG WILL CHECK FOR ERRORS.
       IF AN ERROR RESULTED, DMKUSO WILL BE CALLED TO GET
       RID OF THE ILL FATED AUTOLOGGED USER.  IF THE ERROR
       WAS DUE TO A BAD PASSWORD, CONTROL IS PASSED TO THE
       PASSWORD COUNT ROUTINE IN COMMON CODE.  THIS COMMON
       CODE KEYS OFF OF THE AUTOLOG BIT AND THE VMVIRCF BIT.
       THE AUTOLOG BIT IS SET BY DMKALG, DMKLOGB AND
       DMKLOGOP. THE VMVIRCF BIT WILL NEVER BE SEEN HERE
       FOR AN AUTOLOGGED USER; IT MAY BE ON FOR THE COMMAND
       ISSUING USER.

       IF NO ERROR OCCURRED, PROCEED TO HANDLE THE FIRST
       COMMAND BUFFER, TWIDDLE BITS TO LET THE NEW USER RUN,
       CALL DMKSCHDL FOR THE SAME REASON AND, NOW THAT IT
       WORKED OK, RESET THE BAD PASSWORD COUNT.

       NOTE - SAVEWRK1: AUTOLOG+PSWRDCK = AUTOLOG COMMAND
                        AUTOLOG ONLY    = CPI SYS OP LOGON