The SYSTP utility can also be used to obtain statistical data on Natural/CICS sessions in batch mode.
The Natural log file into which the statistical data about
Natural/CICS sessions is written must be assigned to the Natural batch job as
Work File 1 (that is, via
CMWKF01). It must also be defined to the
online system, which means in the CICS DCT (destination control table); see the
LOGDEST parameter of the
macro described in the TP Monitor Interfaces or
Parameter Reference documentation, respectively.
This section covers the following topics:
To invoke the SYSTP utility in batch mode
In the batch job, specify either of the following commands:
LOGON SYSTP SYSBATCH xxx
what kind of data is to be processed; for example:
xxx=nci indicates that the data is
collected by a Natural/CICS online system.
Data is written into the Natural log file when Natural is initialized or reset, and when a Natural session is terminated.
The Natural CICS Interface writes the following records into the Natural log file:
A start log record whenever the Natural environment is initialized or reset.
A session log record whenever a Natural session is terminated.
When a Natural environment is initialized, a system ID is written into the system control block. This system ID also belongs to all log records. Therefore, a Natural log file can be shared by several Natural/CICS online environments.
The information logged serves to keep track of the usage of the Natural/CICS online environment. Therefore, most of the information refers to facilities of the Natural environment. The log file is not intended to be an accounting or monitoring tool that refers to facilities of CICS.
Based on the system ID, several reports are created with data related to a Natural session:
Log file data listed in chronological order, which means that session log records are sorted by session end date and time.
Statistics about how the Natural environment was set up and used.
Statistics about thread groups (if used).
Statistics about program storage threads (if used).
Statistics about roll facilities (if used).
This set of reports is created for all Natural environments with records about Natural/CICS sessions in the Natural log file.
The session termination log records, of course, reflect only resources which have been used by the corresponding sessions. Therefore, these records may not reflect the full Natural environment. Reports of a full Natural environment can be obtained by making a snapshot of the whole Natural environment using the function (see the relevant section).