WDG - XRF Process block
CONTROL BLOCK NAME = DFHWDGPS
DESCRIPTIVE NAME = CICS TS (XRF) Process Block
Licensed Materials - Property of IBM
Restricted Materials of IBM
5655-Y04
(C) Copyright IBM Corp. 1985
FUNCTION =
XRF process dispatcher control area.
There is a single instance of this control block in
a CICS system which has successfully signed on to XRF.
It contains state information for the XRF process
dispatcher such as the currently dispatched process,
head and tail of the chain of extant processes etc..
LIFETIME =
Created by INIT_ATTACH (DFHWDINA) and destroyed when
XRF TCB terminates.
STORAGE CLASS =
Non-CICS storage. MVS subpool 0 storage above 16M line.
LOCATION =
Address is in WCGDA in XRF Global area DFHWCGPS.
INNER CONTROL BLOCKS =
WDGP
Definition of internal dispatcher parameter block format.
WDGLOCKH
Lock hierarchy table (set up by DFHWDINA).
NOTES :
DEPENDENCIES = S/370
RESTRICTIONS =
None
MODULE TYPE = Control block definition
------------------------------------------------------------------
EXTERNAL REFERENCES =
DATA AREAS =
None
CONTROL BLOCKS =
None
GLOBAL VARIABLES (Macro pass) =
None
------------------------------------------------------------------
Fixed part of Dispatcher Global Area (in XRF Global area)
| Offset Hex | Type | Len | Name (Dim) | Description |
|---|---|---|---|---|
| (0) | STRUCTURE | 120 | DFHWDGPS | Addressed from WS Global |
| (0) | CHARACTER | 64 | WDGEXTNL | This substructure contains data which are maintained across dispatcher calls |
| (0) | ADDRESS | 4 | WDGFXPB | First process in dispatch chain. |
| (4) | ADDRESS | 4 | WDGLXPB | Last process in dispatch chain. |
| (8) | ADDRESS | 4 | WDGCXPB | Currently dispatched process. |
| (C) | ADDRESS | 4 | WDGIAR13 | Save slot for Reg 13 of issuer of INIT_ATTACH |
| (10) | ADDRESS | 4 | WDGESTA | ESTAE PARAM area |
| (14) | ADDRESS | 4 | WDGESPA | ESPIE PARAM area |
| (18) | ADDRESS | 4 | * (2) | Reserved |
| (20) | BIT(32) | 4 | WDGGLKSM | Granted locks mask |
| (24) | HALFWORD | 2 | WDGXPBNO | Last allocated process id |
| (26) | HALFWORD | 2 | * | Reserved |
| (28) | CHARACTER | 24 | WDGXPB | Space for the base part of a dummy XPB used by the dispatcher for tracing |
| (40) | CHARACTER | 56 | WDGLOCAL | This substructure contains data which are local to a single dispatcher call |
| (40) | BIT(32) | 4 | WDGLKACC | Lock table work area used by DFHWDINA. |
| (40) | BIT(32) | 4 | WDGLKTMP | Lock temporary used by DFHWDWAT. |
| (44) | HALFWORD | 2 | * | Reserved |
| (46) | HALFWORD | 2 | WDGWLL | Number items in WAIT list |
| (46) | HALFWORD | 2 | WDGLKI | Lock level counter |
| (48) | ADDRESS | 4 | WDGWL (12) | WAIT List |
| (78) | CHARACTER | 0 | WDGEND | End of fixed part of area |
Dispatcher internal parameter block.
| Offset Hex | Type | Len | Name (Dim) | Description |
|---|---|---|---|---|
| (0) | STRUCTURE | 12 | WDGP | |
| (0) | FULLWORD | 4 | WDGPID | Request identifier |
| (4) | ADDRESS | 4 | WDGPEPRM | ESPIE/ESTAE parameter |
| (4) | ADDRESS | 4 | WDGPEDA | Error data - SDWA or EPIE |
| (8) | ADDRESS | 4 | WDGPSRPA | SRP Area address |
| (8) | ADDRESS | 4 | WDGPIDA | ATTACH initial data |
| (8) | ADDRESS | 4 | WDGPNPSW | New IA for retry PSW |
Constants
| Len | Type | Value | Name | Description |
|---|---|---|---|---|
Request IDs (values for WDGPID). |
||||
| 4 | DECIMAL | 0 | WDGPSINT | Initialize DFHWDSRP |
| 4 | DECIMAL | 1 | WDGPSTRM | Terminate DFHWDSRP |
| 4 | DECIMAL | 2 | WDGPSESP | ESPIE |
| 4 | DECIMAL | 3 | WDGPSEST | ESTAE |
Lock and event record values |
||||
| 4 | HEX | 00000000 | WDGNOEVS | All events set OFF |
| 4 | HEX | FFFFFFFF | WDGALEVS | All events set ON |
| 4 | HEX | 00000000 | WDGNOLKS | All locks set OFF |
| 4 | HEX | FFFFFFFF | WDGALLKS | All locks set ON |