CICSRGN3 - CICS system task details

The CICSRGN3 view shows detailed information about the tasks on a CICS® system.

Availability

The CICSRGN3 view is available for all managed CICS systems.

Access

Issue command:
CICSRGN3 sysname

sysname
is the name of a CICS system within the current scope.

Hyperlink from:
the Current Tasks field of the CICSRGND view.

Figure 93 is an example of the CICSRGN3 view.

Figure 93. The CICSRGN3 view
 27FEB2005  15:41:56 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
 >W1 =CICSRGN==CICSRGN3=EYUPLX01=EYUPLX01=27FEB2005==15:37:31====CPSM==========1
     CICS System..    DJ13A0 Tot Pgrm Use.        11 Cur LU Sess        0
     Current Tasks         3 Pgrm Compress         0 HWM LU Sess        0
     Tasks........           Cur Act UTrn.         3
     Peak Tasks...        13 Cur Que UTrn.         0
     Current Amax.       N/A Peak Act UTrn         4
     Peak Amaxtask       N/A Peak Que UTrn         0
     Total Tasks..       107 Totl Act UTrn         6
     Interval task         6 Totl Que UTrn         0
     Times at MAXT         0 Tot Que Time.  00:00:00
     Act Max Tasks       N/A Cur Que Time.  00:00:00
     Maxtasks.....       120 PRSS Inq Cnt.         0
     Pgrm AIn Attm         0 PRSS NIB Cnt.         0
     Pgrm AIn Xrej         0 PRSS Opn Cnt.         0
     Pgrm AIn Fail         0 PRSS UbndCnt.         0
     Pgrm Load NIU        26 PRSS Err Cnt.         0
     Tot NIU Qtime  00:00:00
     NIU Reclaims.         9

Action commands

Table 189 shows the action commands you can issue from the CICSRGN3 view. The overtype fields are shown in Table 190.

The action commands and overtype fields for the CICSRGN3 view are available for all managed CICS systems for which CICSRGN3 is valid, except as noted in Table 189 and Table 190.

Table 189. CICSRGN3 view action commands
Primary command Line command Description
ARMrestart 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 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 IMM Shuts down the CICS system immediately. All active tasks and Systems Network Architecture (SNA) sessions within the CICS system are terminated.
INItialize INI Initializes the CICS system date and time to match the MVS system date and time-of-day.
NORmshut NOR Shuts down the CICS system normally. The system is shut down as soon as active tasks and SNA sessions within the system are completed.
SECurity 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.

SECurity 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 (see Table 190).
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 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 SNA Displays the CICS SNAP input panel (Figure 89), which lets you specify the options to be used for a snap dump.
STAts 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 TAK Shuts down the CICS system and transfers control of the resources to its XRF partner.
Table 190. CICSRGN3 view overtype fields
Field name Values
Maxtasks (CICS/ESA 4.1 and later systems) 1-999
Maxtasks (CICS/ESA 3.3 only) 32-999
Note:
CICSPlex SM uses a minimum of 6 tasks and may use as many as 16, depending on:
  • how much resource monitoring is active
  • how many real-time analysis status definitions (STATDEFs) are active
Make sure the value in the Maxtasks field is high enough to accommodate all possible CICSPlex SM activity at your enterprise.

Hyperlinks

From the CICSRGN3 view, you can hyperlink from the Tasks field to the TASK view.

[[ Contents Previous Page | Next Page Index ]]