In the previous article, “ISPF Power Tools: Working With the Data Set List Line Commands”, we examined many of the options available on data set lists by using line commands, which are typed to the left of an individual line on the display screen. This article will examine primary commands, which are commands issued from the command, option, or action line that appears at the top or bottom of ISPF displays. The commands listed here are for use on the data set list display produced by ISPF option 3.4 or the Data Set Lists (DSLIST) command. Consider trying these commands on your own ISPF data set list. Unlike the line commands used in the previous article, none of these commands alter data sets or data set members. The SRCHFOR and SAVE commands do create new data sets.
Primary commands for DSLIST include:
• VA, which is “view attributes” mode.
• VS, which is “view space” mode.
• VT, which is “view total” mode.
• VV, which is “view volume” mode.
VV is the IBM default for a data set list display. Although this can be changed on the 3.4 display screen, it’s the best setting for performance when creating a new data set list.
Tool tip: Press the F10 or F11 keys to change the display mode. The sequence for each F10 key press is VT, VA, VS, and VV. The sequence for each F11 key press is VS, VA, VT, and VV. This makes the VA display two key presses using either F10 or F11.
• APPEND ‘dsname.mask’ or APPEND reflist_name. The APPEND command adds data sets to the existing data set list display based on the dsname.mask or a personal reference list (reflist_name). If the apostrophes aren’t used, this command will add your TSO PREFIX to the beginning of the dsname.mask. Mask characters are *, representing any number of characters and %, representing a single character. For example, APPEND ‘SYS1.PROC*’.
• REFRESH or REF. This command rebuilds the original data set list, removing deleted data sets and appended data sets. It also clears the informational messages in the message field and redisplays excluded lines.
• RESET or RES. This command removes the informational messages from the message field and redisplays excluded lines.
• SRCHFOR String. This command invokes the SUPERC utility to search all the data sets listed for specified character strings. If the string isn’t provided, you can enter it on the subsequent screen (see Figure 1).
Tool tips: The options listed on the SRCHFOR screen in Figure 1 include a select display option for viewing output. You should select this option so you don’t have to locate the data set the search utility creates. Also, when viewing output generated by SUPERC Compare or SearchFor options, enter the primary command HI SUPERC. This provides multi-colored highlighting, making the outputs more readable.
• EXCLUDE string, X string, or X ALL. As in ISPF edit, the exclude command hides lines that contain a specified string. These lines are indicated by a message indicating how many lines are hidden (see Figure 2).
• FIND or F string ALL. As in ISPF EDIT, the find command locates lines containing a specified character string. It also supports all the usual options: NEXT, PREV, FIRST, LAST, ALL, PREFIX, SUFFIX, etc.
Tool tip: Using X ALL before a FIND command displays only those lines that match the FIND criteria (see Figure 2). This is useful for seeing multiple matches that may be several screens apart and can be used in conjunction with a SRCHFOR command to limit the data sets searched. (In Figure 1, note the highlighted option titled “Search Excluded.”)