The SYSTP utility provides functions that are specific to CICS.
To invoke specific SYSTP functions under CICS
In the Code field of the SYSTP
Main Menu, enter E
for
.
From the menu displayed then, you can select the functions explained in this section.
Note:
In the remainder of this section, the Natural CICS Interface is
also referred to as NCI.
This section covers the following topics:
This function is used to display a list of active user sessions in a Natural environment.
When you invoke this function, the Natural User Sessions screen appears, which displays the following information:
Column | Explanation |
---|---|
Term ID | Unique terminal ID within CICS associated with the Natural session. |
User ID | Natural user ID of the Natural session. |
Tran | CICS transaction ID under which Natural session is currently running. For pseudo-conversational sessions, this is the pseudo-conversational restart transaction ID. |
Stat | Session status: see Operational Status. |
Start Date / Time | Starting date and time of the Natural session. |
Last Act | Time of last screen output. |
Library | Natural library in which the user is currently working. |
Object | Natural object currently executed. |
If you press PF10, the display of the session date and time is replaced by the following session resource data:
Column | Explanation |
---|---|
Thrd Grp | Thread group to which user is assigned. |
Thread | Name of thread last used. |
Roll Fac | Assigned roll facility. |
SIR Addr | Address of Session Information Record (SIR) |
SRH Addr | Address of SIR block header |
This section covers the following topics:
In addition to the commands described in Using SYSTP Utility Screens, for each item displayed on the Natural User Sessions screen, you can execute one of the following line commands.
Line Command | Function |
---|---|
C |
Cancel session.
Displays a
confirmation window where you can confirm or deny that the session is
terminated. If you confirm session termination, the session is then prefixed
with a minus sign (-). Additionally, for the session concerned, the operational
status The session actually terminates when the owner of the session marked for termination performs the next terminal I/O, Adabas call or external program call. The session owner then receives a corresponding termination notification. |
F |
Flush session.
Invokes a confirmation window where you can enter
|
R |
Reactivate session.
Reverses a |
W |
Wake up session.
Reactivates immediately a session that has been
suspended by a |
To reduce the number of list items by specifying selection criteria
On the Natural User Sessions screen, press PF4.
The Selection for User Sessions window appears where you can select user sessions by inactivity date and time, inactivity time interval, Natural server ID, CICS system ID, terminal ID, user ID or transaction ID.
Inactivity date and time and inactivity interval list all sessions that were not active before the date and time specified or before the time interval specified.
A date must be specified in the format
YYYY-MM-DD
(YYYY
= year,
MM
= month,
DD
= day).
The time must be
specified in the format
HH:II:SS
(HH
= hours,
II
= minutes,
SS
= seconds).
To specify a range of IDs, use the asterisk (*) as a leading or trailing character or use the question mark (?) as a wildcard character. See also Examples of Name Ranges.
For each session displayed on the Natural User
Sessions screen shown above, additional information can be displayed
by invoking the Natural User Session Statistics screen
with the S
or U
line
command. The following section describes the information provided on this
screen.
All sizes on the Natural User Session Statistics screen are in KB unless otherwise indicated in the field descriptions below.
Field | Explanation | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Started | Day, date, and time when the session was started. | ||||||||||||||
Last Actions | Date and time when the user was active last. | ||||||||||||||
User | Natural user ID as assigned by the Natural system
variable *USER
(see the System Variables documentation).
|
||||||||||||||
at Terminal | ID of the terminal associated with the Natural session
as assigned by the Natural system variable
*INIT-ID
(see the System Variables documentation).
|
||||||||||||||
Transid | Pseudo-conversational transaction ID under which Natural is running. | ||||||||||||||
Task # in | Task number assigned by CICS followed by the ID of the CICS region. | ||||||||||||||
Cur Strg Used | Current amount of storage used by this session. | ||||||||||||||
Max Strg Used | Maximum amount of storage ever used by this session. | ||||||||||||||
Thread Size | Size of this thread. | ||||||||||||||
Thread Name | Name of the thread used last. For threads allocated by
using GETMAIN , the thread name is composed of the prefix
NSCP followed by the terminal ID.
|
||||||||||||||
Thread Group | Name of the associated thread group (triggered by starting the transaction ID). | ||||||||||||||
of Type |
|
||||||||||||||
Natural Library | Natural library ID as assigned by the Natural system
variable *LIBRARY-ID
(see the System Variables documentation).
|
||||||||||||||
Natural Program | Name of the Natural program currently used by the
session as assigned by the Natural system variable
*PROGRAM
(see the System Variables documentation).
|
||||||||||||||
Line No. | Line number in the Natural program currently used by the session. | ||||||||||||||
Operational Status | See Operational Status in the following section. | ||||||||||||||
Roll Facility | Name of associated roll facility. | ||||||||||||||
Roll Recs (Last) | Number of records written to roll facility for last roll-out. | ||||||||||||||
Roll Recs (Max) | Maximum number of records ever written during roll-out. | ||||||||||||||
Roll Record Size | Record size of this roll facility. | ||||||||||||||
Slot Size | Number of records required to roll-out a thread completely. | ||||||||||||||
Restart Rec. No. | Number of the record that contains roll-out control
information; this record must be rolled in first.
The following applies to VSAM roll files only. The relationship between restart record number (RecNum), slot number (SN) and slot size (SZ) is: RecNum = (SN-1) * SZ + 2 or SN = (RecNum-2) / SZ + 1 |
||||||||||||||
Slot Number | Number of slot in VSAM roll file belonging to this session (for VSAM only). See also VSAM Roll Files in Restart Rec. No. above. | ||||||||||||||
Compressed Length | Amount of relevant storage currently rolled out. | ||||||||||||||
Session Resumes | Total number of session resumes. | ||||||||||||||
Thread Switches | Number of session resumes with rolling into a thread which is different to the one the session had been in before. | ||||||||||||||
Roll-Ins | Number of session resumes with rolling in from roll facility. | ||||||||||||||
Region Switches | Number of CICS region switches. | ||||||||||||||
OpSys Switches | Number of operating system image switches in a z/OS Parallel Sysplex environment. |
This field indicates any of the following operational statuses:
Status | Abbreviation | Description |
---|---|---|
Active |
Act |
Currently active. |
Inactive |
Ina |
Inactive, still in thread. |
Rolled out |
Rld |
Rolled out, in roll facility. |
Wait (Init) |
WtI |
Waiting for thread on session initialization. |
Wait (Resume) |
WtR |
Waiting for thread on session resume. |
Initializing |
Int |
Initializing session. |
Resuming |
Res |
Resuming session, in thread, not active yet. |
Suspending |
Sus |
Suspending session. |
Terminating |
Trm |
Terminating session. |
Rolling out |
Out |
Rolling out from thread. |
Rolling in |
In |
Rolling in from roll facility. |
The following additional information can appear in Operational Status:
Status | Description |
---|---|
Conversational |
Dialog-oriented session
(PSEUDO=OFF ) as opposed to
pseudo-conversational/transaction-oriented session.
See also the |
Forced Conversational |
Last screen I/O of a PSEUDO=ON
session was conversational.
See also the |
No-Roll |
Session is not allowed to roll. |
Compressed |
Session is compressed in roll facility. |
Thread Switched |
Thread currently used is not the same as used before. |
Thread Locked |
Session kept from switching threads (for example,
RELO=OFF ); can also force
No-Roll /Conversational status.
See also the |
Purged by
Admin |
Session canceled by administrator (flag set). |
Spool Task |
Task is a spool/print task. |
Asynchronous Task |
Task is an asynchronous task, not bound to a terminal. |
This function is used to display which Roll facilities are available for rolling out user work areas to make room for active users.
When you invoke this function, the Natural Roll Facilities screen appears for the current CICS region (as indicated by the CICS ID in the screen title). For each roll facility, the following information is displayed:
Column | Explanation |
---|---|
Facility Name | TEMPSTOR is used for auxiliary temporary
storage, MAINSTOR for main temporary storage, and remaining file
names are VSAM roll files as defined in the CICS file control table (FCT).
none denotes that no roll facility is used.
|
Record Size | Record size of this roll facility. |
Slot Size | Number of records required to roll out a thread
completely (maximum thread size divided by record size, rounded up).
This column is displayed by default. |
No. of Slots | Number of sessions which fit into this roll file (number of file records divided by slot size, rounded down); applies to VSAM roll files only. |
Facility Users |
Current (Cur) and maximum (Max) number of user sessions assigned to this roll facility. |
Roll Counts |
Number of session roll operations from or into this roll facility. |
CI Size* | Control Interval size of the VSAM roll file. |
No. of Records* | Number of records in the VSAM roll file |
Roll File
Initialization* |
Date and time when the VSAM roll file was formatted by the NCISCPRI utility program. |
Status | Indicates Full if the facility users equal
the number of available slots.
|
* These columns are only displayed if you press PF10. If pressed again, it switches back to the default display.
In addition to the commands described in Using SYSTP Utility Screens, the Natural Roll Facilities screen provides the following PF keys and line commands:
PF Key | Line Command | Function |
---|---|---|
PF4 | U |
Invokes the Natural User Sessions screen (see the relevant section) for the marked roll facility which displays all Natural user sessions that use this facility. |
PF10 | - | Toggles between the display of the following columns:
Slot Size, No. of
Slots, Facility Users and Roll
Counts and CI Size, No. of Records and Roll File Initialization. |
This function is used to display which thread groups are available to Natural.
When you invoke this function, the Natural Thread Groups screen appears for the current CICS region (as indicated by the CICS ID in the screen title). For each thread group, the following information is displayed on this screen:
Column | Explanation |
---|---|
Group Name | Thread group name. |
Thread Type | Type of thread used: see Natural User Session Statistics. |
Thread Size | Thread group's common thread size. |
Strg Used | Maximum storage ever used by a session that uses this thread group. |
TCBs | Maximum number of sessions concurrently active. |
Max Compr* | Maximum compressed length of this thread group. |
VSAM |
Roll facilities defined for group; CICS temporary storage (auxiliary or main) always backs up VSAM if VSAM roll files are not available or full. |
* These columns are only displayed if you press PF10. If pressed again, it switches back to the default display.
In addition to the commands described in Using SYSTP Utility Screens, the Natural Thread Groups screen provides the following PF keys and line commands:
PF Key | Line Command | Function |
---|---|---|
PF4 | U |
Displays all Natural user sessions (see the relevant section) that use the thread group marked with the cursor/command. |
PF10 | - | Toggles between the display of the
following columns:
TCBs and Queue
Sizes and Max Compr and Active Tasks. |
- | T |
Displays Natural storage threads (see below) for the thread group marked with the cursor/command. |
- | D |
Displays Natural thread group definitions (see the relevant section) for the thread group marked with the cursor/command. |
This function is used to display information about the storage threads in the Natural environment.
When you invoke this function, the Natural Storage Threads screen appears for the current CICS region (as indicated by the CICS ID in the screen title). The screen displays the following information:
Column | Explanation | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Thread Name | Name of the thread. | ||||||||||
Grp No. | Number of the group to which this thread belongs. | ||||||||||
Thrd Size | Usable thread size. | ||||||||||
Strg Used | Maximum storage ever used by a session that uses this thread. | ||||||||||
Use Count | Number of times this thread has been selected for processing. | ||||||||||
Roll-Ins |
|
||||||||||
Term ID | Terminal ID belonging to the Natural session whose data are in this thread. | ||||||||||
Task No. | ID of CICS task currently active in this thread. If no ID is displayed, no session is active is this thread. |
In addition to the commands described in Using SYSTP Utility Screens, the Natural Storage Threads screen provides the following line commands and PF key:
Line Command | PF Key | Function |
---|---|---|
C |
- | See Cancel session in Natural User Sessions. |
D |
PF11 | Displays Natural thread group definitions (see the relevant section). |
F |
- | See Flush session in Natural User Sessions. |
G |
PF10 | Displays Natural thread group (see the relevant section). |
R |
- | See Reactivate session in Natural User Sessions. |
U |
- | Displays statistics about the Natural user sessions currently active in the thread. See also Natural User Session Statistics. |
This function is used to display data on the system directory.
When you invoke this function, the Global System Information screen appears for the current CICS region (as indicated by the CICS ID in the screen title). The screen provides the following information:
Field | Explanation |
---|---|
Natural User Sessions | Current (Cur) and maximum (Max) number of Natural sessions in the system. |
Concurrent SCP Active | Current (Cur) and maximum
(Max) number of concurrent system control program (SCP)
requests.
SCP requests are: session initialization, session suspension, session resumption and session termination. |
SIR Block Extensions | Current (Cur) and maximum (Max) number of local SIR block extensions. |
Slots in 1st SIR Block | Number of user sessions that fit into the primary user
control block (first USERS subparameter in
NCMDIR macro; see USERS - Session Information
Record*).
|
Slots in SIR Block Extns | Number of user sessions that fit into a secondary user
control block (second USERS subparameter in
NCMDIR macro; see USERS - Session Information
Record*).
|
VSAM Roll File Slots | Number of VSAM roll files to check. |
Possible Roll Facilities | Number of VSAM roll files plus two for CICS
(MAINSTOR and TEMPSTOR ).
|
Thread Groups | Number of thread groups determined by evaluating all
NCMTGD macro specifications at system startup. See also
NCMTGD Macro
Parameters*.
|
System Recoveries | Number of corrections of statistics counts and/or control block chain. |
Size of DIR Extension (B) | Number of bytes used at system startup for thread control blocks and VSAM roll file online directories. |
Operating System Host ID | Name of the operating system image. |
Assembled Last | Date and time when the system directory source module was last assembled. |
CICS System ID | ID of the CICS region. |
Available Resources:
Local Buff. Pool |
Resources available in the current NCI system
environment: Natural buffer pools, monitor buffer pools and RNM buffer pools.
Type, size (in KB) and location ( |
Max Thread Size | Largest thread size across all valid thread groups. |
VSAM Roll Files | Number of VSAM roll files. |
Main/Aux TempStor | Indicates whether CICS main or auxiliary temporary storage is available for the Natural/CICS roll facilities. |
Session Logging | Indicates whether the Natural/CICS log destination is
defined in the CICS DCT (destination control table) and whether the log
destination is available. The log destination for sessions is defined with the
LOGDEST * parameter.
|
Message Logging | Indicates whether the Natural/CICS error message log
destination is defined in the CICS DCT and whether the log destination is
available.
The log destination for messages is defined with the
|
Message Switching | Indicates whether the message switching transaction ID
is defined in CICS and whether the transaction ID is available. The transaction
for switching messages is defined with the MSGTRAN *
parameter.
If a transaction ID is not available, a SYSTP session flush (see Flush session in Natural User Sessions) is not possible. |
Console Terminal | Indicates whether the CICS console terminal for Natural/CICS is available. |
* This parameter is contained in the
NTCICSP
macro of the Natural parameter module, described in the Parameter
Reference documentation.
This function is used to display generation parameter settings for
Natural running under CICS. The values of these parameters are determined in
the NTCICSP
macro of the Natural parameter module and created
during installation.
When you invoke this function, the Generation Options screen appears for the current CICS region (as indicated by the CICS ID in the screen title). This screen displays an overview of the generation option settings for Natural.
Behind each parameter setting in the Generation
Options screen is a parameter of the NTCICSP
macro.
These parameter names can be viewed by pressing PF10. Press
PF10 to toggle between the screen containing the parameter names and
explanations of the parameters.
Installing Natural CICS Interface in the Installation for z/OS documentation
NTCICSP
macro in the Parameter Reference documentation
This function is used to display Natural thread group definitions.
When you invoke this function, the Natural Thread Group Definitions screen appears for the current CICS region (as indicated by the CICS ID in the screen title). This screen displays the following information:
Column | Explanation | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Grp No. | Thread group number. | ||||||||||||||||||
Group Type |
|
||||||||||||||||||
Roll Fac. | Primary roll facility assigned:
|
||||||||||||||||||
Thread Size | Thread storage GETMAIN size (for thread
group types GETM and SHR ).
|
||||||||||||||||||
TCBs | Maximum number of Natural sessions concurrently active in this thread group. | ||||||||||||||||||
Transaction IDs / Task Request Keys | As defined in the CICS transaction definitions for Natural. |
In addition to the commands described in Using SYSTP Utility Screens, the Natural Thread Group Definitions screen provides the following PF keys and corresponding line commands:
PF Key | Line Command | Function |
---|---|---|
PF4 | S |
Displays thread group definitions for the thread group marked with the cursor/command. |
PF10 | G |
Displays Natural storage threads (see the relevant section) associated with the thread group marked with the cursor/command. |
This function displays the Natural User Session Statistics screen described in Natural User Session Statistics.
This function opens the SYSTP Task Information window, which displays status information about the Natural task in a CICS environment.
This function is used to access facilities for debugging and tracing.
When you invoke this function, a menu appears with the following functions:
This function reserved for internal use by Software AG personnel only.
This function reserved for internal use by Software AG personnel only.
This function provides complete SYSTP batch reports (see also SYSTP in Batch for CICS Sessions) with information about all SCP facilities, regardless of whether they have been used or not. Such facilities are:
Thread groups
TYPE=SHR
threads
Roll facilities
All this information is logged to the Natural/CICS log file, if available.
This function comprises the system snapshot function previously described. In addition, all system highwater marks can be reset, for example:
The number of user sessions.
Every thread group and roll facility.
The number of UCB block extensions.
The amount of storage.
All thread groups and TYPE=SHR
threads.
All wait queue values and counts.
All roll facility roll counts.
This function displays common dynamic profile parameters as
retrieved from the PRMDEST
destination, if available. See also
PRMDEST - Name of the
Natural CICS Profile Parameter Input Destination described
in the Parameter Reference documentation.
This function displays the Applied NCI Source Changes screen for the current CICS region (as indicated by the CICS ID in the screen title). This screen displays the numbers of all source changes that have been applied to the current Natural TP environment.
This function displays the Applied NCI Zaps screen for the current CICS region (as indicated by the CICS ID in the screen title). This screen displays the numbers of all Zaps that have been applied to the current Natural TP environment.