Using CICS REGIONS application
This section describes how to use the CICS REGIONS application.
DBCTL REGIONS application
COMMAND ===> TGT ===> IMS410
#MPPS>> 2/ 2 #QUEUED>> 9 DB2B>> NOT CONNECTED INTVL===> 3
#BMPS>> 1 #QUEUED>> 0 DB2A>> CONNECTED/ 2/ 2 STATUS--- INPUT
#IFPS>> 0 #QUEUED>> 0 DB2C>> NOT CONNECTED DATE----- 01/01/16
LC CMDS: P(STOP), A(ABDUMP), C(CANCEL), PW(STOP WFI) TIME----- 15:31:01
LC JOBNAME TYP TRANCODE PSBNAME LTERM CLS RGN WKSET # SIOS CPU TIME
I14XMSG MPP DSN8PT DSN8IH13 1 1 152K 284 2.24
I14XMSG MPP DSN8CS DSN8IC13 1 2 248K 283 3.12
I14XBMP BMP TDRIVER PDRIVER 4 3 228K 49 .30
*************************** END OF REGIONS ********************************
You can specify either the Refresh mode or an Input mode as follows:
Refresh
Enter the screen refresh interval in seconds from 1 to 99 in the INTVL field. The default is the INTERVAL parameter value in the BMC Software-distributed BBPROF data set member BBITSP00.
Start screen refresh by pressing the GO key ( PF6 or PF18) or by entering GO in the command input line. Screen refresh is indicated by the message, RUNNING, displayed in the STATUS field.
Data cannot be entered until you press ATTN (SNA terminal) or PA1 (non-SNA terminal), which exits Refresh and enters Input mode. INPUT is displayed in the STATUS field.
Input
To enter data in the application, it must be in Input mode. If the application is in Refresh, press ATTN (SNA terminal) or PA1 (non-SNA terminal) for input mode. The message, INPUT, is displayed in the STATUS field.
Commands can be entered in the command line, data can be entered in the TGT or INTVL fields, and the line commands can be used. Press Enter to display the current IMS status.
The application shows the region status and a scrollable list of the active regions by name. The region status shown in the upper portion of the application displays:
- Number of message processing (MPPS) regions that are active and started (n/ n where n is an MPP count) and the number of batch message processing (BMPS) and Fast Path message processing (IFPS) regions that are active
- Number of transactions waiting to be processed per region type ( # QUEUED >> field)
- Name and status of the first three external subsystems defined to IMS and the number of regions connected to them
The following table lists the possible statuses and their meaning.
Status | Description |
|---|---|
CONNECTED/ n/ n | A connection has been established between IMS and DB2. The first number is the number of connected dependent regions and the second number is the number of dependent regions that are actually signed on to DB2. |
NOT CONNECTED | The subsystem has been defined to IMS, but no connection exists. |
CONNECTING | IMS is in the process of establishing a connection with the subsystem. |
STOPPED | The IMS operator has issued a /STO SUBSYS command. |
STOPPING | The IMS operator has issued a /STO SUBSYS command and the connection is in the process of stopping. |
TERMINATING | The subsystem connection is in the process of terminating due to an internal request from IMS or DB2. This condition could be normal or abnormal as indicated by IMS messages. |
- Target IMS in the TGT field
- The Refresh interval in seconds in the INTVL field and the application mode status in the STATUS field (RUNNING for refresh or INPUT for application command entry)
The scrollable list in the lower portion of the REGIONS application shows all the active regions. Use the list to manage a region's status.
Enter any of the following one- or two-character line commands on the line of the region that you want to change.
Line command | Description |
|---|---|
P | Issues the /STOP REGION command to terminate the message processing region when the current transaction is completed |
A | Issues the /STOP REGION P1 ABDUMP P2 to abnormally terminate an application program |
C | Issues the /STOP REGION CANCEL to stop a looping region that cannot be stopped by the /STOP REGION P1 ABDUMP P2 command |
PW | Issues the /STOP REGION P1 TRAN to stop a message processing program in wait-for-input (WFI) mode |
The following table contains the field descriptions for the REGIONS application:
Field name | Description |
|---|---|
JOBNAME | One- to eight-character OS JOBNAME for the region |
TYP | Type of region, which can be as follows:
|
TRANCODE | Transaction in progress |
PSBNAME | Scheduled program |
LTERM | Logical terminal used for input |
CLS | Processing class |
RGN | Region ID |
WKSET | Real storage in use |
# SIOS | Number of real I/Os |
CPU Time | Cumulative CPU time for the region |
Related topic