PCDBK - 64-bit CP - V4R4.0

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

#### PCDBK

Prolog

Control Block Contents
PCDBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### PCDBK Prolog

     NAME       : HCPPCDBK
     DESCRIPTION: PROCESSOR CONTROLLER DIAGNOSE DATA BLOCK
     DSECT      : PCDBK
     FUNCTION   : MAPS HARDWARE PROCESSOR CONTROLLER DATA BLOCK FOR A
                  REQUESTED COMMAND.  USED TO PASS INFORMATION BETWEEN
                  CP AND THE PROCESSOR CONTROLLER WHEN USING THE
                  DIAGNOSE X'80' INTERFACE.
     LOCATED BY : PCRRDBKA  ADDRESS POINTER TO THE PROCESSOR CONTROLLER
                  DATA BLOCK TO BE USED IN PROCESSING THE
                  ASSOCIATED REAL REQUEST.
                  PCSACTIV  ADDRESS POINTER TO THE PROCESSOR CONTROLLER
                  DATA BLOCK FOR THE CURRENT ACTIVE REQUEST.
     CREATED BY : HCPRFG    WHEN BUILDING REAL PROCESSOR CONTROLLER REQUEST
                  HCPSCP    WHEN BUILDING REAL PROCESSOR CONTROLLER REQU
     DELETED BY : HCPRFG    WHEN REAL PROCESSOR CONTROLLER REQUEST COMPLETE
                  HCPSCP    WHEN REAL PROCESSOR CONTROLLER REQUEST COMPL

#### PCDBK Control Block Content

#### PCDBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      PCDBK          PROCESSOR CONTROLLER DIAGNOSE
                                            DATA BLOCK
    0000    0 Bitstring    8 PCDHEAD (0)    DATA BLOCK HEADER FOR ALL
                                            REQUESTS DATA BLOCK LENGTHS THAT
                                            VARY WITH THE AMOUNT OF
                                            INFORMATION ARE DEFINED WITH THE
                                            FORMAT FOR THE PARTICULAR
                                            PROCESSOR CONTROLLER COMMAND.
    0000    0 Signed       2 PCDLEN         NO. OF BYTES IN THE DATA BLOCK
              .... 1...      PCDVCLEN       X'0008' PCDBK LENGTH FOR VARY CP
                                            REQUESTS
              00PCDLEN       PCDMXLEN       X'0800' MAXIMUM PCDBK LENGTH (2K)
    0002    2 Bitstring    1 PCDCFLG        CALLER FLAG (REQUESTOR)
    0003    3 Bitstring    1 PCDHFLG        HARDWARE FLAG (PROCESSOR
                                            CONTROLLER)
    0004    4 Signed       2 *              RESERVED FOR FUTURE HARDWARE USE
    0006    6 Signed       2 PCDRESP (0)    RESPONSE CODE
    0006    6 Bitstring    1 PCDRESPD       RESPONSE DEPENDENT CODES
              00000000       PCDINVAD       X'00' X'0000' INVALID ADDR. OF
                                            DATABLOCK
              00000001       PCDNO2KB       X'01' X'0100' ADDR. NOT ON 2K
                                            BOUNDARY
              00000002       PCDNO8BT       X'02' X'0200' LENGTH NOT IN 8
                                            BYTE INCREMENTS
              00000003       PCDBADLN       X'03' X'0300' LENGTH WRONG FOR
                                            DATA
              00000000       PCDVALCM       X'00' X'0020' VALID COMMAND
                                            COMPLETE
              00000002       PCDNOFLG       X'02' X'02F0' INVALID FLAG BYTE
              00000003       PCDINVCP       X'03' X'03F0' INVALID CPU ADDRESS
                                            SPECIFIED.
              00000000       PCDLGCMS       X'00' X'0020' LOGICAL IOCP WRITE
                                            LOCK ACQUIRED OR RELEASED FOR CMS
                                            IOCP USER
              00000001       PCDNOCMS       X'01' X'01F0' LOGICAL IOCP WRITE
                                            LOCK WAS PREVIOUSLY LOCKED BY
                                            ANOTHER USER OR ALREADY RELEASED
              00000001       PCDINVCI       X'01' X'01F0' INVALID COMMAND OR
                                            IDENTIFICATION
              00000042       PCDICPRJ       X'42' X'42F0' INVALID IOCP
                                            COMMAND
    0007    7 Bitstring    1 PCDRESPS       SPECIFIC RESPONSE CODES
              00000000       PCDDBERR       X'00' DATA BLOCK ERROR
              00000010       PCDINFO        X'10' INFORMATION
              00000020       PCDCMPLT       X'20' COMPLETE
              00000030       PCDICMPT       X'30' INCOMPLETE
              00000040       PCDBKOUT       X'40' BACKOUT
              00000050       PCDCMND        X'50' COMMAND
              00000060       PCDQUIES       X'60' QUIESCED
              000000F0       PCDRJCT        X'F0' R
         EQUATES FOR COMMAND WORD
         LIST OF COMMANDS TO THE PROCESSOR CONTROLLER
              00000001       PCDHDSIZ       (*-PCDHEAD+7)/8 :PCDBK HEADER
                                            SIZE IN DOUBLE WORDS
              00000008       PCDHDLEN       (*-PCDBK) :PCDBK HEADER LENGTH IN
                                            BYTES
    0008    8 Character    1 PCDVDATA (0)   START OF VARIABLE LENGTH DATA
         I/O CONFIGURATION PROGRAM DATA FORMAT
    0008    8 Signed       2 PCDIOCPF (0)   IOCP DATA FORMAT
    0008    8 Bitstring    1 PCDOPCL        OPEN-CLOSE STATUS ON THIS REQUEST
              1... ....      PCDOPNRW       X'80' FIRST READ OR WRITE WITH
                                            OPEN
              .1.. ....      PCDCLSRW       X'40' READ OR WRITE CLOSE WITH NO
                                            DATA
    0009    9 Bitstring    1 PCDSECNO       NUMBER DATA SECTORS TRANSFERRED
              .... ....      PCDNODAT       X'00' NO DATA TRANSFERRED WITH
                                            THIS REQUEST
    000A   10 Bitstring    1 * (246)
    0100  256 Bitstring  256 PCDSECT1       DATA SECTOR NUMBER 1
    0200  512 Bitstring  256 PCDSECT2       DATA SECTOR NUMBER 2
    0300  768 Bitstring  256 PCDSECT3       DATA SECTOR NUMBER 3
    0400 1024 Bitstring  256 PCDSECT4       DATA SECTOR NUMBER 4
    0500 1280 Bitstring  256 PCDSECT5       DATA SECTOR NUMBER 5
    0600 1536 Bitstring  256 PCDSECT6       DATA SECTOR NUMBER 6
    0700 1792 Bitstring  256 PCDSECT7       DATA SECTOR NUMBER 7
              00000100       PCDICSIZ       (*-PCDBK+7)/8 :PCDBK SIZE IN
                                            DOUBLE WORDS NOTE: SIZE FOR IOCP
                                            REQUESTS
              00000800       PCDICLEN       (*-PCDBK) :PCDBK LENGTH FOR IOCP
                                            REQUESTS
         CHANNEL PATH INFORMATION DATA FORMAT
    0008    8 Bitstring   32 PCDCHPAL       INSTALLED CHANNEL PATHS
    0028   40 Bitstring   32 PCDCHPOW       OWNED CHANNEL PATHS
    0048   72 Bitstring   32 PCDCHPON       ON/OFF-LINE CHANNEL PATHS
    0068  104 Bitstring   32 PCDCHP0A       370 CHANNEL SET 0A
    0068  104 Bitstring    2 PCDCHP0S (16)  370 CHANNEL SET 0A
    0088  136 Bitstring   32 PCDCHP1A       370 CHANNEL SET 1A
    00A8  168 Bitstring   32 PCDCHP0B       370 CHANNEL SET 0B
    00C8  200 Bitstring   32 PCDCHP1B       370 CHANNEL SET 1B
    00E8  232 Bitstring    1 PCDCHPST       CHANNEL SET CONFIGURATION BYTE
              0000001E       PCDCHSIZ       (*-PCDBK+7)/8 :PCDBK SIZE IN
                                            DOUBLE WORDS NOTE: SIZE FOR
                                            CHANNEL PATH INFORMATION REQUESTS
              000000E9       PCDCHLEN       (*-PCDBK) :PCDBK LEN FOR CHANNEL
                                            PATH INFORMATION REQUESTS
         SCP INFORMATION DATA FORMAT
    0008    8 Bitstring    1 PCDSAR         STORAGE ADDRESS RANGE
    0009    9 Bitstring    1 PCDSAI         STORAGE ADDRESS INCREMENT
    000A   10 Bitstring    1 PCDSBS         STORAGE BLOCK SIZE
    000B   11 Bitstring    1 PCDSII         STORAGE INTERLEAVE INTERVAL
    000C   12 Bitstring    4 PCDIPL         IPL DUMP ID
    0010   16 Bitstring    2 PCDNOCPU       NUMBER OF CPUS
    0012   18 Bitstring    2 PCDCPPTR       OFFSET TO CPUDATA
    0014   20 Bitstring    2 PCDNOHSA       NUMBER OF HARDWARE SYSTEM AREAS
    0016   22 Bitstring    2 PCDHSAPT       OFFSET TO HARDWARE SYSTEM AREAS
    0018   24 Bitstring    8 PCDLOADP       LOAD PARAMETERS
    0020   32 Bitstring    1 PCDCNFFG       BYTE OF CONFIGURATION INDICATORS
    0021   33 Bitstring    1 PCDFEATS       BYTE OF INSTALLED FEATURES
              1... ....      PCDIOPIN       X'80' I/O PASSTHROUGH INSTALLED
              00000005       PCDVSCPS       (*-PCDBK+7)/8 :PCDBK SIZE IN
                                            DOUBLE WORDS NOTE: SIZE FOR
                                            SCPINFO REQUESTS VARIES WITH THE
                                            NUMBER OF CPUS
              00000022       PCDVSCPL       (*-PCDBK) PCDBK LENGTH FOR
                                            SCPINFO request s VARIES WITH THE
                                            NUMBER OF CPUS
         STARTING AT THE OFFSET CONTAINED IN THE FIELD PCDCPPTR ARE THE
         INSTALLED CPU ENTRIES, WHICH ARE CONSECUTIVE IN STORAGE. THERE IS ONE
         ENTRY PER CPU DEFINED.
    0022   34 Bitstring    1 PCDCPADR       CPU ADDRESS
    0023   35 Bitstring    1 PCDCPSID       CPU SIDE
              00000002       PCDCPULN       *-PCDCPADR LENGTH OF EACH CPU
                                            ENTRY
         STARTING AT THE OFFSET CONTAINED IN THE FIELD PCDHSAPT ARE THE
         DESCRIPTION ENTRIES FOR THE MACHINE STORAGE AREAS. THERE IS ONE ENTRY
         PER MACHINE-STORAGE-AREA.
              00000024       PCDVHSAP       (*-PCDBK) OFFSET TO HARDWARE
                                            SYSTEM AREA
    0024   36 Signed       2 PCDMSSIZ       Size of machine storage area in
                                            4K bytes if bit 0 = 1 or 32K
                                            bytes if bit 0 = 0
    0026   38 Address      4 PCDMSADD       Absolute address of machine
                                            storage area
    002A   42 Signed       2 PCDNXMSA (0)   Next machine storage area
                                            description
    002A   42 Bitstring    1 PCDVCPDA (0)   START OF VARIABLE LENGTH DATA

#### PCDBK Storage Layout

    *** PCDBK - PROCESSOR CONTROLLER DIAGNOSE DATA BLOCK
    *
    *     +-------------+------+------+-------------+------+------+
    *   0 |   PCDLEN    |:CFLG |:HFLG |/////////////|:RESPD|:RESPS|
    *     +-------------+------+------+-------------+------+------+
    *
    *** PCDBK - PROCESSOR CONTROLLER DIAGNOSE DATA BLOCK

    *** Overlay for PCDVDATA in PCDBK
    *
    *     +------+------+-----------------------------------------+
    *   8 |:OPCL |:SECNO|/////////////////////////////////////////|
    *     +------+------+/////////////////////////////////////////|
    *  10 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    * 100 |                                                       |
    *     =                       PCDSECT1                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 200 |                                                       |
    *     =                       PCDSECT2                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 300 |                                                       |
    *     =                       PCDSECT3                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 400 |                                                       |
    *     =                       PCDSECT4                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 500 |                                                       |
    *     =                       PCDSECT5                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 600 |                                                       |
    *     =                       PCDSECT6                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 700 |                                                       |
    *     =                       PCDSECT7                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 800
    *
    *** Overlay for PCDVDATA in PCDBK

    *** Overlay for PCDVDATA in PCDBK
    *
    *     +-------------------------------------------------------+
    *   8 |                                                       |
    *     =                       PCDCHPAL                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  28 |                                                       |
    *     =                       PCDCHPOW                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  48 |                                                       |
    *     =                       PCDCHPON                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  68 |                                                       |
    *     =                       PCDCHP0A                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  88
    *
    *** Overlay for PCDVDATA in PCDBK

    *** Overlay for PCDCHP0A in PCDBK
    *
    *     +-------------------------------------------------------+
    *  68 |                                                       |
    *     =                       PCDCHP0S                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  88 |                                                       |
    *     =                       PCDCHP1A                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  A8 |                                                       |
    *     =                       PCDCHP0B                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  C8 |                                                       |
    *     =                       PCDCHP1B                        =
    *     |                                                       |
    *     +------+------------------------------------------------+
    *  E8 |:CHPST| E9
    *     +------+
    *
    *** Overlay for PCDCHP0A in PCDBK

    *** Overlay for PCDVDATA in PCDBK
    *
    *     +------+------+------+------+---------------------------+
    *   8 |PCDSAR|PCDSAI|PCDSBS|PCDSII|          PCDIPL           |
    *     +------+------+------+------+-------------+-------------+
    *  10 |  PCDNOCPU   |  PCDCPPTR   |  PCDNOHSA   |  PCDHSAPT   |
    *     +-------------+-------------+-------------+-------------+
    *  18 |                       PCDLOADP                        |
    *     +------+------+------+------+-------------+-------------+
    *  20 |:CNFFG|:FEATS|:CPADR|:CPSID|  PCDMSSIZ   | PCDMSADD-   |
    *     +------+------+------+------+-------------+-------------+
    *  28 |   -(026)    |
    *     +-------------+
    *
    *** Overlay for PCDVDATA in PCDBK

#### PCDBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    PCDBADLN       0006 00000003
    PCDBKOUT       0007 00000040
    PCDCFLG        0002
    PCDCHLEN       00E8 000000E9
    PCDCHPAL       0008
    PCDCHPON       0048
    PCDCHPOW       0028
    PCDCHPST       00E8
    PCDCHP0A       0068
    PCDCHP0B       00A8
    PCDCHP0S       0068
    PCDCHP1A       0088
    PCDCHP1B       00C8
    PCDCHSIZ       00E8 0000001E
    PCDCLSRW       0008 40
    PCDCMND        0007 00000050
    PCDCMPLT       0007 00000020
    PCDCNFFG       0020
    PCDCPADR       0022
    PCDCPPTR       0012
    PCDCPSID       0023
    PCDCPULN       0023 00000002
    PCDDBERR       0007 00000000
    PCDFEATS       0021
    PCDHDLEN       0007 00000008
    PCDHDSIZ       0007 00000001
    PCDHEAD        0000
    PCDHFLG        0003
    PCDHSAPT       0016
    PCDICLEN       0700 00000800
    PCDICMPT       0007 00000030
    PCDICPRJ       0006 00000042
    PCDICSIZ       0700 00000100
    PCDINFO        0007 00000010
    PCDINVAD       0006 00000000
    PCDINVCI       0006 00000001
    PCDINVCP       0006 00000003
    PCDIOCPF       0008
    PCDIOPIN       0021 80
    PCDIPL         000C
    PCDLEN         0000
    PCDLGCMS       0006 00000000
    PCDLOADP       0018
    PCDMSADD       0026
    PCDMSSIZ       0024
    PCDMXLEN       0000 00PCDLEN
    PCDNOCMS       0006 00000001
    PCDNOCPU       0010
    PCDNODAT       0009 00
    PCDNOFLG       0006 00000002
    PCDNOHSA       0014
    PCDNO2KB       0006 00000001
    PCDNO8BT       0006 00000002
    PCDNXMSA       002A
    PCDOPCL        0008
    PCDOPNRW       0008 80
    PCDQUIES       0007 00000060
    PCDRESP        0006
    PCDRESPD       0006
    PCDRESPS       0007
    PCDRJCT        0007 000000F0
    PCDSAI         0009
    PCDSAR         0008
    PCDSBS         000A
    PCDSECNO       0009
    PCDSECT1       0100
    PCDSECT2       0200
    PCDSECT3       0300
    PCDSECT4       0400
    PCDSECT5       0500
    PCDSECT6       0600
    PCDSECT7       0700
    PCDSII         000B
    PCDVALCM       0006 00000000
    PCDVCLEN       0000 08
    PCDVCPDA       002A
    PCDVDATA       0008
    PCDVHSAP       0023 00000024
    PCDVSCPL       0021 00000022
    PCDVSCPS       0021 00000005

This information is based on z/VM V4R4.0. Last updated on 30 Jul 2003 at 13:04:05 EDT.
Copyright IBM Corporation, 1990, 2003