CONTROL BLOCK NAME = DFHAPSTG
DESCRIPTIVE NAME = CICS TS AP Statistics Global Storage Block
Licensed Materials - Property of IBM
Restricted Materials of IBM
5655-Y04
(C) Copyright IBM Corp. 1987, 2016
FUNCTION = This control block contains the time at which AP dom-
ain statistics were last reset and also a map of statistics res-
ource types, statistics modules, module entry points and module
status to enable DFHAPST to manage the collection of statistics
in the AP domain.
This module is part of the APPLICATION DOMAIN (AP).
This control block is created the first time that DFHAPST is
called to perform a statistics function in the AP domain. The
control block persists until CICS is shutdown (whether literally
or 'logically' via the 'end-of-day' command).
LIFETIME = This control block is created by DFHAPST the first
time it is called. The control block is not explicitly deleted
by DFHAPST but the pointer to it is lost when CICS is terminated.
STORAGE CLASS = n/a
LOCATION = The address field CSAAPSTG in the CSAOPFL points
to the beginning of this control block.
INNER CONTROL BLOCKS = none
NOTES :
DEPENDENCIES = S/370
RESTRICTIONS = n/a
MODULE TYPE = Control block definition
------------------------------------------------------------------
EXTERNAL REFERENCES = none
DATA AREAS = none
CONTROL BLOCKS = none
GLOBAL VARIABLES (Macro pass) = none
------------------------------------------------------------------
Standard header tag so that the block can be found in
storage.
Last-reset-time field which contains the time in MVS
STCK format when statistics counters in the AP domain
were last reset.
A map of:
Restype---->
Module---->
Entry point---->
Status
The map relates resource types to the modules that
access the statistics for those resource types and to an
entry point for the module and to a status which shows
whether statistics for that resource type/id are avail-
able.
Table 1.
Offset Hex |
Type |
Len |
Name (Dim) |
Description |
(0) |
STRUCTURE |
14696 |
APST_GLOBAL_STORAGE |
(0) |
CHARACTER |
16 |
STORAGE_PREFIX |
(0) |
HALFWORD |
2 |
STORAGE_LENGTH |
(2) |
CHARACTER |
1 |
STANDARD_ARROW |
(3) |
CHARACTER |
3 |
STANDARD_DFH |
(6) |
CHARACTER |
2 |
STORAGE_DOMAIN_ID |
(8) |
CHARACTER |
8 |
STORAGE_BLOCK_NAME |
(10) |
CHARACTER |
8 |
AP_LAST_RESET_TIME |
(18) |
CHARACTER |
24 |
RESOURCE_STATE_ MAP (14) |
(18) |
CHARACTER |
8 |
RESOURCE_NAME |
(20) |
CHARACTER |
8 |
RESOURCE_MODULE |
(28) |
ADDRESS |
4 |
RESOURCE_MODULE_ ENTRY_POINT |
(2C) |
BIT(8) |
1 |
RESOURCE_STATUS |
(168) |
CHARACTER |
14336 |
STATS_BUFFER_LARGE |
Table 2.
Len |
Type |
Value |
Name |
Description |
1 |
CHARACTER |
> |
ARROW |
Resource names are <=8 char, padded to 8 char with blanks
Module names are <=8 char, padded to 8 char with blanks
Status of resource type/id can be one of the following
|
1 |
BIT |
00000000 |
NO_STATS_AVAILABLE |
1 |
BIT |
01000000 |
ID_STATS_UNAVAILABLE |
1 |
BIT |
10000000 |
TYPE_STATS_UNAVAILABLE |
1 |
BIT |
11000000 |
ALL_STATS_AVAILABLE |
These two variables are used to define the storage req-
uired for the AP stats control block. They are used in
the call to Storage Domain to obtain the storage.
|
8 |
CHARACTER |
APSTGBST |
CONTROL_BLOCK_NAME |
2 |
DECIMAL |
14696 |
CONTROL_BLOCK_LENGTH |
Total number of mappings is the number of resources in
the AP domain for which statistics are collected.
|
2 |
DECIMAL |
14 |
TOTAL_MAPPINGS |
|
Offsets in mapping used for module loading optimisation.
|
2 |
DECIMAL |
6 |
TERMINAL_MAP_OFFSET |
* |
2 |
DECIMAL |
8 |
VTAM_MAP_OFFSET |
* |