Views

A CICSPlex® SM view is a formatted display of data about one or more CICS® resources or CICSPlex SM definitions. There are three forms of most CICSPlex SM views:

General view
A general view contains information about multiple CICS resources or CICSPlex SM definitions within the context and scope of the window. This information is presented in tabular form (rows and columns).
Summary view
A summary view contains summarized information about multiple CICS resources within the context and scope of the window. Each column of data is summarized using rules appropriate to the type of data. This information is presented in tabular form.
Detailed view
A detailed view contains information about a single CICS resource or CICSPlex SM definition within the context and scope of the window.

If your CICSplex includes systems running a release of CICS for which a view is not available, those systems are not included in that view. If you issue a view command and your CICSplex consists solely of such systems, the following message is displayed:

   BBMXBD15I There is no data that satisfies your request.

The online help facility provides view availability information. Refer to The CICSPlex SM help facility for details.

Displaying a view

You can display a view:

Each of these ways of displaying a view is described in the remainder of this section.

Issuing a view command

A view command has the same name as the view it produces, or of the form of the view it produces. For example, the PROGRAM view command produces the PROGRAM view; the PROGRAMD command produces a detail form of the PROGRAM view. Many of the view commands have parameters that you can use to refine your request. For example, the full form of the PROGRAM view command is:

PROGRAM [prgrmid [ENABLED|DISABLED]]

Therefore, you can request a display of all enabled programs, or all disabled programs, or of a particular program, within the current context and scope. If you specify more parameters than are valid on any particular view command, a message is issued.

Note:
If you issue a command that results in a display of general or summary views, thousands of records may be displayed. (For example, you might issue the LOCTRAN command to display a list of all local transactions.) The value you specified in the Warning Record Count field on the CICSPlex System Manager entry panel determines the maximum number of records that are displayed without a warning message. (For more information about the Warning Record Count field, see topic Warning Record Count.) When the number you specify is exceeded, a warning message similar to the following example is displayed:
    The data for the current request may result
    in more than 5000 records.
The number of records shown in the message is the number of records available when your request is processed. The number that is actually displayed may be different, depending on events that occur in the CICSPlex SM environment during the interval between your request and the display of records.

To display the records, press Enter. To terminate the request without displaying the records, type END or CANCEL. When you terminate the request, the name of the view for which you issued the command is shown, and the following message is displayed:

    Request for data has been cancelled.

You can either reissue the original command, with parameters that reduce the number of records that will be displayed, or issue a different command.

You issue a view command by entering it in the COMMAND field of the information display panel and pressing Enter. You can also assign CICSPlex SM view commands to PF keys, as described in Appendix A. Tailoring your CICSPlex SM profile.

This book does not describe the CICSPlex SM view commands. For detailed descriptions of the view commands and of their effects, see the appropriate books in the CICSPlex SM library.

Selecting a view name from a menu

When you know the name of the view you want to see, you can display it simply by issuing the appropriate view command. Sometimes, however, you might not know the name of the view you want to see. When this happens, you can find the name of the view in a menu.

A menu is a list of other menu names or of view names. Figure 17 and Figure 18 show the different levels of menus.

Figure 17. MENU and ANALYSIS menus
 This figure illustrates the menu and analysis menus. These are described in the following text.

In Figure 17:

Figure 18. MENU, OPERATE, and FILE menus
 This figure illustrates the menu, operate and file menus. These are described in the following text.

In Figure 18:

You can display a menu by issuing a command that specifies the menu you want to see or by selecting its name from another menu. From any menu, you can select and display another menu or a view. To make a selection from a menu, do one of the following:

For example, when you issue the command MENU, the menu shown in Figure 19 appears.

Figure 19. The MENU menu
 27FEB2005  18:49:03 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =MENU==============EYUPLX01=EYUPLX01=27FEB2005==18:49:03=CPSM=========14===
 CMD Name                 Description
 --- -----------------------------------
     ANALYSIS   Real Time Analysis Operations Views
     CONFIG     CMAS Configuration Operations Views
     MONITOR    Monitoring Views
     OPERATE    Operations Views
     TOPOLOGY   Topology Operations Views
     WORKLOAD   Workload Operations Views
     ========   ================================================================
     ADMSAM     RTA System Availability Monitoring Administration Views
     ADMMRM     RTA MAS Resource Monitoring Administration Views
     ADMAPM     RTA Analysis Point Monitoring Administration Views
     ADMCONFG   CMAS Configuration Administration Views
     ADMMON     Monitor Administration Views
     ADMTOPOL   Topology Administration Views
     ADMWLM     Workload Manager Administration Views
     ADMBAS     Business Application Services Administration Views
     ADMRES     Business Application Services Resource Views
 
 
 
  

You can also display the MENU menu by selecting option 2 CPSM from the CICSPlex System Manager entry panel.

The MENU menu is a list of other menu names. To display the menu of ANALYSIS views, you can either select ANALYSIS from the MENU menu, or type the command MENU ANALYSIS. When you do this, the ANALYSIS menu shown in Figure 20 appears.

Figure 20. The ANALYSIS menu
 27FEB2005  16:51:23 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =MENU==============EYUPLX01=EYUPLX01=27FEB2005==16:51:23=CPSM==========4===
 CMD Name             Description
 --- -------------------------------
     ANALYSIS    Real Time Analysis Operations Views
       APACTV      Installed Definitions in Analysis Point
       EVENT       Outstanding Events
       RTAACTV     Installed Analysis Definitions
 
 

In the same ways, you can display a menu that is a list of OPERATE menus, or classes of OPERATE views, as shown in Figure 21.

Figure 21. The OPERATE menu
 27FEB2005  19:34:08 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =MENU==============EYUPLX01=EYUPLX01=27FEB2005==19:34:08=CPSM=========15===
 CMD Name             Description
 --- -------------------------------
     OPERATE     Operations Views
       CICSBTS     CICS BTS Views
       CONNECT     Connection Views
       DOCTEMP     Document Template Views
       DB2         DB2 and DBCTL Views
       ENQUEUE     Global Enqueue Views
       EXIT        Exit Views
       FEPI        FEPI Views
       FILE        File Views
       JOURNAL     Journal Views
       PROGRAM     Program Views
       REGION      CICS Region Views
       TASK        Task Views
       TCPIPS      TCPIP Service Views
       TDQ         Transient Data Queue Views
       TEMPSTOR    Temporary Storage Queue Views
       TERMINAL    Terminal Views
       TRANS       Transaction Views
       UOW         Unit of Work Views
 
 

As a shortcut, you can display a menu by typing only the name of the menu (for example, instead of MENU OPERATE, you can type only OPERATE) in the COMMAND field. However, when you display a menu in this manner, you cannot specify any qualifier with the menu name; thus, you will always get a list of all general and summary views when you use this method. (The qualifiers are described in topic menu command qualifiers.) To display the OPERATE menu of FILE views, you can select it from the OPERATE menu, or you can issue the command MENU OPERATE FILE. In fact, the order of the classes does not matter, so you can achieve the same result by issuing the command MENU FILE OPERATE.

Similarly, you can display a menu that lists classes of MONITOR views, as shown in Figure 22.

Figure 22. The MONITOR menu
 27FEB2005  19:34:08 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =MENU==============EYUPLX01=EYUPLX01=27FEB2005==19:34:08=CPSM=========14===
 CMD Name             Description
 --- -------------------------------
     MONITOR     Monitoring Views
       MONACTV     Installed Monitor Definitions
       ========    =============================================================
       CONNECT     Connection Monitoring Views
       DB2         DB2 and DBCTL Monitoring Views
       FEPI        FEPI Monitoring Views
       FILE        File Monitoring Views
       GLOBAL      Global Resource Monitoring Views
       JOURNAL     Journal Monitoring Views
       PROGRAM     Program Monitoring Views
       REGION      CICS Region Monitoring Views
       TDQ         Transient Data Queue Monitoring Views
       TEMPSTOR    Temporary Storage Queue Monitoring Views
       TERMINAL    Terminal Monitoring Views
       TRANS       Transaction Monitoring Views
 

Note that the MONITOR menu, like the OPERATE menu, also lists a FILE class of views. To display a menu that lists all of the FILE views, for both MONITOR and OPERATE, issue the command MENU FILE. This produces a menu like the one shown in Figure 23.

Figure 23. The FILE menu
 27FEB2005  19:34:08 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =MENU==============EYUPLX01=EYUPLX01=27FEB2005==19:34:08=CPSM=========28===
 CMD Menu/View        Description
 --- --------------------------------------------------------------
     MONITOR     Monitoring Views
       FILE        File Monitoring Views
         MCMDT       Monitor Data Tables
         MCMDTS      Monitor Data Table Summary
         MLOCFILE    Monitor Local Files
         MLOCFILS    Monitor Local File Summary
         MREMFILE    Monitor Remote Files
         MREMFILS    Monitor Remote File Summary
     OPERATE     Operations Views
       FILE        File Views
         CFDTPOOL    Coupling Facility Data Tables
         CFDTPOOS    Coupling Facility Data Table Summary
         CMDT        Data Tables
         CMDTS       Data Table Summary
         DSNAME      Data Sets
         DSNAMES     Data Set Summary
         FILE        Files
         FILES       File Summary
         LOCFILE     Local Files
         LOCFILES    Local File Summary
         LSRPBUF     LSR Pool Buffers
         LSRPBUS     LSR Pool Buffer Summary
         LSRPOOL     LSR Pools
         LSRPOOS     LSR Pool Summary
         REMFILE     Remote Files
         REMFILES    Remote File Summary
 

Usually, on a menu that lists views, only general and summary views are shown. You can qualify a menu command to include or exclude subsets of views, by adding a qualifier to the command, as follows:

+
Expands the specified menu, so that all levels below the level specified are listed.
+D
Includes general, detail, and summary views.
(That is, detail views are added to the normally displayed list.)
-G
Excludes general views.
Includes summary views.
-S
Excludes summary views.
Includes general views.
Note:
You can combine qualifiers. Thus, if you issue the command MENU OPERATE +D -S, the menu displayed shows all of the OPERATE general and detail views. As an example, issuing the command MENU OPERATE + produces a menu like the one shown in Figure 24.
Figure 24. An example of a partial OPERATE + menu
 27FEB2005  19:34:08 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =MENU==============EYUPLX01=EYUPLX01=27FEB2005==19:34:08=CPSM=========15===
 CMD Name             Description
 --- -------------------------------
     OPERATE     Operations Views
       CICSBTS       CICS BTS Views
         PROCTYP     CICS BTS ProcessTypes
         PROCTYPS    CICS BTS ProcessType Summary
       CONNECT     Connection Views
         CONNECT     ISC/MRO Connections
         CONNECTS    ISC/MRO Connection Summary
         MODENAME    LU6.2 Modenames
         MODENAMS    LU6.2 Modename Summary
         PARTNER     CICS Partners
         PARTNERS    CICS Partner Summary
         PROFILE     CICS Profiles
         PROFILES    CICS Profile Summary
       DOCTEMP     Document Template Views
         DOCTEMP     Document Templates
         DOCTEMPS    Document Template Summary
       DB2         DB2 and DBCTL Views
         DBCTLSS     DBCTL Subsystems
         DBCTLSSS    DBCTL Subsystem Summary
         DB2SS       DB2 Subsystems
         DB2SSS      DB2 Subsystem Summary
 

Another example shows that issuing the command MENU OPERATE FILE -S produces a menu of OPERATE FILE views, excluding the summary views, as shown in Figure 25.

Figure 25. The OPERATE FILE -S menu
 27FEB2005  19:34:08 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =MENU==============EYUPLX01=EYUPLX01=27FEB2005==19:34:08=CPSM==========9===
 CMD Name             Description
 --- -------------------------------
     OPERATE      Operations Views
       FILE         File Views
         CFDTPOOL     Coupling Facility Data Tables
         CMDT         Data Tables
         DSNAME       Data Sets
         FILE         Files
         LOCFILE      Local Files
         LSRPBUF      LSR Pool Buffers
         LSRPOOL      LSR Pools
         REMFILE      Remote Files
 
 

Selecting a view from the VIEWS menu

The VIEWS menu also provides access to views; you can display it by issuing the VIEWS command. The VIEWS menu lists all of the available views in alphabetic order. To display a partial list of views, issue the command with a specific or generic view name. For example, to display a list of all the views that begin with the letter C, issue the following command:

    VIEWS C*

To select and display a view from the VIEWS menu, do either of the following:

Note that on the VIEWS menu list, unlike the MENU menu, you cannot overtype command parameters in the view name and description fields.

Initiating a hyperlink to another view

Many views contain hyperlink fields, which provide a direct route from information shown in one view to related information in a different view. Hyperlink fields appear either in high intensity or in a different color from other fields in the view.

The view that results from a hyperlink can be displayed:

To direct the results of a hyperlink to the window from which you initiate the hyperlink, simply place the cursor anywhere within the data portion of a hyperlink field and press Enter.

To direct the results of a hyperlink to a second window, type the identifier of that window in the ALT WIN field, place the cursor anywhere within the data portion of the hyperlink field, and press Enter. If you want to direct the results of all subsequent hyperlink requests to the same alternate window, prefix the value in the ALT WIN field with an ampersand (&). For example, entering the value

   &3

in the ALT WIN field causes the results of all subsequent hyperlink requests to appear in window 3.

Regardless of where the results of the hyperlink are directed, the window in which the results are displayed becomes the current window.

Notes:
  1. You cannot hyperlink to an alternate window from a summary view.
  2. You cannot hyperlink on a name which is in mixed case if this name is the key field of another resource.

The results of a hyperlink request

The view resulting from a hyperlink request can contain either new data or a different form of the existing data. Whether you get new or existing data is determined by the window in which the resulting view is to be displayed, and the existing contents of that view. That is:

Figure 26. Hyperlink fields within CICSPlex SM views
 Hyperlink fields can be used to display related information in the same window or in another window.

How hyperlinks affect context and scope values

When you direct the results of a hyperlink to an alternate window, CICSPlex SM ensures that the context and scope of that window are the same as those of the window from which the hyperlink was requested. The context and scope of the alternate window are restored to their previous values when you next clear that window.

Specifying command parameters

Many of the CICSPlex SM view and display commands can be qualified by parameters. For example, here’s the syntax of the PROGRAM view command, which displays general information about programs currently listed in the processing program table (PPT):

PROGRAM [prgmid [ENABLED | DISABLED]]

The parameter prgmid is a variable that identifies one or more instances of a program. The values ENABLED and DISABLED are literals that can be used to list the group of programs you’re interested in according to their status.

For any variable parameter, you can provide either a specific or a generic name. Generic names can contain:

CICSPlex SM command parameters are positional: they must be entered in the order shown and be separated from the command and each other by one or more blank spaces. For example, the view command:

PROGRAM DFHB* ENABLED

displays general information about all enabled programs whose names begin with the characters DFHB. The view command:

PROGRAM DISABLED DFHB*

is invalid, because the parameters are not specified in the correct order.

Note:
When you select a view from a menu, you can overtype the line containing the view name and description with parameters before you press Enter.

When you specify an incorrect parameter a panel appears, containing messages telling you that your request is incorrect and describing or showing the correct parameters. Figure 27 is an example of the panel that appears when you type a numeric value instead of a correct program name.

Figure 27. Example of command parameters panel
 ------------------------- CICSPlex SM Command Prompter ------------------------
 COMMAND ===>
   Request for  PROGRAM   View incorrect.
   HIGHLIGHTED FIELDS IN ERROR.
   Type over value or Select option where presented.
 
 Program Name     *                 Field may be Generic.
                                    And Must be: NAME.
 
 Program Status   CT1VW             Specify or Select:
                                     _ ENABLED
                                     _ DISABLED
                                     _ *
 
 
 
 
 
 Press ENTER to process command.
 Type END or CANCEL to terminate without processing.
 

You can type the correct value over the incorrect value in the highlighted field or, when the parameter must be a specific value (for example, program status, which must be ENABLED, DISABLED, or * for both), you can select the correct value from the selection list.

Using action commands to update data

CICSPlex SM action commands act on the data displayed in a view and cause the view to be refreshed. Action commands are either primary action commands or line action commands.

Primary action commands
Primary action commands affect one or more instances of a CICS resource or CICSPlex SM definition in a view. You issue primary action commands and their parameters by entering them in the COMMAND field of the control area, or by pressing the PF key to which they are assigned. Note that, if you specify more parameters than are valid on a primary action command, the surplus parameters are ignored: no warning message is issued.

When you use a form of a CICSPlex SM primary action command that is the same as an ISPF command, the ISPF command takes effect. For example, when you issue the START primary action command, you are swapped to an ISPF session. To avoid this, issue the action command STA from the SYSTEMS view, specifying a parameter that identifies the system that is to be started.

Line action commands
Line action commands affect either a specific occurrence of a resource or definition or, in a summary view, all of the resource instances that contributed to the summary line. Line action commands are issued from the line command field.

Not all action commands are available for all of the supported CICS releases. If you issue an action command that is not available for the specified CICS system, the following message is displayed:

 EYUEI0596E Action action for sysname not supported for this release of CICS

The online help facility provides availability information for action commands that are not available for all of the supported CICS releases. Refer to The CICSPlex SM help facility for details.

If you issue an invalid action command, or if a command cannot be processed for any reason, error messages may be displayed in the window. When you press Enter, any additional messages that could not fit in the window are displayed. Once all the messages have been displayed, you can press Enter to clear the messages from the window. The view reappears with ERR in the field where the action command was entered. (When the action command is entered from a summary view and the command was successful for only some of the resources summarized, MIX appears in the field; this indicates the action command produced mixed results.) The next time you press Enter, ERR (or MIX) is removed.

In some cases, messages are not automatically displayed in the window. Instead, the ERR indicator appears where the action command was entered. When this happens, you can position the cursor on the ERR indicator and press Enter to display the messages in the window.

Figure 28 shows the location of the COMMAND field and of the line command field in both general and detailed views.

Figure 28. The COMMAND field and some line command fields
 The COMMAND field in the control area of a panel is used to issue primary action commands.  The line command field is always in the leftmost position of a row of data in a view.  For general views, the field is labeled CMD and precedes each row in the view.  For detail views, there is a single, unlabeled field in the leftmost corner of the view.

Notes:
  1. The primary command typed in the COMMAND field enables the program EYUPAUTO shown in the general view in window 1, the current window.
  2. Two line commands are specified in the general view shown in
    window 1. Each line command causes a specific program shown in that view to be disabled. If window 1 contained a summary view, the line commands would affect all of the resources represented by each line in the view.
  3. One line command is specified in the detail view shown in window 2. This command causes the program identified in this view (EYUPR002) to be disabled.
  4. When you press either Enter or a PF key, all outstanding primary and line action commands in all windows are processed.

To discover which action commands are valid for a particular view, issue the HELp ACTIONS display command, as described in Requesting help within help. Action commands that are valid for a particular view are also identified in the description of that view. Views are described in detail in other books in the CICSPlex SM library.

Repeating a line action command within a view

As you can see from Figure 28, you can enter one line action command at a time in a detail view, but multiple line action commands in a general or summary view. You can repeat a line action command within a view by typing the equals sign (=) in the line command field before pressing Enter. When multiple line action commands are entered (either explicitly or by using the equals sign) they are processed from the top to the bottom of the view. For example:

 CMD Program  CICS
 --- Name---- System--
 dis PROG0123 CICS1232
     PROG0323 CICS1233
 =   PROG0345 CICS1234
 ena PROG0445 CICS1234
 =   PROG0355 CICS1235

These line action commands disable programs PROG0123 and PROG0345, and enable programs PROG0445 and PROG0355. The status of PROG0323 is unaltered.

Overtype fields

An overtype field is a modifiable field in a view that contains data related to a specific CICS resource or CICSPlex SM definition. The data can be either of the following:

Overtype fields are shown in either high intensity or color. For you to change the contents of an overtype field, the entire field must be visible. If it is not, you can scroll the window to the left or right to display the remainder of the field. Alternatively, you can use the MAXimize display command, as described in Maximizing and restoring windows, to maximize the window containing the view.

When the value you enter does not completely overwrite the old value, you do not have to delete the remainder of the field. After you press Enter, only the newly overtyped information is in effect.

If you specified YES in the Require Set field on the CICSPlex System Manager entry panel, you must also use the SET line action command to prevent inadvertent modification of information. When you overtype the contents of a field (using SET, if required) and press Enter, CICSPlex SM accepts the new values.

For specific values known to CICSPlex SM, you need not type the entire value; you can type the smallest number of unique characters needed to distinguish your request from any other appropriate entry for that field. For example, to specify program status, you need type only E (for ENABLED) or D (for DISABLED). When your request is not specific enough, or when you enter a value that is not one of the specific values known to CICSPlex SM, you are prompted for more specific information and provided with a selection list from which to select a value. (For example, this occurs when you overtype only S on the LOCTRAND view in the Trace Option field, where the possible values are SPECTRACE, STANTRACE, and SPRSTRACE.)

When, in a field for which CICSPlex SM expects no specific values but has certain requirements, you enter a value that does not meet the requirements, a popup panel appears containing both a message describing the requirements and a field in which you can enter the correct value. (For example, this occurs when you enter a value outside the range of acceptable values for a numeric field.)

Note:
When you want to make more significant modifications to a definition in the data repository, you can use the UPDate command to display a panel similar to the panel used to create the definition.

To change the contents of one or more overtype fields in a general or summary view:

  1. If the value in the Require Set field on the CICSPlex System Manager entry panel is YES, specify the SET action command in the line command field next to each resource occurrence to be altered. (For more information about the Require Set field, see Require Set.)
  2. Overtype the current contents of any overtype fields you want to alter with new values.
  3. Repeat steps 1 and 2 for each resource occurrence that you want to modify.
  4. Press Enter.

For example, window 1 in Figure 29 shows how you might change the attributes of two programs. EYUPAUT2 is to change from disabled to enabled status, and EYUPR001 is to be both enabled and marked as shared.

To change the contents of one or more overtype fields in a detail view:

  1. If the value in the Require Set field on the CICSPlex System Manager entry panel is YES, specify the SET action command in the line command field next to each resource occurrence to be altered. (For more information about the Require Set field, see Require Set.)
  2. Overtype the contents of each field you want to alter.
  3. Press Enter.

Window 2 in Figure 29 shows how you might change multiple attributes associated with a single resource. In this case, program EYUPR002 is to be enabled, marked as private, and its CEDF option is to be set to NOCEDF.

Overtype fields containing the value "N/A" or "NOTAPPLIC" (meaning "not applicable") are not modifiable. Typically, an overtype field contains this value because the field does not apply to a particular release of CICS. If you position the cursor on the affected field before entering the HELp command (as described in Issuing HELP without parameters), a description of the field, identifying those CICS releases to which it applies, is displayed.

Figure 29. Using overtype fields in CICSPlex SM views
 In general views, you can change information about multiple resources by typing SET before each resource name and then overtyping one or more modifiable fields within the row.  In detail views, you can change information about a single resource by typing SET in the line command field and then overtyping one or more modifiable fields within the view.

Moving the cursor

To move the cursor between multiple windows in an information display panel, you can use:

The New Line key and the Tab key do not move the cursor to empty windows.

[[ Contents Previous Page | Next Page Index ]]