Using the Search and Revise Commands


The SEARCH/REVISE and RSEARCH/RREVISE commands provide the ability to find and change character strings contained in a DELTA List.

The power and convenience of these commands becomes apparent in the various techniques that you can use to specify or limit a particular search or revision of the DELTA List field values.

The following types of qualification can be used when performing a search:

  • search direction
  • search context
  • type
  • field
  • value or mask
  • value range

To perform a search, type SEARCH or S on the Command line of the DELTA IMS - Edit DELTA List panel and press Enter. To perform a combined search/revise operation, type REVISE or REV on the Command line and press Enter.

In either case, the DELTA IMS - Edit Search/Revise panel is displayed as shown in the following panel.

Edit Search/ Revise Panel

 SR                     DELTA IMS - Edit Search
 Command ===> ________________________________________________ Scroll ===> PAGE

 Verify the parameters.  Then press Enter to start a search.

   Search direction . . 1    1. Next  2. Previous  3. First   4. Last  5. All
   Search context . . . 1    1. Any   2. Prefix    3. Suffix  4. Word

 Select one or more from each column.       Type a Search argument.
   Element type     Field   More:   +
 / * ALL *        / *ALL*                     Search value or mask
 _ DATABASE       _ DATABASE                    Find . . . 'FIND ME'_____
 _ APPLCTN        _ RENAME
 _ TRANSACT       _ RESIDENT
 _ TERMINAL       _ ACCESS
 _ LTERM          _ AUTO                      Search value range
 _ RELOAD         _ APPLCTN                     From . . . ______________
 _ EXECUTE        _ RENAME                      To . . . . ______________
 _ APPC           _ RESIDENT
 _ RTCODE         _ PGMTYPE                 Leave 'Find' blank if range is used.
 _ COMMENT        _ SCHDTYP
                  _ FPATH
                  _ DOPT

 

The following fields are available on this panel:

Search Direction

You can control the starting point, direction, and extent of the search. You can start or resume the search from the current cursor position and proceed either from top to bottom or from bottom to top. You can also start from the first element or last, and you can start from the top and search for all occurrences until the last match is found.

Select one of the following values to establish the search direction:

  • 1. Next – Start or resume a search from the current cursor position and proceed from top to bottom until the next match is found.
  • 2. Previous – Start or resume a search from the current cursor position and proceed from bottom to top until the previous match is found.
  • 3. First – Start a search from the first element and proceed from top to bottom until the first match is found.
  • 4. Last – Start a search from the last element and proceed from bottom to top until the last match is found.
  • 5. All – Start from the top and find all occurrences of the desired data.

Search Context

You can control the conditions for a successful match of the desired string based on whether the matched data begins and/or ends with a nonalphanumeric character (special characters such as plus signs, dashes, parentheses, apostrophes, or blanks). You can find a match regardless of context or a match where the desired string is prefix, suffix, or a separate word.

Select one of the following values to establish the search context:

  • 1. Any – Find a match in any string regardless of context (such as the DO in DO-IT-YOURSELF, DON’T, ADOPT, and BULLDOZER).
  • 2. Prefix – Find a match where the desired string is the prefix of a word (such as the DO in DON’T and DOWNLOAD but not in ADO, ADOPT, or BULLDOZER).
  • 3. Suffix – Find a match where the desired string is the suffix of a word (such as the IT in EXHIBIT and RABBIT but not in IT’S, DITCH, or HOSPITAL).
  • 4. Word – Find a match where the desired string is a separate word (such as the AS in AS or COME-AS-YOU-ARE but not in ASSUME, CASUAL, or HASN’T).

Type

You can select one or more types of DELTA List elements so that a search is limited to the specified types of elements. For example, if you specify that the search include only DATABASE, APPLCTN, and TRANSACT type elements, then matching data in a COMMENT or LTERM element is not found in the search.

To search all DELTA List element types, select *ALL*. To search for specific element types, select the individual element name(s).

Field

You can select one or more individual fields of a DELTA List element so that a search is limited to the specified fields of an element.

To search all element fields, select *ALL*. To search specific element fields, select the individual element name.

You can also select any valid combination of Element type and Field by typing / next to the appropriate type and field names.

The standard TSO/ISPF scrolling keys and a LOCATE command are supported. You can use all normal TSO/ISPF forms of scrolling, such as PAGE, DATA, and CSR to reposition the fields list to the desired field name. You can also use a LOCATE command followed by the name of the desired field to position to a specific field name. For field names that occur in multiple element types, you can type two operands with the LOCATE command: the element name followed by the field name.

Value or Mask

When typing the desired string, you can enter a normal character string or a masking character string so that you can search for a particular type of value without regard for the specific characters. To enter a masking string, specify any desired specific characters mixed with asterisks (*) in each position (even trailing positions) where you do not care about the specific value. When typed at the beginning or end of a masking character string, wildcard characters can represent more than one character. For example, a masking string *DO* would match ADO, ADOPT, -DO-, (DON’T), +ADO, and ADO-; but not DO or DON’T.

You can type a search value or mask or a search value range pair, with the low value first and the high value second. Type either the search value/mask or the search range pair. If you provide both, the value range is ignored.

Value Range

When typing the desired string, you can provide a value range pair. Typically, this pair is used to search for ranges of numeric data values such as the priority values, limit counts, and so forth, found in a TRANSACT element. Since a value range attempts to interpret each DELTA List field as a unit data item, the search context criteria are automatically set to Wordwhen a value range is specified.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*