Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### SECBK

Prolog

Control Block Contents
SECBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### SECBK Prolog

     Name       : HCPSECBK
     Description: An element of the SECONDARY USERIDS TABLE
     DSECT      : SECBK (for IDOFFSET) / SECBB (for LIKE declares)
     Function   :
                  Used to map information for an element of the
                  TABLE OF SECONDARY USERIDS. It is maintained
                  by HCPSEC. This table is neccessary to improve
                  the performance of HCPSEC.
     Located by : SYSSECQ, an anchor located in SYSCM
     Created by : HCPSEC
     Deleted by : HCPSEC
     Notes-
                  - The TABLE OF SECONDARY USERIDS is anchored in SYSCM.
                  The lock for the table is SYSSECLK.
                  - The definition for each field in an element of the
                  TABLE OF SECONDARY USERIDS is:
                  - SEC_NEXT = points to the next element, if there is no
                  next element then it is zero.
                  - SEC_SECONDARY_USERID = has a user-id that can be found
                  in the VMDSECU of some user in the system.
                  - SEC_NUMBER_OF_REQUESTORS = the number of users in the
                  system whose VMDSECU is the same as
                  the SEC_SECONDARY_USERID of this element.
                  - The invariant for this table
                  (TABLE_OF_SECONDARY_USERIDS) is:
                  A user-id is in this table if and only if there is some
                  user in the system whose VMDSECU field contains
                  this user-id, and, the SEC_NUMBER_OF_REQUESTORS is the
                  number of users in the system whose VMDSECU field
                  contains this user-id.

#### SECBK Control Block Content

#### SECBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      SECBK          An element of the SECONDARY
                                            USERIDS TABLE
    0000    0 Address      4 SEC_NEXT       Next SECBK address
    0004    4 Character    8 SEC_SECONDARY_USERID
                                            Secondary userid
    000C   12 Signed       4 SEC_NUMBER_OF_REQUESTORS
                                            Referring users
              00000002       SECSIZE        (*-SECBK+7)/8 SECBK size in
                                            doublewords

#### SECBK Storage Layout

    *** SECBK - An element of the SECONDARY USERIDS TABLE
    *
    *     +---------------------------+---------------------------+
    *   0 |         SEC_NEXT          |  SEC_SECONDARY_USERID-    |
    *     +---------------------------+---------------------------+
    *   8 |          -(004)           | SEC_NUMBER_OF_REQUESTORS  |
    *     +---------------------------+---------------------------+
    *  10
    *
    *** SECBK - An element of the SECONDARY USERIDS TABLE

#### SECBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    SEC_NEXT       0000
    SEC_NUMBER_OF_REQUESTORS
                   000C
    SEC_SECONDARY_USERID
                   0004
    SECSIZE        000C 00000002

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 17:22:59 EDT.
Copyright IBM Corporation, 1990, 2005