Using CICS REGIONS application

This section describes how to use the CICS REGIONS application.

Figure 1. DBCTL REGIONS application

BMC Software  ------------------ IMS REGIONS -------------------- AutoOPERATOR
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:

  • MPP: message processing or Fast Path mixed mode region

  • MDP: message-driven Fast Path region

  • FPU: Fast Path utility region

  • BMP: batch message processing region

  • IFP: Fast Path exclusive

  • DBT: DBCTL thread

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

Was this page helpful? Yes No Submitting... Thank you

Comments