Previous Topic: Locate DataNext Topic: Remove Parameters


Locate and Change Data

Change/Rchange

Finds and changes data in a test stream. These commands can be typed in all three formats. The values specified in the Scan and Replace parameters apply to the screen in Field format. Similarly, if these commands are typed in Field or Hex format, the value specified in the Screen ID parameter applies to the screen in Display format.

The Change command searches for each occurrence of the specified value and replaces it. The Rchange command repeats the previous Change command for the next occurrence. Use the Rchange command to locate and change additional occurrences of the value without respecifying it.

You can also specify the Rfind command after the Change command to repeat the search without replacing the value.

You can optionally specify the range of records which CA Verify for VTAM should search.

If CA Verify for VTAM finds the value, it replaces it with the new value and displays the changed record; otherwise, it redisplays the current record along with a message.

If you expand a field, the location of subsequent 3270 fields will not be changed. Avoid destructive field overlap.

When you type the Change command, CA Verify for VTAM inserts the Change parameters on the menu as illustrated next.

CCC.ORDERAPP.001 -------- EDIT: FIELD FORMAT ------------------------12:43:41 ENTER COMMAND ===> E4 ROW COLUMN VALUE ===> ===> SCREEN ID ===> ===> ===> SCAN ===> REPLACE ===> START WITH RECORD NUMBER ===> 000009 STOP AFTER RECORD NUMBER ===> 000009 RH: 039040 RECORD NUMBER: 9 TYPE: OUTPUT APPL: A04IC9NA DATA LENGTH: 266 OPERATION: ERASE/WRITE DATE: 11/03/1998 SCREEN SIZE: 24 BY 80 RESPONSE: 00:00:00.596 TIME: 11:53:58.406 TERMINAL: A55TG001 WCC: C2: NL/EM/CR PRINT CNTL, KEYBOARD RESTORE ORDER ROW COL ATTR LENGTH ----+----|----+----|----+----|----+----|----+--- SBA 7 16 00000 IC 00000 FLD 1 1 PSH 00004 DATE SF PS 00008 11/03/98 FLD 1 29 PSH 00023 CAROL'S COOKIES COMPANY FLD 1 63 PSH 00007 RELEASE SF PSM 00003 6.2 FLD 2 1 PSH 00004 TIME SF PS 00008 11:53:58 FLD 2 36 PSH 00009 MAIN MENU

The Change command has five parameters: Screen ID, Scan, Replace, Start With Record Number, and Stop After Record Number. The Scan and Replace parameters must be specified; other parameters are optional.

Screen ID

If specified, CA Verify for VTAM checks the screen as it appears in Display format before processing the Scan and Replace parameters. The Row and Column sub-parameters must be specified. The change will apply only to screens which contain the Screen ID value specified in the row and column.

Usually this parameter is specified with a record range (see the Start With Record Number and Stop After Record Number parameters next).

When processing the Screen ID parameter, CA Verify for VTAM treats an attribute or null on the screen as a blank.

Scan

The value specified for this parameter applies to the screen in Field format. You can scan only for data because attributes and nulls will not be changed. (Use Hex format to change attributes and orders.)

The Row and Column sub-parameters are optional. Specify a row without a column to limit the search to a single row; specify a column without a row to limit the search to a single column. Omit both row and column to search the entire screen.

To change orders, the AID, WCC, or cursor position, specify the Change or Rchange command in Hex format, omitting the Scan parameter row and column. Be careful when using these commands in Hex format to avoid changing orders unintentionally.

Replace

Specify the value to replace the Scan value. The number of characters may be the same, greater than, or less than the number of characters in the Scan value. Data in the field following the Scan value will be shifted left or right if the Replace value is shorter or longer than the Scan value.

Start with Record Number

Specify either or both of these parameters to expand the

Stop after Record Number

Is the current record. Use these parameters to make global changes.

See the earlier discussion of the Find/Rfind commands for an explanation of how to specify the value and when to specify Screen ID and Scan.