z/os Basic Information Center: Introduction to ISPF Unit 2: Editing with ISPF Module 4: ISPF Editor Search Functions

Transcription

1 z/os Basic Information Center: Introduction to ISPF Unit 2: Editing with ISPF Module 4: ISPF Editor Search Functions Copyright IBM Corp., All rights reserved.

2 ISPF Editor Search Functions Introduction In this module, Searching data sets with the ISPF editor, we ll explore a number of commands that help you search for, change and exclude string data in data set members. The editor allows you to specify various types of string data, including: simple strings, delimited strings, hexadecimal strings, character strings, and picture strings. Time to complete: minutes Copyright IBM Corp., All rights reserved. Page 2 of 14

3 ISPF Editor Search Functions Objectives Upon completion of this module, you should be able to: Find data strings in a data set member Change one or all occurrences of a data string in a data set member Define ranges to limit the scope of the FIND, CHANGE, and EXCLUDE commands Exclude and redisplay lines of text in a member Copyright IBM Corp., All rights reserved. Page 3 of 14

4 ISPF Editor Search Functions Using the FIND Command to Search You may have learned about the FIND command in the module on Working with Data Sets. You can use the FIND command to search for a specific string of characters. Type FIND at the command line, followed by the string. If the search string contains blanks or special characters, enclose it in quotes. For example: ===> FIND SET CMSTYPE The ISPF editor finds and highlights all occurrences of the target string and moves the cursor the first line that contains the string. Copyright IBM Corp., All rights reserved. Page 4 of 14

5 ISPF Editor Search Functions The CHANGE Command Use the CHANGE command to search for a string and replace it with a second string. The CHANGE command takes two strings. The first string is the target text, and the second is the replacement text. For example, the following command: ===> CHANGE #globalcsi globalcsi searches for the first occurrence of the target string #globalcsi and replaces it with the string globalcsi. If either the target or replacement string contains spaces or special characters, surround the string with quotes. To replace all occurrences throughout the source member, add the keyword ALL to the end of the command. With the ALL keyword, changed lines are marked with ==CHG> in the line command area. Copyright IBM Corp., All rights reserved. Page 5 of 14

6 ISPF Editor Search Functions Limiting Range on FIND and CHANGE Commands To limit the range affected by either the FIND or CHANGE command, use labels at the end of the command to identify the beginning and the end of range. You must first assign the labels to the first line and last line of the range before using them in the FIND or CHANGE command. To assign a label to a line, position the cursor at the line, and type the label, preceded by a period (.). Include the period as part of the label in the FIND or CHANGE command. The following CHANGE command changes all occurrences of the string #tvol to TARGETVOL, within the lines labeled.topln and.botln: ===> CHANGE #tvol TARGETVOL ALL.TOPLN.BOTLN Copyright IBM Corp., All rights reserved. Page 6 of 14

7 ISPF Editor Search Functions Search Keywords FIRST and LAST To alter the direction of the search, add the keywords FIRST or LAST to the FIND or CHANGE command. The keyword FIRST means to start at the top of the source member or range and search forward. LAST indicates to start at the bottom and search backward. In this example we have found and replaced the last occurrence of the target string #tzone with the text string TARGETZONE. Since we did not use the keyword ALL in this command, the editor only changes the first occurrence of the target string it finds and does not change the string #tzone in any of the lines above it. Copyright IBM Corp., All rights reserved. Page 7 of 14

8 ISPF Editor Search Functions Additional FIND and CHANGE Command Keywords Additional keywords help you specify exactly the kind of match desired. If you add the keyword WORD to the FIND or CHANGE command, the target string must exist as a separate word, or it will not be changed. In this example, the ISPF editor found and changed the string AVE to AVENUE, but ignored the string AVE in the existing word AVENUE. If you add the keyword PREFIX, the target string must be at the start of a word, and if you use the keyword SUFFIX, the target string must exist at the end of a word. Copyright IBM Corp., All rights reserved. Page 8 of 14

9 ISPF Editor Search Functions Excluding Lines from the Search - Frame 1 To exclude lines from a search, use the EXCLUDE command before you issue the FIND or CHANGE command. For example, the command: ===> EXCLUDE FILE ALL excludes all lines within the source that contain the string FILE. The editor no longer displays the excluded lines, but replaces them by a single dashed line that indicates how many lines are not displayed. In the FIND or CHANGE command you can then instruct the editor to work with either excluded or the included lines. To search only the excluded lines, add X at the end of the command. To search only the included lines, add NX at the end of the command. Copyright IBM Corp., All rights reserved. Page 9 of 14

10 ISPF Editor Search Functions Excluding Lines from the Search - Frame 2 You may also exclude lines by using the exclude line command (X) in the line command area. There are three forms of this command: X Excludes this line Xn Excludes n lines starting with this line XX Excludes the block of lines beginning with the first XX command This example shows using X to exclude a single line and X2 to exclude two lines. Copyright IBM Corp., All rights reserved. Page 10 of 14

11 ISPF Editor Search Functions Excluding Lines from the Search - Frame 3 Use the XX form of the exclude line command to exclude a block of lines. For example, you might want to exclude program comments from the display, so you can edit only the code as shown here. Copyright IBM Corp., All rights reserved. Page 11 of 14

12 ISPF Editor Search Functions Redisplaying Excluded Lines - Frame 1 There are several ways to redisplay all or some of the excluded lines. To redisplay all the excluded lines, type RESET at the command prompt, as shown here. Copyright IBM Corp., All rights reserved. Page 12 of 14

13 ISPF Editor Search Functions Redisplaying Excluded Lines - Frame 2 You can also use the following line commands to redisplay specific lines of text: F (show the first line) L (show the last line) S (show lines) To redisplay the first line of excluded text, type F in the line command area next to where lines were excluded, as shown in this example. To redisplay multiple lines use the command form Fn. The S line command redisplays lines based on indentation level. If you type S9, the editor displays the nine lines with the left most indentation. This can be useful for lining up IF and ELSE clauses in large blocks of indented code. Copyright IBM Corp., All rights reserved. Page 13 of 14

14 ISPF Editor Search Functions Deleting or Retaining Excluded Lines You can use the DELETE primary command to delete either the excluded lines or the non-excluded lines from the member. To delete the lines that have been excluded from the display, type DELETE ALL followed by X on the command line, as shown in this example. To delete the lines that have not been excluded from the display (and thus retain only the excluded lines), type NX after the DELETE ALL primary command. Copyright IBM Corp., All rights reserved. Page 14 of 14

15 ISPF Editor Search Functions Shifting Indentation The editor also provides line level commands to shift or change the indentation of one or more lines. The left parenthesis symbol shifts lines left while the right parenthesis symbol shifts lines right. The format of these commands can be: ( shifts one line two spaces left (n shifts one line n spaces left (( marks the beginning and end of a block to shift two spaces left ((n marks the beginning of a block to shift n spaces left For example, a single ( shifts the line 2 positions to the left. To shift one line 8 spaces to the right, type )8 in the line command area. To mark a block of text to shift left 7 spaces, type ((7 at the first line of text and (( at the last line of text. Copyright IBM Corp., All rights reserved. Page 15 of 14

16 ISPF Editor Search Functions Summary In this module, ISPF Editor Search Functions, you have learned how to : Find specific text strings in a data set member Change specific text strings in a data set member Limit the range of the FIND and CHANGE commands Use other keywords with the FIND and CHANGE commands Exclude and redisplay lines of text in the source member Copyright IBM Corp., All rights reserved. Page 16 of 14