|
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM. |
PCDBK
Control Block Contents
PCDBK DSECT
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
00000000 *
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
00000000 *
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 -------------- ---- ----- * 0006 00000000 * 0007 00000000 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
Last updated on 5 Jun 2001 at 16:07:40 EDT.
Copyright IBM Corporation, 1990, 2001