MODIFY MATCH [ HP Transact Reference Manual ] MPE/iX 5.0 Documentation
HP Transact Reference Manual
MODIFY MATCH
Modifies the specified item in the match register.
Syntax
{MODIFY MATCH} item_name [new_value]
{MM }
Parameters
item_name The name of the data item in the match register to
modify.
new_value The value to be assigned to the specified item in the
match register. The new_value parameter can be enclosed
in quotes if embedded, preceding or trailing blanks are
desired. If you do not specify a new value for the
match register item, the current value is displayed.
Then, you can either enter the new value or press Return
to leave the match register item unchanged.
Discussion
This command allows you to selectively modify items in the match
register. If the item occurs more than once in the match register, you
are prompted for which occurrence to change. The new value is converted
to the data type of the item before it is placed in the match register.
If the value cannot fit into the storage length of the item an error
message is displayed. This truncation can cause erroneous results during
program execution, so before modifying an item, be aware of the storage
length of the item you are modifying. You cannot use this command to add
or delete items from the match register.
Example
The following example shows the modification of the match register. When
item2 is modified, TRANDEBUG prompts to determine which of the
occurrences of item2 should be modified.
TRANDEBUG> MODIFY MATCH item1 123
TRANDEBUG> DISPLAY MATCH
MATCH REGISTER:
ITEM1 EQ : 123
ITEM2 EQ : ABC OR
ITEM2 EQ : DEF
TRANDEBUG> MODIFY MATCH item2 XYZ
1. ITEM2 EQ : ABC
2. ITEM2 EQ : DEF
ENTER NUMBER OF ONE TO MODIFY: 1
TRANDEBUG> DISPLAY MATCH
MATCH REGISTER:
ITEM1 EQ : 123
ITEM2 EQ : XYZ OR
ITEM2 EQ : DEF
MPE/iX 5.0 Documentation