IBM: LGFBK

Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only.

LGFBK

Prolog

Control Block Contents

LGFBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

LGFBK Prolog

 NAME       : HCPLGFBK
 DESCRIPTION: LOGOFF control block
 DSECT      : LGFBK
 FUNCTION   :
 LOCATED BY : VMDLGFBK (origin VMDBK only)
 CREATED BY : HCPUSOPR
 DELETED BY : HCPUSOLC
 SERIALIZED : Master processor

LGFBK Control Block Content


LGFBK DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      LGFBK          LOGOFF control block
     LGFTRMLK is used to serialize terminal clean-up processing (for LOGOFF,
     FORCE, DISCONNECT or LOGON HERE). Terminal clean-up processing is done
     without console function mode serialization. Any task performing
     terminal clean-up must hold LGFTRMLK exclusive. If a second task tries
     to get the lock it will be deferred until terminal clean-up is
     complete. For instance if one user issues FORCE DISCONNECT and another
     issues FORCE LOGOFF, when FORCE LOGOFF goes for the lock it will be
     deferred until FORCE DISCONNECT completes terminal clean-up.
     Notes : If a thread of execution requires both CFM and the LGFTRMLK, it
     must obtain CFM first and the LGFTRMLK later. The LGFTRMLK should be
     released before the thread relinquishes CFM.
0000    0 Dbl-Word     8 LGFTRMLK (3)   Terminal clean-up lockword
0018   24 Character    8 LGFLOGID       ID of user who initiated this
                                        LOGOFF
0020   32 Character    8 LGFDSCID       ID of user who initiated this
                                        DISCONNECT
0028   40 Signed       4 LGFSKEL        Pointer to skeleton VMDBK that
                                        issued LOGON HERE
002C   44 Bitstring    1 LGFFLAGS       Terminal clean-up flag byte
          1... ....      LGFNOMSG       X'80' Do not send an OPERATOR
                                        style message to the FORCEr.
          ...1 ....      LGFNOUSR       X'10' No output should be
                                        attempted to this user's terminal
002D   45 Bitstring    1 * (3)          Reserved
     Request flags and footprint area
0030   48 Bitstring    1 LGFFPRT1       Request/footprint flags
          1... ....      LGFDSCN        X'80' Disc msgs to the user and
                                        operator are needed
          .1.. ....      LGFDSCD        X'40' Disc msgs to the user and
                                        operator have been done
          ..1. ....      LGFLGFUN       X'20' Logoff msgs to the user are
                                        needed
          ...1 ....      LGFLGFUD       X'10' Logoff msgs to the user
                                        have been done
          .... 1...      LGFLGFON       X'08' Logoff msgs to the operator
                                        are needed
          .... .1..      LGFLGFOD       X'04' Logoff msgs to the operator
                                        have been done
          .... ..1.      LGFUSPFF       X'02' HCPUSPFF terminal
                                        processing has been completed.
0031   49 Bitstring    1 * (3)          Reserved
     Data for the logoff/disconnect messages
0034   52 Character   10 LGFTRMID (0)
0034   52 Character    8 LGFLUNAM       LU name logging off
003C   60 Character    2 LGFBLNKS       Pad with blanks
0034   52 Character    4 LGFTTYPE       Terminal type logging off
0038   56 Character    1 LGFBLANK       One space is enough here
0039   57 Character    5 LGFDVNUM       Device number (Lnnnn or nnnn)
003E   62 Bitstring    1 LGFFENCE       End of substitution fence
          00000008       LGFSIZE        (*-LGFBK+7)/8 Size, in
                                        doublewords, of LGFBK

LGFBK Storage Layout

*** LGFBK - LOGOFF control block
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       LGFTRMLK                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  18 |                       LGFLOGID                        |
*     +-------------------------------------------------------+
*  20 |                       LGFDSCID                        |
*     +---------------------------+------+--------------------+
*  28 |         LGFSKEL           |:FLAGS|////////////////////|
*     +------+--------------------+------+--------------------+
*  30 |:FPRT1|////////////////////|        LGFLUNAM-          |
*     +------+--------------------+-------------+-------------+
*  38 |          -(034)           |  LGFBLNKS   | 3E
*     +---------------------------+-------------+
*
*** LGFBK - LOGOFF control block
*** Overlay for LGFTRMID in LGFBK
*
*                                 +---------------------------+
*  30 ...                      34 |         LGFTTYPE          |
*     +------+--------------------+-------------+------+------+
*  38 |:BLANK|            LGFDVNUM              |:FENCE| 3F
*     +------+----------------------------------+------+
*
*** Overlay for LGFTRMID in LGFBK