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 V5R1.0. Last updated on 8 Sep 2004 at 14:14:04 EDT.
Copyright IBM Corporation, 1990, 2004