SSX - Subsystem communication vector table extension
Name : DCLSSX
Function:
This segment maps the Subsystem Extension block (SSX) for the subsystem. The SSX
IEFJSCVT control block is addressed via the SSCTSUSE pointer of the SSCT block
mapped by the macro. In some cases there are two SSX blocks, the current, active SSX
addressed via SSCTSUSE, and the old, inactive SSX addressed by SSCTSUS2. The SSX
block is allocated inCSA (subpool 241) in key 0 storage. The SSX block is built by the EQQINIT
module during Master Scheduler initialization, or by EQQMAJOR during subsystem initialization
when the BUILDSSX keyword has been specified. The active SSX block is freed and the
inactive SSX is made active during EQQMAJOR termination when there is an inactive SSX.
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 0 | (0) | STRUCTURE | 1664 | SSX | ssvt extension block |
SSX block identifier and code level
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 0 | (0) | CHARACTER | 4 | SSXDESC | block descriptor = 'SSX ' |
| 4 | (4) | CHARACTER | 10 | SSXLEVEL | SSX block code level |
| 4 | (4) | CHARACTER | 2 | SSXVER | block mapping version |
| 6 | (6) | CHARACTER | 8 | SSXFMID | OPCESA tracker fmid |
| 14 | (E) | SIGNED | 2 | SSXSIZE | size of the SSX block |
Status and option flags
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 16 | (10) | BITSTRING | 2 | SSXFLAGS | subsystem status flags |
|
SSXJHOLD | 1 holdjob(yes) requested | |||
|
SSXSTEPS | 1 generate all step events | |||
|
SSXJSUB | 1 job submission active | |||
|
SSXJCHLD | 1 jcc wants held data | |||
|
SSXETT | 1 ett function active | |||
|
SSXHGHCC | 1 use highest cc for a job | |||
|
SSXLSTCC | 1 use last exec step's cc | |||
|
SSXUHOLD | 1 holdjob(user) requested | |||
| 17 | (11) | |
SSXNZERO | 1 gen only nzero cc step events | |
|
SSXAR | 1 auto recovery task is active | |||
|
SSXGDGNS | 1 GDG_NONST | |||
|
SSXWRN | 1 JES sp-lvl warn msg issued | |||
|
SSXDIAE1 | 1 diagnose event wanted | |||
|
SSXSRSRC | 1 SR.SRNAME is a resource | |||
|
SSXFTWJSUB | 1 opc will submit jobs | |||
|
SSXRPASS | 1 RCLPASS = YES | |||
| 18 | (12) | BITSTRING | 4 | SSXFLAG2 | more status flags |
|
SSXWRN1 | 1 JES exit51 warn msg iss. | |||
|
SSXRLWST | rl.wsstat subresource | |||
|
SSXRLWSN | rl.wsname subresource | |||
|
SSXFIPL | 1 no dslst loaded for IPL | |||
|
SSXRLADN | rl.adname subresource | |||
|
SSXEMDEB | Debug in ZEVSX | |||
|
SSXJCC | 1 JCC started | |||
|
SSXSSCBIG | 1 SSC big buffer | |||
| 19 | (13) | |
SSXSINFO | 1 stepinfo(yes) | |
| 22 | (16) | CHARACTER | 1 | SSXJES | JES type A=JES2, B=JES3 |
| 23 | (17) | CHARACTER | 1 | SSXCJES | JES command character |
| 24 | (18) | CHARACTER | 8 | SSXNODE | own nje node name |
EQQSSCM load module management
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 32 | (20) | CHARACTER | 16 | SSXSSCM_CUR | current eqqsscm load module |
| 32 | (20) | CHARACTER | 8 | SSXCMNAME | eqqsscm load module name |
| 40 | (28) | ADDRESS | 4 | SSXCMCATP | eqqsscm entry point address |
| 44 | (2C) | ADDRESS | 4 | SSXCMSSRX | address of eqqzssrx |
| 48 | (30) | CHARACTER | 16 | SSXSSCM_IPL | previously loaded eqqsscm |
| 48 | (30) | CHARACTER | 8 | SSXCMNAME | |
| 56 | (38) | ADDRESS | 4 | SSXCMCATP | |
| 60 | (3C) | ADDRESS | 4 | SSXCMSSRX | |
Allocated resources
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 64 | (40) | ADDRESS | 4 | SSXAREAS | chain of allocated csa areas |
| 68 | (44) | ADDRESS | 4 | SSXEVTQ | event wtr queue address |
| 72 | (48) | ADDRESS | 4 | SSXSSCMA | perm loaded eqqsscm module addr |
| 76 | (4C) | SIGNED | 4 | SSXSSCMS | perm loaded eqqsscm module size |
| 80 | (50) | ADDRESS | 4 | SSXNF57A | EQQZNF57 address |
| 84 | (54) | SIGNED | 4 | SSXNF57S | EQQZNF57 size |
SSX label offsets above this point are fixed The only
change allowed is defining a bit in an existing flag byte or
modifing one of the SSX level constants
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 88 | (58) | CHARACTER | SSX_END_FIXED | end of fixed ssx mapping | |
Control Block addresses
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 88 | (58) | ADDRESS | 4 | SSXMCAP | addr of mca in opc addr space |
| 92 | (5C) | ADDRESS | 4 | SSXASCB | opc ascb address |
| 96 | (60) | ADDRESS | 4 | SSXSSCT | opc scvt address |
| 100 | (64) | ADDRESS | 4 | SSXSDEPP | ptr to EW SDEP parms |
| 104 | (68) | ADDRESS | 4 | SSXDSNEW | data set trigger table |
| 108 | (6C) | ADDRESS | 4 | SSXNF41A | EQQZNF41 address |
| 112 | (70) | SIGNED | 4 | SSXNF41S | EQQZNF41 size |
| 116 | (74) | ADDRESS | 4 | SSXNF53A | EQQZNF53 address |
| 120 | (78) | SIGNED | 4 | SSXNF53S | EQQZNF53 size |
| 124 | (7C) | SIGNED | 4 | * (3) | reserved |
SSC storage management addresses
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 136 | (88) | ADDRESS | 4 | SSXSSCC | addr of first SSC block |
| 140 | (8C) | ADDRESS | 4 | SSXSSCFR | addr of first free SSC |
TWS storage management addresses
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 144 | (90) | CHARACTER | 8 | SSXTWSSERVERNAME | TWS Server Name |
bin31 reserved
DBCS options
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 152 | (98) | CHARACTER | 8 | SSXDBCS | dbcs options |
| 152 | (98) | CHARACTER | 2 | SSXSORTO | dbcs sort algorithm |
| 154 | (9A) | CHARACTER | 1 | SSXADIDF | dbcs adid option D or E |
| 155 | (9B) | CHARACTER | 1 | SSXOWIDF | dbcs owner option D or E |
| 156 | (9C) | CHARACTER | 4 | * | reserved |
Miscellaneous fields
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 160 | (A0) | CHARACTER | 8 | SSXSJID | started task job number |
| 168 | (A8) | CHARACTER | 8 | SSXSJNM | started task job name |
| 176 | (B0) | CHARACTER | 4 | SSXSID | MVS system id |
| 180 | (B4) | CHARACTER | 4 | SSXSSNM | submitting subsystem name |
| 184 | (B8) | CHARACTER | 8 | SSXCLAS | RACF resource class name |
| 192 | (C0) | CHARACTER | 16 | SSXJCCLS | JCC sysout classes |
| 208 | (D0) | CHARACTER | 1 | SSXPRTEV | prtev N=no, ' '=end, A=all |
| 209 | (D1) | CHARACTER | 1 | SSXJES3 | JES3 type G=Global, L=Local |
| 210 | (D2) | CHARACTER | 1 | * | free |
| 211 | (D3) | CHARACTER | 1 | * | free |
| 212 | (D4) | CHARACTER | 8 | SSXJFMID | JES fmid |
| 220 | (DC) | CHARACTER | 4 | SSXDIAJN | diagnose JOBSTC name |
| 224 | (E0) | BITSTRING | 4 | SSXIECB | JES input service ECB |
| 228 | (E4) | BITSTRING | 4 | SSXEECB | JES execution ECB |
| 232 | (E8) | UNSIGNED | 4 | SSXPTKN | current MGCR ptoken |
| 236 | (EC) | SIGNED | 4 | SSXSDTR | used as indicator only |
| 240 | (F0) | SIGNED | 4 | SSXUTIME | time of last uerror event |
| 244 | (F4) | SIGNED | 4 | SSXATIME | time of last aerror event |
| 248 | (F8) | SIGNED | 4 | SSXSZNEW | size of DS trigger table |
| 252 | (FC) | SIGNED | 4 | * | reserved |
| 256 | (100) | SIGNED | 4 | SSXRTOKA | addr space res mgr token |
| 260 | (104) | SIGNED | 4 | SSXRTOKT | task level res mgr token |
| 264 | (108) | SIGNED | 4 | SSX_PIF_CW | pif cw base year |
| 268 | (10C) | CHARACTER | 6 | SSX_PIF_HD | pif high date format |
| 274 | (112) | CHARACTER | 5 | SSXCLNJOB | stand alone jobname prefix |
| 279 | (117) | CHARACTER | 1 | * | reserved |
OPC Queue Addresses
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 280 | (118) | CHARACTER | 104 | SSXQTABLE | OPC queue addresses |
| 280 | (118) | ADDRESS | 4 | * (26) | array of queue addresses |
OPC Queue Server blocks
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 384 | (180) | CHARACTER | 48 | SSXQUES (26) | queue server blocks mapped by dclque |
| 1632 | (660) | CHARACTER | 32 | * | reserved slack space |
| 1664 | (680) | CHARACTER | SSXEND | end of ssx | |
OPC Queue array mapping
When adding a new queue pointer do not reuse a used array entry
The maximum array index that can be used is defined by ssxnumq
Increased ssxnumq for future development
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 280 | (118) | STRUCTURE | 104 | SSXQPTRS | array of queue addresses |
| 280 | (118) | ADDRESS | 4 | * | reserved by event writer 1 |
| 284 | (11C) | ADDRESS | 4 | SSXGENQ | gen service queue 2 |
| 288 | (120) | ADDRESS | 4 | SSXJCCQ | jcc service queue 3 |
| 292 | (124) | ADDRESS | 4 | SSXMGRQ | event mgr queue 4 |
| 296 | (128) | ADDRESS | 4 | SSXMSGQ | major msg queue 5 |
| 300 | (12C) | ADDRESS | 4 | SSXAPPQ | appc queue 6 |
| 304 | (130) | ADDRESS | 4 | SSXRTRQ | router queue 7 |
| 308 | (134) | ADDRESS | 4 | SSXTIPQ | tcpip queue (ex CatMgt) 8 |
| 312 | (138) | ADDRESS | 4 | SSXSUBQ | job submit queue 9 |
| 316 | (13C) | ADDRESS | 4 | SSXNCFQ | ncf queue 10 |
| 320 | (140) | ADDRESS | 4 | SSXEXQ | exa queue 11 |
| 324 | (144) | ADDRESS | 4 | * | free 12 |
| 328 | (148) | ADDRESS | 4 | SSXRODQ | rodm queue 13 |
| 332 | (14C) | ADDRESS | 4 | SSXATRQ | appc tracker queue 14 |
| 336 | (150) | ADDRESS | 4 | SSXSRVQ | Server queue 15 |
| 340 | (154) | ADDRESS | 4 | SSXARCQ | FL task queue 16 |
| 344 | (158) | ADDRESS | 4 | SSXPSUQ | PSU task queue 17 |
| 348 | (15C) | ADDRESS | 4 | SSXTWSQ | TWS task queue 18 |
| 352 | (160) | ADDRESS | 4 | SSXMONQ | MON task queue 19 |
| 356 | (164) | ADDRESS | 4 | SSXCPHQ | CPH task queue 20 |
| 360 | (168) | ADDRESS | 4 | SSXMAJQ | major queue 21 |
| 364 | (16C) | ADDRESS | 4 | SSXHTTQ | HTTP task queue 22 |
| 368 | (170) | ADDRESS | 4 | SSXBTPQ | BT task queue 23 |
| 372 | (174) | ADDRESS | 4 | SSXBKPQ | BKP task queue 24 |
| 376 | (178) | ADDRESS | 4 | * (2) | free for future 25-26 |
Some SSX constants
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name (Dim) | Description |
| 0 | (0) | STRUCTURE | 24 | SSXSDEPF | SDEPFILTER options |
| 0 | (0) | SIGNED | 2 | SSXSDSTART | - start point (offset) |
| 2 | (2) | SIGNED | 2 | SSXSDLEN | - value length |
| 4 | (4) | CHARACTER | 20 | SSXSDVAL | - value |