This section describes those display commands that allow you to alter the way in which the contents of a view are displayed in a specific window. It describes how to:
To update the view in the current window, issue the command:
DATARefresh
This has the effect of reissuing the command that produced the view.
To change the parameter values associated with the command that produced the view and refresh the data, issue the command:
PARm parm1 [parm2 parm3 parm4]
where the values parm1 through parm4 are valid parameters of the view command that produced the view. You can specify a maximum of four parameter values.
The view in the designated window is updated to reflect the new parameter values. These values replace the previous or default parameters for the view command and remain in effect until you change them or issue a different view command.
Views in windows whose status is W (waiting) are updated automatically when you press the Enter key, if the cursor is in the control area and no commands are pending. Such views can also be updated automatically, and at predefined intervals, if you activate the automatic screen update (ASU) facility. To activate ASU, issue the command:
ASU [asu]
where asu is the number of seconds, in the range 3 through 999, between automatic screen updates. The value remains in effect until you next change it, or until ASU is deactivated. If you do not specify a value, the default interval, specified in your user profile, is used. The default ASU interval is described in Appendix A. Tailoring your CICSPlex SM profile.
Note that a small interval can increase the CPU overhead if the amount of data to be updated is large.
While ASU is active, no command can be issued for any window, and the COMMAND field contains the message:
ASU MODE interval SECONDS - PRESS ATTN TO CANCEL
where interval is the length of time between updates.
The amount of information visible in a window is determined by the size of that window. The window information line indicates whether there is more information to scroll into view:
You can also use the SHOWPosi display command (which is described in Displaying information about a view) to discover how much data the view contains.
To scroll the contents of a window to see additional information, you can use the ISPF scroll commands:
Up
Down
LEft
RIght
To specify the amount of scrolling to occur, use one of the following parameters on the appropriate scroll command:
You can sort the rows of data in a general or summary view using any of the fields in the view as a sort key. To sort the contents of a view, you
SOrt [D|A]
in the
COMMAND field of the Information Display panel. The value D means that the
data is to be sorted in descending order; A means that it is to be sorted
in ascending order. If neither is specified, numeric data is sorted in descending
order, and nonnumeric data is sorted in ascending order.Alternatively, if the SOrt command is assigned to a PF key, position the cursor on the appropriate field before pressing the PF key.
For example, suppose that a field in the view in the current window contains statistical data in descending order. To rearrange the rows so that the contents of that field are in ascending order in the view, you would type SOrt A in the COMMAND field, place the cursor on any occurrence of the field or on the field heading, and press Enter.
The Locate command moves the cursor to a specified data string in a selected column of a general or summary view. (It cannot be used in a detail view.) Once a Locate command has been issued, it can be repeated using the RFind command.
You must move the cursor to the relevant column before you issue the Locate command. If you issue the locate command without first positioning the cursor in the appropriate column, the target string is sought in the leftmost column of the view.
If the target string is in a column that is not in the visible portion of the view, a message is issued telling you to scroll to the left or right to move the data into view.
To go directly to a string within a view of tabular data, issue the command:
Locate string [FIRST | LAST | PREV | NEXT]
where:
L *lgs
locates a string ending with the characters "lgs" in the specified
column.
If you issue the Locate command without the FIRST, LAST, PREV, or NEXT parameter, the search begins at the row following the cursor position. If the cursor is in the command field, the search begins with the first visible row.
If you issue the Locate command with the PREV parameter, the search begins at the row before the cursor position. If you issue the Locate command with the LAST or PREV parameter, and then issue the RFIND command, Locate continues to work backwards through the occurrences of the string and goes to the occurrence before the last one that it located.
You can summarize the data in a general or summary view using any field in that view as the grouping factor. When you summarize a summary view, the data is resummarized by the new grouping factor.
For example, in a view containing the fields Program Language, CEDF Option, and Enabled Status, you can summarize the view contents by using program language, CEDF option, or enabled status as the grouping factor. The summary comprises one summary line for each possible value of the chosen field. So if you summarize a view of program data using CEDF Option as the grouping factor, the summary comprises two lines, one for programs with CEDF, and one for programs with NOCEDF.
To summarize data using CICS® system name as the grouping factor, simply issue the command:
SUM
as shown in Figure 33.
27FEB2005 11:30:30 --------- INFORMATION DISPLAY ------------------------------ COMMAND ===> SUM_ SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> W1 =PROGRAM==========EYUPLX01==EYUCSG01=27FEB2005==11:30:30==CPSM============= CMD Program CICS Enabled Use Current Program Shared CEDF Copy --- Name---- System-- Status-- Count-- Use---- Language- Status- Option Require PROG0123 EYUMAS1A ENABLED 1 0 ASSEMBLER PRIVATE CEDF NOTREQU PROG0123 EYUMAS1B DISABLED 0 0 COBOL SHARED NOCEDF NOTREQU PROG0345 EYUMAS1B DISABLED 0 0 PLI PRIVATE NOCEDF NOTREQU PROG0445 EYUMAS1A ENABLED 0 0 C SHARED NOCEDF NOTREQU PROGABCD EYUMAS1B DISABLED 0 0 PLI PRIVATE NOCEDF NOTREQU PROGABCD EYUMAS1A DISABLED 0 0 C SHARED NOCEDF NOTREQU
Figure 34 shows the summary that results from issuing the SUM command against the view shown in Figure 33.
27FEB2005 11:30:30 --------- INFORMATION DISPLAY ------------------------------ COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> W1 =PROGRAM==PROGRAMS==EYUPLX01=EYUCSG01=27FEB2005==11:30:30==CPSM============ CMD Program CICS Count Enabled Use Current Program Shared CEDF C --- Name---- System-- ----- Status-- Count-- Use---- Language- Status- Option R PROG0345 EYUMAS1B 3 DISABLED 0 0 PLI PRIVATE NOCEDF N PROGABCD EYUMAS1A _ 3 DISABLED 0 0 C SHARED NOCEDF N
To summarize data using a specific column of the view (other than CICS system) as the grouping factor, type the SUM command in the COMMAND field, position the cursor anywhere in the appropriate column, and press Enter. Alternatively, if the SUM command has been assigned to a PF key, position the cursor before pressing the PF key.
The online help facility provides information about the way CICSPlex SM summarizes the contents of each column in a view. Data can be summarized in the following ways:
When all elements in the summarized field have the same value, shows that value. When all elements in the summarized field are identical in part of their values, shows the like parts of the value with asterisks (*) representing the unlike parts (for example, CMAS1***). When no part of the value is common to all elements in the summarized field, shows asterisks.
To display this information, position the cursor in the appropriate column of the summary before you issue the HELp command.
You can issue line action commands against any of the summary lines. If you do this, however, all of the CICS resources combined to form the summary line are affected by the command. Therefore, before you issue an action command, it is recommended that you display the information used to create the summary line. To do this, position the cursor in the Count field of the appropriate summary line and press Enter. Figure 35 shows an example view in which the second of the two summary lines in Figure 34 has been expanded.
27FEB2005 11:30:30 --------- INFORMATION DISPLAY ------------------------------ COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> W1 =PROGRAM===========EYUPLX01=EYUCSG01=27FEB2005==11:30:30==CPSM============= CMD Program CICS Enabled Use Current Program Shared CEDF Copy --- Name---- System-- Status-- Count-- Use---- Language- Status- Option Require PROG0123 EYUMAS1A ENABLED 1 0 ASSEMBLER PRIVATE CEDF NOTREQU PROG0445 EYUMAS1A ENABLED 0 0 C SHARED NOCEDF NOTREQU PROGABCD EYUMAS1A DISABLED 0 0 C SHARED NOCEDF NOTREQU
Note that a summary line can be expanded only within the window containing the summary line.
The information in windows whose status code is W (waiting) is updated automatically:
To prevent this automatic screen update occurring, issue:
LOCK
This command locks the contents of the target window and changes its status code to L (locked). The contents of any other windows continue to be updated automatically.
While a window remains locked, its contents cannot be updated automatically. However, you can change the contents of a locked window by directing commands directly to that window. That is, the locked window can be the current window, or you can prefix commands with the identifier of the locked window.
To remove the lock from a window, and so restore its ability to be updated automatically, issue:
UNLOck
The window status code is changed from L (locked) to W (waiting).
The CICSPlex SM view commands cause data about CICS resources and CICSPlex SM definitions to be displayed. Once a view is displayed, you can create a new form of the data by:
Occasionally you will need to redisplay previously displayed forms of views. For this purpose, CICSPlex SM supplies two display commands, the effects of which differ somewhat from the hierarchical order of the ISPF END command.
ENDQ
Each view is redisplayed in the form in which it was last displayed.
This command can be issued up to 10 times in succession to redisplay, in reverse order, each of the 10 previously displayed views.
The data shown in each view is refreshed as it is redisplayed.
END
This command can be issued up to 20 times in succession. When the forms of the last view have been exhausted, the forms of the immediately preceding view are redisplayed.
For the first redisplayed view (and all of its forms), the data shown is the same data as previously displayed.
For each subsequently redisplayed view the data is refreshed. (The data is not separately refreshed for each redisplayed form.)
By using both the ENDQ and the END commands, you can redisplay (in reverse order) up to 20 forms of a maximum of 10 previously displayed views. To illustrate the way the two commands redisplay views and forms of views, suppose you have displayed the following views, in this order:
Tables Table 3, Table 4, and Table 5 show the results of issuing either ENDQ or END repeatedly or both in combination.
Issue this command | To display this view | In which data is... |
---|---|---|
PROGRAMD | ||
ENDQ | TERMNL2 | Refreshed |
ENDQ | LOCTRAN | Refreshed |
Issue this command | To display this view | In which data is... |
---|---|---|
PROGRAMD | ||
END | PROGRAM | As you last displayed it |
END | TERMNL2 | Refreshed |
END | TERMNLD | Same refresh as TERMNL2 |
END | TERMNL | Same refresh as TERMNL2 |
END | LOCTRAN | Refreshed |
Issue this command | To display this view | In which data is... |
---|---|---|
PROGRAMD | ||
END | PROGRAM | As you last displayed it |
ENDQ | TERMNL2 | Refreshed |
END | TERMNLD | Same refresh as TERMNL2 |
ENDQ | LOCTRAN | Refreshed |
When you have redisplayed the last view or form that CICSPlex SM has retained, the message NO MORE VIEWS IN STACK appears in the short message area. If you continue to issue the END command after having received this message, CICSPlex SM:
To remove the contents of the current window, issue:
CLEar
The CLEar command sets the status code of the affected window to T (temporary).
If the status code of the target window is P (pending) when you issue the CLEar command, the command that is currently processing in that window is completed. Other outstanding commands are discarded.
[[ Contents Previous Page | Next Page Index ]]