Displaying IMS Dependent Region Information

Option 10 displays details about the IMS dependent regions that are being processed by the specified IMS Control Region.

See Figure 1. All dependent regions that are currently active are displayed. Those that are defined to SA z/OS are displayed as SA z/OS resources. The remainder have only their job names and IMS information displayed.

Note: Use the new IMS Automation command INGIMS to achieve the same functionality: for example, INGIMS resource REQ=DEP

Figure 1. IMS Dependent Regions Panel

 EVIKYDP0                  SA z/OS  - Command Dialogs     Line  1     of 5    
 Domain ID   = IPSFP      ---- Dependent Regions -----    Date = 08/03/07     
 Operator ID = OPER                                       Time = 12:44:37     
 Control Reg.= IMSCTL/APL/KEY4                                                
 CMD: A Update    B Start     C Stop      D INGRELS   E INGVOTE   F INGINFO   
      H DISPTRG   I INGSCHED  N /ASSIGN   P /PSTOP                / scroll    
 CMD Name        Type System Reg.Id ITyp Trans/Step Program  IMSStatus       
 --- ----------- ---- ------ ------ ---- ---------- -------- ---------------- 
     IMSDBRC     APL  KEY4          DBRC                                      
     IMSDLS      APL  KEY4          DLS                                       
     IMSFP1      APL  KEY4   1      FPME NO MSG.    DFSIVP4                   
     IMSMP1      APL  KEY4   2      TP                       WAITING          
     IMSPPI      APL  KEY4   3      BMP  IMS941PP   EVIRYPPI                  
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Command ===>                                                                   
  PF1=Help    PF2=End      PF3=Return                               PF6=Roll    
                           PF9=Refresh PF10=Previous PF11=Next     PF12=Retrieve

For each resource the following information is shown:

Name: The name of the resource. This is the job name from the /DIS ACTIVE display if the dependent region is not defined to SA z/OS.
Type: The type of the resource. This is blank if the dependent region is not defined to SA z/OS.
System: The name of the system where the resource resides. This is blank if the dependent region is not defined to SA z/OS.

The following fields are displayed on a series of screens that you can move through with the PF10 or PF11 key:

Reg.Id

The IMS dependent region number.

ITyp

The second type column is the IMS dependent region type.

Trans/Step

Transaction code being processed by region, or NONE, if there are no regions of that type.

Program

Name of the program processing in the region.

IMSStatus

Status of the region, which can be one of the following:

Status	Meaning
UNCERTAIN	The IMS and SA statuses do not match. In particular, IMS does not know about the job name represented by the SA Resource and yet SA sees the resource as Available. This is a possible problem with the IMS dependent region.
ACTIVE-DBCMD	A /DBD or a /DBR command is in progress and waiting for the region to terminate before the /DBD or /DBR can complete.
AVAILABLE	The active threads are available. The region is available to schedule an application.
SCHEDULED	The application program is being scheduled.
TERMINATING	The application program is being terminated.
UNAVAILABLE	An active DBT thread is unavailable. An application is using the region, even though the application is not currently scheduled. This region is therefore not available to any other application.
WAITING	The MPP region is waiting for work.
WAIT-AOI	An AO application issued a GMSG call with the WAITAOI subfunction specified, but there are no messages for the AO application to retrieve.
WAIT-BLOCKMOVER	An application control block cannot be loaded because the ACB block mover is busy.
WAIT-CMD/PENDING	A /DBDUMP, /DBRECOVERY, or /START command is in progress.
WAIT-INPUT	The application program is in WAIT-FOR-INPUT (WFI) mode.
WAIT-INTENT	The application program's intent for a database conflicts with the use of the database by a scheduled program.
WAIT-INTENT/POOL	Indicates that either the application program's intent for a database conflicts with the use of the database by a scheduled program, or a temporary shortage of DMB, PSB, or PSB work area pool space exists.
WAIT-INTENT SCHD	The IMS transaction scheduler detected an application scheduling intent, for example, Load Balancing.
WAIT-I/O PREVEN	A BMP region that accesses a GSAM database cannot schedule until I/O prevention has completed.
WAIT-MESSAGE	The application program is in a pseudo WAIT-FOR-INPUT (WFI) mode. The application is scheduled and is waiting for a message.
WAIT-POOLSPACE	A temporary shortage of DMB, PSB, or PSB work area pool space exists.
WAIT-SWITCHOVER	The alternate system is tracking the active system.
WAIT-SYNCPOINT	The application in the region is now in SYNC POINT.
WAIT-EPCB POOL	A temporary shortage of EPCB pool space exists.
WAIT-RRS PC	The application program has a protected conversation with an OTMA client that is processing a synchronization point (or sync point). Sync point can continue after the OTMA client issues either an SRRCMIT or SRRBACK call. Alternatively, the application program is part of a cascaded family and is processing a sync point. APPC/OTMA SMQ Enablement uses RRS cascaded transaction support to synchronize the backend and frontend system.

IMS Classes

One of the classes that is associated with the region. The region can have from one to four classes, whose values range from 1 to 999.

Compound

The compound status of the resource. This is a summary of all statuses of the resource and provides a single value that tells you whether the resource is OK or it has a problem.

Observed

The current status of the resource as observed by the automation agent.

Desired

The status that the automation manager is trying to move the resource to. It can be either available or unavailable.

Automation

The status representing the automation agents automation for the resource.

Startable

Indicates whether it is possible to start the resource if the automation manager is asked to do so at this point in time.

Health

The health status of the resource. Shows N/A if the resource is not connected to a monitor.

Auto

Shows the automation flag that is maintained by the automation manager. No automation is done for the resource by the automation manager when the flag is off.

Hold

Shows the hold flag that is maintained by the automation manager.

Starttype

The preset start type that will be used the next time the resource is made available (started). This value is set by INGSET and will override any TYPE value that is specified (or defaulted to) in the next INGREQ start request.

Stoptype

The preset stop type that will be used the next time the resource is made unavailable (shut down). This value is set by INGSET and will override any TYPE value specified (or defaulted to) in the next INGREQ stop request. However, a stop type of FORCE, wherever specified, will always be honored.

Trigger

The trigger that is associated with the resource.

Category

Shows the category of the resource, always IMS for dependent regions.

Subtype

The subtype of the resource. Available subtypes are: CTL, TP, DBRC, DLS, FP, BMP, FDR.

Description

Descriptive information about the resource.

Different colors are used to indicate when a particular status is viewed as abnormal, as follows:

Color	Meaning
Blue	The desired status is UNAVAILABLE.
Pink	The compound status is DENIED or INHIBITED.
Red	The compound status is PROBLEM. The observed status is HARDDOWN or PROBLEM.
Yellow	The compound status is DEGRADED. The observed status is not in line with the desired status.

You can use one of the following command codes to invoke another command dialog:

A: Update resource settings (SA z/OS resources only).
B: Start resource (make available). SA z/OS resources will invoke INGREQ, non-SA z/OS regions will invoke INGIMS with a command of /START REGION xxxxx, where xxxxx is the job name.
C: Stop resource (make unavailable). SA z/OS resources will invoke INGREQ, non-SA z/OS regions will invoke INGIMS with a command of /STOP REGION JOBNAME xxxxx, where xxxxx is the job name.
D: Show resource relationships. (This invokes INGRELS).
E: Show resource requests or votes. (This invokes INGVOTE).
F: Show resource details. (This invokes INGINFO).
H: Show trigger details for resource. (This invokes DISPTRG).
I: Show schedules for resource. (This invokes INGSCHED).
N: Invoke the /ASSIGN command. Use the assign command to assign additional classes to the region. It invokes INGIMS with the command /ASSIGN CLASS xx REGION nn, where nn is the region number. You can overtype the command to supply the classes.
P: Invoke the /PSTOP command. Use the pstop command to stop a transaction. It invokes INGIMS with the command /PSTOP REGION nn TRANSACTION xx, where nn is the region number and xx is taken from the Trans/Step column. You can overtype the command before executing it.
Note: This action code will not check whether the control region or the dependent region supports the command. You can adjust the command to suit your purpose if the TRANSACTION format of the command is not suitable.

Additionally you can use the slash character (/) to make the selected line the first line of the display.

You can also use the FIND(F), RFIND(RF), and SORT subcommands on this panel.