ENCBK | Back to Index page

| Prolog Control Block Contents ENCBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

ENCBK Prolog | Top of page

     NAME       : HCPENCBK
     DESCRIPTION: Encryption Data Block
     DSECT      : ENCBK
     FUNCTION   : Contains information related to Encryption
                  settings on the system.
     LOCATED BY : SYSENCBK pointer of system.
     CREATED BY : HCPIIO During CP initialization
     DELETED BY : Never deleted
     SERIALIZED : ENCLOCK lock in this control block
     RELOCATION CONSIDERATIONS : None

ENCBK Control Block Content | Top of page

     ENCBK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      ENCBK          Encryption Data Block
    0000    0 Dbl-Word     8 ENCLOCK (3)    Lck for control blk serialization
    0018   24 Bitstring    1 ENCHIST        Services that used encryption
              1... ....      EPALG128       X'80' EPALG128 Paging has used
                                            AES128
              .1.. ....      EPALG192       X'40' EPALG192 Paging has used
                                            AES192
              ..1. ....      EPALG256       X'20' EPALG256 Paging has used
                                            AES256
    0019   25 Bitstring    1 ENCFLG         Set Encrypt command flag
              1... ....      ENCPAG         X'80' ENCPAG New Set ENCRYPT
                                            PAGING issued
    001A   26 Bitstring    1 ENCPSET        ENCRYPT PAGING current setting
              1... ....      ENCPON         X'80' ENCPON ENCRYPT PAGING set
                                            ON
              .1.. ....      ENCPOFF        X'40' ENCPOFF ENCRYPT PAGING set
                                            OFF
              ..1. ....      ENCPREQ        X'20' ENCPREQ ENCRYPT PAGING set
                                            REQUIRED
    001B   27 Bitstring    1 ENCPALG        ENCRYPT PAGING current algorithm
              1... ....      ENCP128        X'80' ENCP128 AES128 was
                                            specified
              .1.. ....      ENCP192        X'40' ENCP192 AES192 was
                                            specified
              ..1. ....      ENCP256        X'20' ENCP256 AES256 was
                                            specified
    001C   28 Bitstring    1 ENCINFL        Service requested at IPL
              1... ....      ENCPAGI        X'80' ENCPAGI PAGING
    001D   29 Bitstring    1 ENCPINI        ENCRYPT PAGING config. setting
                                            Bits for ENCPINI defined by
                                            HCPENCBK ENCPSET
    001E   30 Bitstring    1 ENCIPAL        Initial Paging Algorithm Flag
                                            Bits for ENCIPAL defined by
                                            HCPENCBK ENCPALG
    001F   31 Bitstring    1 *              Reserved for IBM use
    0020   32 Address      8 ENCPKEY        Master key for processor pointer
            Encryption Event Monitor Data
    0028   40 Signed       4 * (0)          Full word boundary
    0028   40 Character    8 ENCSERV        CP service to cipher
           Byte ENCPREV must have the same bit definitions as ENCCUR
    0030   48 Bitstring    1 ENCPREV        Previous encryption settings
    0031   49 Bitstring    1 ENCCUR         Current encryption settings
              1... ....      ENCREQC        X'80' ENCREQC ENCRYPT Required
              .1.. ....      ENCONC         X'40' ENCONC ENCRYPT On
              ..1. ....      ENCOFFC        X'20' ENCOFFC ENCRYPT Off
              ...1 ....      ENC128C        X'10' ENC128C Algorithm AES128
              .... 1...      ENC192C        X'08' ENC192C Algorithm AES192
              .... .1..      ENC256C        X'04' ENC256C Algorithm AES256
                                            X'02' Reserved for IBM use X'01'
                                            Reserved for IBM use
    0032   50 Bitstring    1 * (2)          Reserved for IBM use
    0034   52 Character    8 ENCUSRID       USERID that made the change
            Encrypt Paging Configuration Monitor Data
    003C   60 Signed       4 * (0)          Full word boundary
    003C   60 Bitstring    1 ENCPINIT       ENCRYPT PAGING at IPL
              1... ....      ENCPREQI       X'80' ENCPREQI ENCRYPT PAGING
                                            Required
              .1.. ....      ENCPONI        X'40' ENCPONI ENCRYPT PAGING On
              ..1. ....      ENCPOFFI       X'20' ENCPOFFI ENCRYPT PAGING Off
              ...1 ....      ENCP128I       X'10' ENCP128I Algorithm AES128
              .... 1...      ENCP192I       X'08' ENCP192I Algorithm AES192
              .... .1..      ENCP256I       X'04' ENCP256I Algorithm AES256
                                            X'02' Reserved for IBM use X'01'
                                            Reserved for IBM use
    003D   61 Bitstring    1 ENCEPCUR       Current state of Encrypt Paging
                                            Bits for ENCEPCUR defined by
                                            HCPENCBK ENCPINIT
    003E   62 Bitstring    1 ENCFAIL        Encrypt service failure codes
              1... ....      ENCPACF        X'80' ENCPACF CPACF hardware not
                                            available
    003F   63 Bitstring    6 *              Reserved for IBM use
              00000045       ENCBKSIZ       *-ENCBK Size of ENCBK in Bytes
              00000009       ENCBKSZD       (*-ENCBK+7)/8 Size of ENCBK in
                                            Doublewords

ENCBK Storage Layout | Top of page

    *** ENCBK - Encryption Data Block
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       ENCLOCK                         =
    *     |                                                       |
    *     +------+------+------+------+------+------+------+------+
    *  18 |:HIST |ENCFLG|:PSET |:PALG |:INFL |:PINI |:IPAL |//////|
    *     +------+------+------+------+------+------+------+------+
    *  20 |                       ENCPKEY                         |
    *     +-------------------------------------------------------+
    *  28 |                       ENCSERV                         |
    *     +------+------+-------------+---------------------------+
    *  30 |:PREV |ENCCUR|/////////////|        ENCUSRID-          |
    *     +------+------+-------------+------+------+------+------+
    *  38 |          -(034)           |:PINIT|:EPCUR|:FAIL |//////|
    *     +---------------------------+------+------+------+------+
    *  40 |//////////////////////////////////| 45
    *     +----------------------------------+
    *
    *** ENCBK - Encryption Data Block

ENCBK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    ENCBKSIZ       003F 00000045
    ENCBKSZD       003F 00000009
    ENCCUR         0031
    ENCEPCUR       003D
    ENCFAIL        003E
    ENCFLG         0019
    ENCHIST        0018
    ENCINFL        001C
    ENCIPAL        001E
    ENCLOCK        0000
    ENCOFFC        0031 20
    ENCONC         0031 40
    ENCPACF        003E 80
    ENCPAG         0019 80
    ENCPAGI        001C 80
    ENCPALG        001B
    ENCPINI        001D
    ENCPINIT       003C
    ENCPKEY        0020
    ENCPOFF        001A 40
    ENCPOFFI       003C 20
    ENCPON         001A 80
    ENCPONI        003C 40
    ENCPREQ        001A 20
    ENCPREQI       003C 80
    ENCPREV        0030
    ENCPSET        001A
    ENCP128        001B 80
    ENCP128I       003C 10
    ENCP192        001B 40
    ENCP192I       003C 08
    ENCP256        001B 20
    ENCP256I       003C 04
    ENCREQC        0031 80
    ENCSERV        0028
    ENCUSRID       0034
    ENC128C        0031 10
    ENC192C        0031 08
    ENC256C        0031 04
    EPALG128       0018 80
    EPALG192       0018 40
    EPALG256       0018 20

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:28:04 EDT.
Copyright IBM Corporation, 1990, 2020