Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
PCDBK
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 00000800 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' REJECT EQUATES FOR COMMAND WORD LIST OF COMMANDS TO THE PROCESSOR CONTROLLER COMMAND DEPENDENT CODE BYTE IDENTIFICATION CODE BYTE 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| * +-------------+------+------+-------------+------+------+ * 8 | | * = PCDVDATA = * | | * +-------------------------------------------------------+ * *** 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) | | * +-------------+ | * 30 | | * = PCDVCPDA = * | | * +-------------------------------------------------------+ * *** Overlay for PCDVDATA in PCDBK
PCDBK Cross Reference
(contains links to field and bit definitions)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 00000800
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
Last updated on 3 Aug 1999 at 12:21:15 EDT.
Copyright IBM Corporation, 1990, 1999