PCRBK | Back to Index page

| Prolog Control Block Contents PCRBK 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.

PCRBK Prolog | Top of page

     NAME       : HCPPCRBK
     DESCRIPTION: PROCESSOR CONTROLLER REQUEST BLOCK
     DSECT      : PCRBK
     FUNCTION   : EACH PCRBK IDENTIFIES ONE OUTSTANDING PROCESSOR
                  CONTROLLER REQUEST.
     LOCATED BY : PCSPCRQ   ANCHOR FOR PROCESSOR CONTROLLER REQUEST QUEUE
                  PCRFPTR   CHAINED VIA FORWARD POINTER OF PREVIOUS
                  REQUEST IN THE REQUEST QUEUE
     CREATED BY : HCPPCD    WHEN BUILDING REAL PROCESSOR CONTROLLER
                  REQUEST NEEDED FOR VIRT REQUEST PROCESSING
                  HCPPCV    WHEN BUILDING REAL PROCESSOR CONTROLLER
                  REQUEST NEEDED FOR VIRT REQUEST PROCESSING
                  HCPRFG    WHEN BUILDING REAL PROCESSOR CONTROLLER REQUEST
                  HCPSCP    WHEN BUILDING REAL PROCESSOR CONTROLLER REQU
     DELETED BY : HCPPCD    WHEN REAL PROCESSOR CONTROLLER REQUEST COMP
                  HCPPCM    WHEN REAL PROCESSOR CONTROLLER REQUEST COMP
                  HCPPCV    WHEN REAL PROCESSOR CONTROLLER REQUEST COMPLETE
                  HCPRFG    WHEN REAL PROCESSOR CONTROLLER REQUEST COMPLETE
                  HCPSCP    WHEN REAL PROCESSOR CONTROLLER REQUEST COMPL
     RELOCATION CONSIDERATIONS : None

PCRBK Control Block Content | Top of page

     PCRBK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      PCRBK          PROCESSOR CONTROLLER REQUEST BLOCK
    0000    0 Address      4 PCRFPTR        FORWARD POINTER TO NEXT PCRBK
    0004    4 Address      4 PCRBPTR        BACKWARD PCRBK PREVIOUS POINTER
    0008    8 Bitstring    1 PCRFLAG        REQUEST STATUS FLAG
              1... ....      PCRVMREQ       X'80' PCRVMREQ VIRTUAL MACHINE
                                            REQUEST TO THE PROCESSOR
                                            CONTROLLER
              .1.. ....      PCRCPREQ       X'40' PCRCPREQ CP REQUEST TO
                                            PROCESSOR CONTROLLER
              ..1. ....      PCRNORET       X'20' PCRNORET Caller does not
                                            want PC return code Options for
                                            HCPPDRGD/HCPPDRRD
              .... ....      PDRARDAT       0 PDRARDAT Obtain or update
                                            architecture data
              .... ....      PDRGDMAX       0 PDRGDMAX Maximum option value
                                            Input parameters for HCPSASCP
              .... ..11      SASCPCAP       3 SASCPCAP Inform guest of
                                            capability change
              .... .1..      SASCPARC       4 SASCPARC Inform guest of
                                            architecture change Return codes
                                            from SSI Manager calls to
                                            services
              .... ....      PXMOK          0 PXMOK Function complete
              .... .1..      PXMDEFER       4 PXMDEFER Function deferred
              .... 1...      PXMREJCT       8 PXMREJCT Function rejected
              .... 11..      PXMWAIT        12 PXMWAIT Function rejected -
                                            Enter wait state
    0009    9 Bitstring    1 PCRDSIVL       THIS REQUEST WILL CAUSE THE IOCDS
                                            DATA SET LEVEL TO BE MARKED
                                            INVALID
              00000010       PCRIOCPW       X'10' PCRIOCPW IOCP OPEN WRITE
                                            REQUEST STARTED; WHEN THIS
                                            REQUEST IS ACTIVATED SEND A
                                            MESSAGE THAT THAT THE IOCDS DATA
                                            SET WILL BE ALTERED (MARKED
                                            INVALID)
              00000000       PCRNODS        X'00' PCRNODS FLAG TO SHOW THAT
                                            NO IOCDS DATASET IS CURRENTLY
                                            BEING ALTERED NOTES : CODES
                                            DEFINED FOR PCRRPCIF BY HCPSYSCM
                                            SYSRPCIF
    000A   10 Bitstring    1 PCRRPCIF       PROCESSOR CONTROLLER INTERFACE
                                            USED FOR REAL REQUEST PROCESSING
    000B   11 Bitstring    1 PCRCMDIX       SUPPORTED REAL PC COMMAND TABLE
                                            INDEX associated with tables in
                                            HCPPCA and HCPPCB
              00000000       PCRCMDNO       0 PCRCMDNO NO PC COMMANDS
                                            IDENTIFIED
              00000004       PCRCMDIR       4 PCRCMDIR IOCP READ
              00000008       PCRCMDIW       8 PCRCMDIW IOCP WRITE
              0000000C       PCRCMDPN       12 PCRCMDPN VARY CENTRAL
                                            PROCESSOR ON OR CONFIGURE CPU
              00000010       PCRCMDPF       16 PCRCMDPF VARY CENTRAL
                                            PROCESSOR OFF OR DECONFIGURE CPU
              00000014       PCRCMDSC       20 PCRCMDSC READ SCPINFO
              00000018       PCRCMDXS       24 PCRCMDXS READ EXPANDED STORE
                                            USABILITY MAP
              0000001C       PCRCMDXI       28 PCRCMDXI READ EXPANDED STORAGE
                                            ELEMENT INFORMATION
              00000020       PCRCMDSF       32 PCRCMDSF In use in O.C.O. part
                                            HCPPCB
              00000028       PCRCMDCC       40 PCRCMDCC Configure Channel
                                            Path
              0000002C       PCRCMDDC       44 PCRCMDDC Deconfigure Channel
                                            Path
              00000030       PCRCMDWM       48 PCRCMDWM Write Event Mask
              00000034       PCRCMDWE       52 PCRCMDWE Write Event Data
              00000038       PCRCMDRE       56 PCRCMDRE Read Event Data
              0000003C       PCRCMDRC       60 PCRCMDRC Read Channel Path
                                            information
              00000040       PCRCMDXX       64 PCRCMDXX Read Expanded Storage
                                            Usability Bit Map Extended
              00000044       PCRCMDSS       68 PCRCMDSS Read Storage Status
              00000070       PCRCMDCA       112 PCRCMDCA In use in part
                                            HCPPCB
              00000074       PCRCMDDA       116 PCRCMDDA In use in part
                                            HCPPCB
    000C   12 Address      4 PCRREG13       SAVEAREA ADDRESS USED TO COMPLETE
                                            A CP REQUEST
    0010   16 Address      4 PCRRDBKA       REAL PROCESSOR CONTROLLER DATA
                                            BLOCK ADDRESS POINTER
    0014   20 Address      4 PCRVDBKA       VIRTUAL PROCESSOR CONTROLLER DATA
                                            BLOCK ADDRESS POINTER FOR VIRTUAL
                                            MACHINE REQUEST
    0018   24 Address      4 PCRGDBKA       Host logical addr of guest SCCB
    001C   28 Address      4 *              Reserved for IBM use
    0020   32 Dbl-Word     8 *              Reserved for IBM use
    0028   40 Signed       4 PCRCMDWD (0)   PROCESSOR CONTROLLER COMMAND WORD
    0028   40 Bitstring    2 PCRCCODE       COMMAND CODE
              00000002       PCDSCPIN       X'0002' PCDSCPIN SCP INFO
              00000003       PCDCHPIN       X'0003' PCDCHPIN CHANNEL PATH
                                            INFO
              0000000F       PCDVYCHN       X'000F' PCDVYCHN VARY CHANNEL
                                            PATH ON
              00000010       PCDVYCPF       X'0010' PCDVYCPF VARY PROCESSOR
                                            (CPU) OFF
              00000011       PCDVYCPN       X'0011' PCDVYCPN VARY PROCESSOR
                                            (CPU) ON
              00000040       PCDICPWT       X'0040' PCDICPWT IOCP WRITE
              00000041       PCDICPRD       X'0041' PCDICPRD IOCP READ END OF
                                            DEFINITION COMMAND DEPENDENT CODE
                                            BYTE
              00000002       PCCSCPCM       X'0002' PCCSCPCM READ SCP INFO
              00000003       PCCCPICM       X'0003' PCCCPICM STORE CHANNEL
                                            PATH INFO
              00000009       PCCRSSCM       X'0009' PCCRSSCM Read Storage
                                            Status
              0000000E       PCCDCHCM       X'000E' PCCDCHCM Deconfigure
                                            channel path
              0000000F       PCCCCHCM       X'000F' PCCCCHCM Configure
                                            channel path
              00000010       PCCDCPCM       X'0010' PCCDCPCM DECONFIGURE CPU
              00000011       PCCVCPCM       X'0011' PCCVCPCM CONFIGURE CPU
              0000001C       PCCRCSCM       X'001C' PCCRCSCM Read
                                            channel-subsystem info
              0000001E       PCCDAPCM       X'001E' PCCDAPCM Deconfigure AP
              0000001F       PCCCAPCM       X'001F' PCCCAPCM Configure AP
              00000023       PCCXUECM       X'0023' PCCXUECM Read expanded
                                            storage usability map extended
              00000024       PCCXEICM       X'0024' PCCXEICM READ EXTENDED
                                            STORE ELEMENT INFO
              00000025       PCCXUMCM       X'0025' PCCXUMCM READ EXTENDED
                                            STORE USABILITY MAP
              00000040       PCCWRDCM       X'0040' PCCWRDCM WRITE MODEL
                                            DEPENDENT DATA
              00000041       PCCRDDCM       X'0041' PCCRDDCM READ MODEL
                                            DEPENDENT DATA
              00000076       PCCWEDCM       X'0076' PCCWEDCM Write Event Data
              00000077       PCCREDCM       X'0077' PCCREDCM Read Event Data
              00000078       PCCWEMCM       X'0078' PCCWEMCM Write Event Mask
    002A   42 Bitstring    1 PCRDCODE       COMMAND DEPENDENT CODE
              00000000       PCDCMDVR       X'00' PCDCMDVR VERIFY CHANNEL
                                            PATH INFO AND SCPINFO COMMANDS
              00000003       PCDCPMAX       X'03' PCDCPMAX MAXIMUM CPU
                                            ADDRESS END OF DEFINITION
                                            IDENTIFICATION CODE BYTE
              00000000       PCCSCPPM       X'00' PCCSCPPM READ SCP INFO
              00000000       PCCCPIPM       X'00' PCCCPIPM STORE CHANNEL PATH
                                            INFO END OF DEFINITION
                                            COMMAND-CLASS CODES
    002B   43 Bitstring    1 PCRIDBYT       IDENTIFICATION BYTE
              00000002       PCDIOCP        X'02' PCDIOCP IOCP COMMAND
              00000001       PCDCONFG       X'01' PCDCONFG CONFIGURATION
                                            COMMAND END OF DEFINITION
              00000001       PCCCNFIG       X'01' PCCCNFIG CONFIGURATION
                                            COMMAND CLASS
              00000002       PCCIOCP        X'02' PCCIOCP IOCP COMMAND CLASS
              00000005       PCCWTOFC       X'05' PCCWTOFC
                                            Write-to-Operator-Facility
                                            Command class END OF DEFINITION
    002C   44 Address      4 PCRVMDBK       REQUESTOR'S VMDBK ADDRESS
    0030   48 Address      4 PCRVMBAS       REQUESTOR'S BASE VMDBK ADDRESS
    0034   52 Signed       4 *              RESERVED FOR FUTURE IBM USE
              00000007       PCRSIZE        (*-PCRBK+7)/8 :SIZE OF BLOCK IN
                                            DOUBLE WORDS

PCRBK Storage Layout | Top of page

    *** PCRBK - PROCESSOR CONTROLLER REQUEST BLOCK
    *
    *     +---------------------------+---------------------------+
    *   0 |         PCRFPTR           |         PCRBPTR           |
    *     +------+------+------+------+---------------------------+
    *   8 |:FLAG |:DSIVL|:RPCIF|:CMDIX|         PCRREG13          |
    *     +------+------+------+------+---------------------------+
    *  10 |         PCRRDBKA          |         PCRVDBKA          |
    *     +---------------------------+---------------------------+
    *  18 |         PCRGDBKA          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  20 |///////////////////////////////////////////////////////|
    *     +-------------+------+------+---------------------------+
    *  28 |  PCRCCODE   |:DCODE|:IDBYT|         PCRVMDBK          |
    *     +-------------+------+------+---------------------------+
    *  30 |         PCRVMBAS          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  38
    *
    *** PCRBK - PROCESSOR CONTROLLER REQUEST BLOCK

PCRBK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    PCCCAPCM       0028 0000001F
    PCCCCHCM       0028 0000000F
    PCCCNFIG       002B 00000001
    PCCCPICM       0028 00000003
    PCCCPIPM       002A 00000000
    PCCDAPCM       0028 0000001E
    PCCDCHCM       0028 0000000E
    PCCDCPCM       0028 00000010
    PCCIOCP        002B 00000002
    PCCRCSCM       0028 0000001C
    PCCRDDCM       0028 00000041
    PCCREDCM       0028 00000077
    PCCRSSCM       0028 00000009
    PCCSCPCM       0028 00000002
    PCCSCPPM       002A 00000000
    PCCVCPCM       0028 00000011
    PCCWEDCM       0028 00000076
    PCCWEMCM       0028 00000078
    PCCWRDCM       0028 00000040
    PCCWTOFC       002B 00000005
    PCCXEICM       0028 00000024
    PCCXUECM       0028 00000023
    PCCXUMCM       0028 00000025
    PCDCHPIN       0028 00000003
    PCDCMDVR       002A 00000000
    PCDCONFG       002B 00000001
    PCDCPMAX       002A 00000003
    PCDICPRD       0028 00000041
    PCDICPWT       0028 00000040
    PCDIOCP        002B 00000002
    PCDSCPIN       0028 00000002
    PCDVYCHN       0028 0000000F
    PCDVYCPF       0028 00000010
    PCDVYCPN       0028 00000011
    PCRBPTR        0004
    PCRCCODE       0028
    PCRCMDCA       000B 00000070
    PCRCMDCC       000B 00000028
    PCRCMDDA       000B 00000074
    PCRCMDDC       000B 0000002C
    PCRCMDIR       000B 00000004
    PCRCMDIW       000B 00000008
    PCRCMDIX       000B
    PCRCMDNO       000B 00000000
    PCRCMDPF       000B 00000010
    PCRCMDPN       000B 0000000C
    PCRCMDRC       000B 0000003C
    PCRCMDRE       000B 00000038
    PCRCMDSC       000B 00000014
    PCRCMDSF       000B 00000020
    PCRCMDSS       000B 00000044
    PCRCMDWD       0028
    PCRCMDWE       000B 00000034
    PCRCMDWM       000B 00000030
    PCRCMDXI       000B 0000001C
    PCRCMDXS       000B 00000018
    PCRCMDXX       000B 00000040
    PCRCPREQ       0008 40
    PCRDCODE       002A
    PCRDSIVL       0009
    PCRFLAG        0008
    PCRFPTR        0000
    PCRGDBKA       0018
    PCRIDBYT       002B
    PCRIOCPW       0009 00000010
    PCRNODS        0009 00000000
    PCRNORET       0008 20
    PCRRDBKA       0010
    PCRREG13       000C
    PCRRPCIF       000A
    PCRSIZE        0034 00000007
    PCRVDBKA       0014
    PCRVMBAS       0030
    PCRVMDBK       002C
    PCRVMREQ       0008 80
    PDRARDAT       0008 00
    PDRGDMAX       0008 00
    PXMDEFER       0008 04
    PXMOK          0008 00
    PXMREJCT       0008 08
    PXMWAIT        0008 0C
    SASCPARC       0008 04
    SASCPCAP       0008 03

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:29:39 EDT.
Copyright IBM Corporation, 1990, 2020