Read syntax diagramSkip visual syntax diagram

                      '-operator-'  | .-,-----. |  '-VER-'      
                                    | V       | |               

Can be used in FASTREXX condition expressions.

This is a 1-256 name that matches either a tally literal or a numeric variable. Variable name matching is not case sensitive. If the name is not found, a numeric variable is created with value of 0.
The default is EQ or =. This function supports all the operators described for dynamic template and criteria edit. For details about the operators supported and their description, see:
The value or values entered must be valid in the context of the operator and the field which is being referenced. For example, only certain operators like CO (contains) allow multiple values. Numeric values should be entered when testing numeric fields, and so on.
  • Specifying hexadecimal strings. A hexadecimal string must be in the form 'hhhhhh'x. The value enclosed in quotation marks must be an even number of characters and contain valid hexadecimal characters (0–9, A–F).
  • Specifying binary strings. A binary string must be in the form 'nnnnnn'b. The value enclosed in quotation marks must be a combination of "0"s and "1"s.
  • Specifying character strings. For non-numeric types, the value should be enclosed in quotation marks.
  • Specify a variable by specifying &variable_name. A variable is substituted for the value if a matching character, numeric, or tally variable can be located. If a matching variable cannot be found, the string is treated as a literal value. If a numeric comparison is being performed, a character variable is converted to a number - if the conversion fails, the function returns a false result. If a numeric or tally variable is referenced in a character comparison, then the value is the number converted to its display form with leading zeros removed.
Verify the field is composed only of characters specified in the value column.

Example 1

Count the number of records with A in the first byte and stop processing after 20.

IF FLD(1,1) = 'A' then

if TESTN(COUNTA,'>',20) then
     return "STOP IMMEDIATE"

Example 2

When the total of packed decimal field start at column 28 is greater than 100, stop processing

Note: In this case, allow Z Data Tools to calculate the packed-decimal field length.
TALLY(28,P,'Total Sales')
  if TESTN('Total Sales',,'>',100) then
     return "STOP IMMEDIATE"