HP 3000 Manuals

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