PCDBK Back to Index page
 
Prolog 
Control Block Contents 
   PCDBK 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.


  PCDBK Prolog Top of page
 
 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
 RELOCATION CONSIDERATIONS : None
 
 
  PCDBK Control Block Content Top of page
 

 PCDBK DSECT Top of page
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' PCDVCLEN PCDBK LENGTH FOR VARY CP REQUESTS 00PCDLEN PCDMXLEN X'0800' PCDMXLEN 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' PCDINVAD X'0000' INVALID ADDR. OF DATABLOCK 00000001 PCDNO2KB X'01' PCDNO2KB X'0100' ADDR. NOT ON 2K BOUNDARY 00000002 PCDNO8BT X'02' PCDNO8BT X'0200' LENGTH NOT IN 8 BYTE INCREMENTS 00000003 PCDBADLN X'03' PCDBADLN X'0300' LENGTH WRONG FOR DATA 00000000 PCDVALCM X'00' PCDVALCM X'0020' VALID COMMAND COMPLETE 00000002 PCDNOFLG X'02' PCDNOFLG X'02F0' INVALID FLAG BYTE 00000003 PCDINVCP X'03' PCDINVCP X'03F0' INVALID CPU ADDRESS SPECIFIED. 00000000 PCDLGCMS X'00' PCDLGCMS X'0020' LOGICAL IOCP WRITE LOCK ACQUIRED OR RELEASED FOR CMS IOCP USER 00000001 PCDNOCMS X'01' PCDNOCMS X'01F0' LOGICAL IOCP WRITE LOCK WAS PREVIOUSLY LOCKED BY ANOTHER USER OR ALREADY RELEASED 00000001 PCDINVCI X'01' PCDINVCI X'01F0' INVALID COMMAND OR IDENTIFICATION 00000042 PCDICPRJ X'42' PCDICPRJ X'42F0' INVALID IOCP COMMAND 0007 7 Bitstring 1 PCDRESPS SPECIFIC RESPONSE CODES 00000000 PCDDBERR X'00' PCDDBERR DATA BLOCK ERROR 00000010 PCDINFO X'10' PCDINFO INFORMATION 00000020 PCDCMPLT X'20' PCDCMPLT COMPLETE 00000030 PCDICMPT X'30' PCDICMPT INCOMPLETE 00000040 PCDBKOUT X'40' PCDBKOUT BACKOUT 00000050 PCDCMND X'50' PCDCMND COMMAND 00000060 PCDQUIES X'60' PCDQUIES QUIESCED 000000F0 PCDRJCT X'F0' PCDRJCT REJECT 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' PCDOPNRW FIRST READ OR WRITE WITH OPEN .1.. .... PCDCLSRW X'40' PCDCLSRW READ OR WRITE CLOSE WITH NO DATA 0009 9 Bitstring 1 PCDSECNO NUMBER DATA SECTORS TRANSFERRED .... .... PCDNODAT X'00' PCDNODAT 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' PCDIOPIN 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 Top of page
 
          
*** 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 Top of page
 
 
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 7.3.0 Last updated on 22 Jun 2022 at 15:53:30 EDT.
Copyright IBM Corporation, 1990, 2022