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:
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.
You can display a view:
Each of these ways of displaying a view is described in the remainder of this section.
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.
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.
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.
In Figure 17:
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.
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.
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.
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.
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.
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:
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.
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
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.
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.
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:
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.
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.
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.
------------------------- 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.
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.
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.
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.
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.
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.
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.)
To change the contents of one or more overtype fields in a general or summary view:
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:
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.
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 ]]