EChange command syntax

Syntax

Use the ISPF command you have setup with the following syntax:

Read syntax diagramSkip visual syntax diagram
>>-EChange-string1--string2--+------------+--+------------+----->
                             '-col1--col2-'  | .-CHARs--. |   
                                             '-+--------+-'   
                                               +-PREfix-+     
                                               +-SUFfix-+     
                                               '-WORD---'     

>--FIRST(n)--MAXRECS(n)--MAXINREC(n)--+------------+--PARMLIB--->
                                      '---ddname---'            

>--/reference_member --RESULT--ASIS--SKIP--PROCLIB-------------><

string1, string2
string1 is your search string. string2 is your replace string.

The search strings supported are those supported by the FCH function. So you can specify the string value in the form: X'hhhh' or C'ccccc' or P'pppp' , and so on.

CHARS
Matches the search string anywhere in the data.
PREFIX
Matches the search string wherever it appears as a prefix in the data. To be a prefix, the matched text must be preceded by a non-alphanumeric character or be the start of a line or field, and must be followed by an alphanumeric character.
SUFFIX
Matches the search string wherever it appears as a suffix in the data. To be a suffix, the matched text must be preceded by an alphanumeric character, and must be followed by a non-alphanumeric character or be the end of a line or field.
WORD
Matches the search string wherever it appears as a word in the data. To be a word, the matched text must be preceded by a non-alphanumeric character or be the start of a line or field, and must be followed by a non-alphanumeric character or be the end of a line or field.
FIRST(n)
Specifies the maximum number of total changes that can be performed within a single data set or PDS member.
MAXRECS(n)
Specifies the maximum number of records that can be changed within a single data set or PDS member.
MAXINREC(n)
Specifies the maximum number of changes that can be made within a single record.
ddname
This refers to a ddname that has been allocated to your TSO/ISPF session. You can specify one or more ddnames.
For example, EC abc def SYSPROC SYSEXEC will search SYSPROC and SYSEXEC DDs for the string "abc" and replace it with the string "def".
PARMLIB
This will search and change in the current PARMLIB data sets.
/reference_member
This will search and change the data sets specified in:
reference_dataset_name(reference_member) for the specified string.
RESULT
Search and change will be restricted to the data sets and members or path names that matched the string on the previous search.
ASIS
If the input data set is ISPF packed, it will be unpacked before any processing.
SKIP
If the input data is ISPF packed, no processing will occur.
PROCLIB
Search and change in the current system proclib data sets.
Restriction: This parameter is for JES2 users only. z/OS 2.2 SDSF is required on z/OS® systems earlier than V2.2.
Note: Enclose your search string in quotation marks if your string value conflicts with a keyword value.