Manipulating the contents of a window

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:

Refreshing the view in a single window

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.

Refreshing all views automatically

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.

Note:
To deactivate ASU, you must cause a TSO terminal attention. How you do this depends on the hardware you are using. For example, if you are using an IBM® 3270 display, you can cause a TSO terminal attention by pressing the ATTN key. On other types of display, such as the IBM Personal Computer or the IBM 3179 display, you must unlock the keyboard, by pressing the RESET key, and then press the PA1 key. Be sure to find out how to invoke the ATTN function on your terminal before starting ASU.

Scrolling data in a window

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:

Page
Scrolls a full page, which is the total scrollable area visible in a window. This is the CICSPlex® SM default.
Data
Scrolls one row (if the command is Up or Down) or one field (if the command is LEft or RIght) less than a page.
Half
Scrolls half a page.
number
Scrolls a number of rows or fields in the range 0 through 9999.
Csr
Scrolls to the cursor position. If the cursor is in a field, the display begins at the start of that field.
Max
Scrolls to the top, bottom, left, or right margin of the window, as appropriate, and resets the SCROLL field to its previous setting.

Notes:
  1. If you specify no parameter on a scroll command, the default scroll parameter, which is displayed in the SCROLL field in the control area of the information display panel, is used. You can use any of these parameters to overtype the default scroll value. This changes the default value for the remainder of the CICSPlex SM session, or until it is next changed.
  2. If your PF key settings are displayed, they may cover the last two lines in a window or help pop-up panel. To prevent this from happening, issue the ISPF command PFSHOW OFF.
  3. Scrolling to the left or right occurs by field, not by column. The amount of a left or right scroll is reduced by the width of these fields, which are not scrollable:
    • The line command field and the first data field in a general view
    • The line command field in a detailed view
    If you scroll right and then left again by a full page, the original contents of the view may not be restored. This situation arises because, when CICSPlex SM scrolls to the right, the first field that is not completely within the view becomes the leftmost scrollable field; when you scroll left again, CICSPlex SM keeps that field wholly within the visible part of the view in its new position as the rightmost field.
  4. If you scroll to or beyond the last line of data in a view, two lines of data remain visible.

Sorting the contents of a view

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

  1. Type the command:
       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.
  2. Move the cursor to the column that is to act as sort key, and press Enter.

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.

Locating data within a view

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:

string
is the character string you want to locate, and must be specified. The string value may begin or end with an asterisk (*) in place of one or more characters. For example, the command:
L *lgs
locates a string ending with the characters "lgs" in the specified column.
FIRST | LAST | PREV | NEXT
In views where there may be multiple occurrences of the target string in the specified column, you can go directly to the first, last, previous, or next occurrence of the string by specifying the FIRST, LAST, PREV, or NEXT parameter on the Locate command.

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.

Summarizing the data in a view

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.

Note:
The SUM command always summarizes the data originally collected for a general or summary view. If you expand a summary line and display the information used to create the line, a subset of the summarized data is displayed; if you then issue another SUM command, all of the original data (not just the subset of data you just displayed) is resummarized using the new grouping factor. Likewise, if the original general or summary view command was qualified with parameters, only the data collected for the original view can be summarized.

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.

Figure 33. Summarizing data by CICS system name
 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.

Figure 34. A Program view summarized by CICS system name
 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:

AVG
Shows the average value of all the values in the summarized field.
LAST
Shows information for all data elements having the like condition (for example, ENABLED).

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.

Note:
The comparison between the like condition and the data elements is not case-sensitive. The generic result is presented in upper case.
MAX
Shows the maximum value of all the values in a summarized field.
MIN
Shows the minimum value of all the values in a summarized field.
SUM
Shows the total of all values in the summarized field.
Note:
All methods of summarizing, except LAST, apply only to numeric fields.

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.

Figure 35. A summary line 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.

Locking and unlocking a window

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).

Redisplaying views and forms of views

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.

  1. To redisplay, in reverse order, each previously displayed view, issue:
       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.

  2. To redisplay, in reverse order, each form of each previously displayed view, issue:
       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.

Table 3. Results of issuing ENDQ
Issue this command To display this view In which data is...
  PROGRAMD  
ENDQ TERMNL2 Refreshed
ENDQ LOCTRAN Refreshed

 

Table 4. Results of issuing END
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

 

Table 5. Results of combining ENDQ and END
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:

Note:
While using a screen configuration, issuing END ends the current view and redisplays the previous view in that screen configuration. Any views displayed prior to specifying the screen configuration are discarded. (Refer to Saving and reusing screen configurations for more information.)

Clearing a window

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 ]]