CICSRGN - CICS systems

The CICSRGN view shows general information about CICS® systems. When a CICS system is part of an extended recovery facility (XRF) configuration, the information displayed is for the active CICS system in the configuration.

Availability

The CICSRGN view is available for all managed CICS systems.

Access

Issue command:
CICSRGN
Select:
REGION from the OPERATE menu, and CICSRGN from the REGION submenu.

Figure 86 is an example of the CICSRGN view.

Figure 86. The CICSRGN view
 27FEB2005  17:07:16 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
 >W1 =CICSRGN===========EYUPLX01=EYUPLX01=27FEB2005==17:07:16====CPSM==========4
 CMD CICS     Job      MVS  Act    CICS         CICS CPU      Page     Page     Tot
 --- System-- Name---- Loc  Task-- Status-      Rel- Time---- In------ Out----- SIO
     EYUMAS1A EYUJMS1A CPSM      5 ACTIVE       0410       95      341       95
     EYUMAS2A EYUJMS2A CPSM      5 ACTIVE       0330       14       40        0
     EYUMAS3A EYUJMS3A CPSM      5 ACTIVE       0330       14       12        0
     EYUMAS4A EYUJMS4A CPSM      6 ACTIVE       0330       15        1        0
 
 

Action commands

Table 180 shows the action commands you can issue from the CICSRGN view. The action commands for the CICSRGN view are available for all managed CICS systems for which CICSRGN is valid, except as noted in Table 180.

Table 180. CICSRGN view action commands
Primary command Line command Description
ARMrestart sysname ARM Requests the immediate cancellation and restart of a CICS system using the MVS™ automatic restart manager (ARM). For ARM restart to be successful, the CICS system must:
  • Be known to CICSPlex® SM as a local MAS
  • Be running in an MVS image where ARM is active
  • Have successfully registered with ARM during initialization
  • Be eligible for restart according to current ARM policy

ARM is available for CICS Transaction Server for OS/390, Version 1 Release 3 and later systems.

GMM sysname GMM Displays the Good Morning Message Text input panel (Figure 87), which lets you enter a message to be displayed by the CICS Good Morning transaction (CSGM).

GMM is available for CICS Transaction Server for OS/390, Version 1 Release 3 and later systems.

IMMshut sysname IMM Shuts down a CICS system immediately. All active tasks and Systems Network Architecture (SNA) sessions within the CICS system are terminated.
INItialize sysname INI Initializes the CICS system date and time to match the MVS system date and time-of-day.
NORmshut sysname NOR Shuts down a CICS system normally. The system is shut down as soon as active tasks and SNA sessions within the system are completed.
SECurity sysname SEC Rebuilds the in-storage external security manager (ESM) profiles for a CICS system, provided they reside in local storage. The copies of the profiles that reside in the managing CMAS are also rebuilt.

The SEC command is available for CICS Transaction Server for OS/390, Version 1 Release 3 and later systems.

Note:
The SEC command cannot rebuild ESM profiles that reside in global storage. You must use the facilities provided by your ESM to refresh those profiles.
n/a SET Sets a CICS system attribute according to the new value you specify in an overtype field.
Note:
The value you specified in the Require Set field on the CICSPlex System Manager entry panel determines whether or not you must use the SET command when you overtype a field.
SHUtdown sysname SHU Displays the CICS SHUTDOWN input panel (Figure 88), which lets you specify a normal, immediate, or XRF takeover shutdown, a shutdown transaction, the dump option, and the PLT and XLT suffixes.
SNAp sysname SNA Displays the CICS SNAP input panel (Figure 89), which lets you specify the options to be used for a snap dump.
STAts sysname STA Displays the CICS STATISTICS input panel (Figure 90), which lets you write statistical data for the CICS system to a system management facility (SMF) data set.
TAKeover sysname TAK Shuts down a CICS system and transfers control of the resources to its XRF partner.
Where:
sysname
Is the specific or generic name of a CICS system.

When you issue the GMM action command from the CICSRGN view, the CICS Good Morning Message Text input panel appears, as shown in Figure 87.

Figure 87. The CICS Good Morning Message Text input panel
 --------------- CICS Good Morning Message Text for EYUMAS1A--------------------
 COMMAND ===>
 
  GMM Transid ====>  CSGM
 
  GMM Text:
 
 
 
 
 
 
        TEXT LENGTH MAX 246 CHARACTERS
 
 Change Text by typing over existing text.
 Press Enter to accept changes.
 Type END or CANCEL to terminate changes.
 

To enter a message, type the new text (overtyping any existing text). You can enter up to 246 characters over 4 lines. Press Enter to accept new text. Press End to process changes or Cancel to terminate changes.

Note:
The good morning message feature is available only for CICS systems running CICS Transaction Server for OS/390, Version 1 Release 3 and later.

When you issue the SHUTDOWN action command (specifying the CICS region name) or the SHU line command, from the CICSRGN view, the CICS SHUTDOWN input panel appears, as shown in Figure 88.

Figure 88. The CICS SHUTDOWN input panel
 ---------------------- CICS SHUTDOWN FOR EYUMAS1A -----------------------------
 COMMAND  ===>
 
 Specify the options to be used for this shutdown of CICS
 
 Shutdown Type  ===> NORMAL        Normal, Immediate, or Takeover
 Shutdown Dump  ===> NO            Yes or No
 Allow Restart  ===> YES           Yes, No or blank
 
 Transaction Id ===>               4 Character Shutdown Transaction Id
                                 - NO indicates NO shutdown transaction
                                 - Blank indicates default shutdown transaction
 
 PLTSD Suffix   ===> NO            2 Character suffix for shutdown PLT.
                                 - NO indicates no shutdown PLT
                                 - Blank indicates default shutdown PLT
 
 XLT Suffix     ===> NO            2 Character suffix for shutdown XLT.
                                 - NO indicates no shutdown XLT
                                 - Blank indicates default shutdown XLT
 
Press Enter to continue CICS shutdown.
Type END or CANCEL to cancel shutdown request.

To shut down a CICS system, specify the type of shutdown, whether or not you want a dump to be taken, whether or not the CICS system should be restarted automatically, and, optionally, the 2-character suffixes of the program list table (PLT) and transaction list table (XLT) to be used.

For systems running the CICS TS, if you specify Normal in the Shutdown Type field, you may also specify a shutdown transaction in the Transaction Id field. This transaction will override the transaction specified in the SDTRAN system initialization parameter. Alternatively, you may specify No in this field to shutdown the CICS system without any transaction.

When you issue the SNAP action command (specifying the CICS region name) or the SNA line command, from the CICSRGN view, the CICS SNAP input panel appears, as shown in Figure 89.

Figure 89. The CICS SNAP input panel
 ----------------------------- CICS SNAP ---------------------------------------
 COMMAND  ===>
 
 Specify the options to be used for this dump of CICS:
 
 Dump  Code ===> NORMAL          1- to 8-character dump code
 
 Caller     ===> NO              1- to 8-character caller ID
 
 
                           TITLE (79 characters)
 
 
 
Press Enter to continue CICS dump with the options specified.
Type END or CANCEL to terminate dump request.

To obtain a CICS snap dump, specify a 1- to 8-character dump code and, optionally, a 1- to 8-character caller ID and a title of up to 79 characters.

When you issue the STATS action command (specifying the CICS region name) or the STA line command, from the CICSRGN view, the CICS STATISTICS input panel appears, as shown in Figure 90.

Figure 90. The CICS STATISTICS input panel
 ------------------------ CICS STATISTICS for IYCQSQ22 ------------ Top of data 
 COMMAND ===>                                                                   
                                                                                
  Specify the CICS statistics to be collected:                                  
                                                                                
   All ===> NO                                                                  
    Autoinstall ==> NO     Taskcontrol ==> NO     Recovery    ==> NO            
    Connection  ==> NO     TranClass   ==> NO     DB2         ==> NO            
    Dispatcher  ==> NO     TDqueue     ==> NO     Tcpip       ==> NO            
    DTB         ==> NO     Terminal    ==> NO     Tcpip Svc   ==> NO            
    File        ==> NO     Trandump    ==> NO     Corba Svr   ==> NO            
    IRCbatch    ==> NO     Transaction ==> NO     JVM Pool    ==> NO            
    Journal     ==> NO     TSqueue     ==> NO     RQ Model    ==> NO            
    LSR         ==> NO     VTAM        ==> NO     Bean        ==> NO            
    Monitor     ==> NO                            JVM Profile ==> NO            
    Program     ==> NO     FEPI        ==> NO     JVM Program ==> NO            
    Stats       ==> NO     Prgm AInst  ==> NO                                   
    Storage     ==> NO     Jrnl Name   ==> NO                                   
    Sysdump     ==> NO     Stream Name ==> NO                                   
    Tablemgr    ==> NO     Enqueue     ==> NO                                   
   Reset statistics ===> NO 
Press Enter to continue statistics request.
Type END or CANCEL to cancel without collecting statistics.

To request statistics for all resources in a CICS system, type YES in the All field. To request statistics for selected resources, type YES in one or more individual resource fields. You can also reset the statistics after they have been collected by typing YES in the Reset statistics field.

Hyperlinks

Table 181 shows the hyperlink field on the CICSRGN view.

Table 181. CICSRGN view hyperlink field
Hyperlink field View displayed Description
CICS System CICSRGND Detailed view of the specified CICS system.
Note:
You can also display the CICSRGNS view by issuing the SUM display command.
[[ Contents Previous Page | Next Page Index ]]