CONTROL BLOCK NAME = DFHWSMDS
NAME OF MATCHING PLS CONTROL BLOCK = None
DESCRIPTIVE NAME = CICS TS (XRF) - CAVM State Management
Record Description
Licensed Materials - Property of IBM
Restricted Materials of IBM
5655-Y04
(C) Copyright IBM Corp. 1985, 1994
FUNCTION =
This control block defines the format of the State
Management Record in the CAVM Control Data Set, which
is used to keep track of what CICS jobs are signed on
to CAVM and their current state (ACTIVE, normal BACKUP,
BACKUP performing TAKEOVER, etc.).
There is one State Management Record in each CAVM
Control Data Set. It contains just one instance of
SMDESCR and instances of WSJDESC for each ACTIVE or
BACKUP job which CAVM will allow to sign on concurrently
using that particular CAVM Control Data Set. The instance
of WSJDESC which immediately follows SMDESCR always refers
to the ACTIVE job.
LIFETIME =
The State Management Record is created by DFHWSSN3 when it
formats a new CAVM Control Data Set and is initialised by
DFHWSSN2 during the first successful SIGNON.
It is never destroyed except by deletion of the data set.
STORAGE CLASS =
This control block resides on DASD in the CAVM Control
Data Set or in an I/O buffer or work area in MVS subpool
0 above the 16M line.
LOCATION =
Field WFGSMRBA in the CAVM File Control Block (DFHWFGDS)
contains the RBA of the State Management Record within
the CAVM Control Data Set. It is always the second CI
in the data set.
INNER CONTROL BLOCKS =
None.
NOTES :
DEPENDENCIES = S/370
RESTRICTIONS =
None.
MODULE TYPE = Control block definition
--------------------------------------------------------------------
EXTERNAL REFERENCES =
None.
DATA AREAS =
None.
CONTROL BLOCKS =
None.
GLOBAL VARIABLES (Macro pass) =
None.
--------------------------------------------------------------------
Table 1.
Offset Hex |
Type |
Len |
Name (Dim) |
Description |
(0) |
STRUCTURE |
0 |
SMDESCR |
State Management Record Global Data |
(0) |
FULLWORD |
4 |
SMDSECCT |
Security count updated whenever the State Management Record is updated |
(4) |
FULLWORD |
4 |
SMDINST# |
Instance Number assigned to last system which signed on (ACTIVE or BACKUP) |
(8) |
CHARACTER |
8 |
SMDAI#V# (0) |
Last ACTIVE instance & version |
(8) |
FULLWORD |
4 |
SMDAINST |
Instance no. of current (or last) ACTIVE system |
(C) |
FULLWORD |
4 |
SMDAVERN |
Version no. of current (or last) ACTIVE system |
(10) |
DBL WORD |
8 |
SMDR#TOD (0) |
Array of resource time-stamps |
(10) |
DBL WORD |
8 |
SMDR1TOD |
Time-stamp for resource set R1 - estimated reading of last updater's TOD clock when he signed off from CAVM |
(18) |
DBL WORD |
8 |
SMDR2TOD |
Time-stamp for resource set R2 - estimated reading of last updater's TOD clock when his job terminated |
(20) |
HALFWORD |
2 |
SMDR#NDX (0) |
Array of resource ownership indices in same order as time-stamps |
(20) |
HALFWORD |
2 |
SMDR1NDX |
Index to the job description of the current owner of resource set R1 or 1's complement of last owner's index if R1 is free |
(22) |
HALFWORD |
2 |
SMDR2NDX |
Index to the job description of the current owner of resource set R2 or 1's complement of last owner's index if R2 is free |
(24) |
HALFWORD |
2 |
SMDTKNDX |
Index to the job description of the BACKUP which is performing TAKEOVER or 1's complement of index of last BACKUP to attempt it |
(26) |
HALFWORD |
2 |
SMD#JOBS |
Number of job descriptions in the State Management Record |
(28) |
DBL WORD |
8 |
SMDSMJ0 (0) |
Start of ACTIVE's job description |
(28) |
..1. 1... |
|
SMDL |
"*-SMDESCR" |
Table 2.
Offset Hex |
Type |
Len |
Name (Dim) |
Description |
(0) |
STRUCTURE |
0 |
WSJDESC |
State Management Record Job Description |
(0) |
CHARACTER |
8 |
WSJSAPPL |
Specific APPLID |
(8) |
CHARACTER |
8 |
WSJOBNAM |
Job Name |
(10) |
CHARACTER |
8 |
WSJOBID |
JES Job Identifier |
(10) |
...1 1... |
|
WSJS1END |
"*" |
(8) |
CHARACTER |
16 |
WSJOBNID |
(18) |
FULLWORD |
4 |
WSJSTIME |
Job submission time (from JMR) |
(1C) |
FULLWORD |
4 |
WSJSDATE |
Job submission date (from JMR) |
(20) |
FULLWORD |
4 |
WSJATIME |
Time when job-step task was ATTACHed |
(24) |
CHARACTER |
4 |
WSJSSNAM |
MVS subsystem name of job's JES |
(28) |
CHARACTER |
12 |
WSJMVSID |
MVS system instance - SMF ID and time & date of IPL |
(28) |
..11 .1.. |
|
WSJS2END |
"*" |
(24) |
CHARACTER |
16 |
WSJMVSIJ |
(34) |
CHARACTER |
8 |
WSJCANNM |
Name to use in MVS CANCEL command to cancel this job (from CSCB) |
(3C) |
HALFWORD |
2 |
WSJASID |
ASID of job's address space |
(3C) |
..11 111. |
|
WSJS3END |
"*" |
(8) |
CHARACTER |
54 |
WSJOBSTI |
(3E) |
CHARACTER |
1 |
WSJSIND |
System Indicator |
(3E) |
1... .... |
|
WSJXCFA |
"X'80'" XCF available in MVS release |
(3F) |
FULLWORD |
1 |
WSJSTAT |
Job status - signed on, signed off normally or signed off abnormally |
(40) |
DBL WORD |
8 |
WSJSNTOD |
TOD clock reading when CAVM SIGNON processing started |
(48) |
CHARACTER |
4 |
WSJRST (0) |
Restart information field |
(48) |
CHARACTER |
3 |
WSJEYECA |
Restart Eyecatcher '>RS' |
(4B) |
CHARACTER |
1 |
WSJRSTYP |
Restart type indicator |
(4B) |
.... ...1 |
|
WSJRSJOB |
"X'01'" Restart as JOB |
(4B) |
.... ..1. |
|
WSJRSSTC |
"X'02'" Restart as Started Task |
(4C) |
FULLWORD |
4 |
|
Spare |
(50) |
DBL WORD |
8 |
(0) |
Force length to double word multiple |
(50) |
.1.1 .... |
|
WSJLVER1 |
"*-WSJDESC" Len of pre-CICS/ESA 3.2 job desc |
(50) |
CHARACTER |
8 |
WSJSPLX |
XCF Sysplex Name |
(58) |
CHARACTER |
8 |
WSJSNAM |
MVS Sytem name |
(60) |
CHARACTER |
4 |
WSJSTOK |
MVS System Instance token |
(68) |
DBL WORD |
8 |
(0) |
Force length to double word |
(68) |
.11. 1... |
|
WSJS4END |
"*" |
(50) |
CHARACTER |
24 |
WSJXCFD |
XCF Details |
(58) |
CHARACTER |
16 |
WSJSDET |
MVS System details |
(58) |
.11. 1... |
|
WSJL |
"*-WSJDESC" Len of CICS/ESA 3.2 job desc. |
The following DSECT describes the control CI of the CAVM control
and message datasets. All the fields are set by DFHWSSN3 when
it opens a new pair of CAVM datasets for the first time and the
contents are verified on all subsequent SIGNON's.
Table 3.
Offset Hex |
Type |
Len |
Name (Dim) |
Description |
(0) |
STRUCTURE |
0 |
CTLREC |
Control CI description |
(0) |
FULLWORD |
4 |
CTLVER# |
CAVM dataset version number CTLVER# = 1 --> Pre CICS 3.2 CTLVER# = 2 --> CICS 3.2 |
(4) |
FULLWORD |
4 |
(8) |
CHARACTER |
8 |
CTLDDN |
CAVM DD name (CDS or MDS ?) |
(10) |
CHARACTER |
8 |
CTLGAPPL |
Generic applid initialised for |
(18) |
CHARACTER |
20 |
CTLUNQID |
TOD d/s initialised plus MVS id |
(18) |
..1. 11.. |
|
CTLRECL |
"*-CTLREC" |