Process Macros › COMPARE Macro

COMPARE Macro

The COMPARE macro compares two values. You can:

• Compare the value in a variable with the value in another variable
• Compare the value in a variable with a fixed value
• Select a subset of the value to be compared

Parameters: COMPARE Macro

Variable Name 1

Is a mandatory field that is used to specify the variable that contains the value you want to compare. You can use the Start of Compare and the Length fields to compare a substring of the value.

Operator

Is a mandatory field that specifies the relational operator to use for the comparison. The value must be one of the following:

• CT (contains)
• EQ (is equal to)
• NE (is not equal to)
• GT (is greater than)
• GE (is greater than or equal to)
• LT (is less than)
• LE (is less than or equal to)

Variable Name 2

Is used to specify a variable that contains the value you want to use as the basis of the comparison.

Constant Value

Is used when you want to specify a fixed text string as the basis of the comparison.

Note: To use a null value for comparison, leave both the Variable Name 2 field and the Constant Value field blank.

Start of Compare

Indicates the start position of the string in variable 1 from which the comparison takes place. The value of this field must be a number from 1 through 255.

Length

Indicates how much of the string in variable 1 is to be compared. The value, if specified, must be a number from 1 through 255. If a value is not specified, the full string or substring, starting from the specified start position, is compared.

Return Codes: COMPARE Macro

0

Comparison criteria satisfied

4

Comparison criteria not satisfied

Example: COMPARE Macro

In the following example, the COMPARE macro checks whether the value of the &A3 variable is greater than the value of the &A2 variable.

 PROD----- Automation Services : COMPARE MACRO Parameter Definition ------------
 Command ===>                                                    Function=BROWSE

 .- COMPARE Parameters --------------------------------------------------------.
 |                                                                             |
 |  Syntax .......... (Variable 1) OPERATOR (Variable 2)> or (Constant)        |
 |                                                                             |
 |                                                                             |
 |  Variable Name 1 ....... A3            (Enter a valid variable name)        |
 |                                                                             |
 |  Operator .............. GT            (EQ,NE,GT,GE,LT,LE,CT)               |
 |                                                                             |
 |  Variable Name 2 ....... A2            (Enter a valid variable name)        |
 |                                                                             |
 |    or Constant Value ...                                                    |
 |                                                                             |
 |  Start of Compare ...... 1             (Start position within variable 1)   |
 |                                                                             |
 |  Length ................               (Enter length of comparison)         |
 |                                                                             |
 ’-----------------------------------------------------------------------------’

  F1=Help      F2=Split     F3=Exit
                            F9=Swap