@VALUES-Generate Verification Values

Field Definition Record › @VALUES-Generate Verification Values

@VALUES-Generate Verification Values

The @VALUES macro is used in an RSB module to generate field verification values that the VRTN1 routines 3 or 4 use to validate fields of the structured infostorage record.

The syntax for the @VALUES macro is:

@VALUES label,operands,TYPE=type,LENGTH=len

label

Specify this label in the VPRM1 operand of any @CFDE that uses VRTN1 routine 3 or 4 to validate against these values.

operands

Specifies the valid values. For VRTN1 routine 3 that checks for a value in a list, TYPE can be BINARY, CHAR, or PACKED. You can specify a single value or a list of values. You can mask characters using the standard CA ACF2 for z/VM masking characters, asterisk and dash. Here are some examples:

PRIME    @VALUES 1,2,3,5,7,11,TYPE=BINARY,LENGTH=4
COLORS   @VALUES RED,GREEN,BLUE,YELLOW,TYPE=CHAR,LENGTH=6
PROGRAMS @VALUES IFD*****,INA‑,IQADVM,TYPE=CHAR,LENGTH=8
EVEN     @VALUES 0,2,4,6,8,TYPE=PACKED,LENGTH=4

For VRTN1 routine 4 that checks for inclusion in a range, TYPE can be BINARY, PACKED, or TIMEBIN. You must specify one or more pairs of values, representing the low and high ends of the ranges, enclosed in parenthesis. If the TYPE is TIMEBIN, values are specified as hh:mm, where hh represents hours, in 24‑hour format, and mm represents minutes. Here are some examples:

HALFWORD @VALUES (0,32767),TYPE=BINARY,LENGTH=4
NOLUNCH  @VALUES (08:00,12:00),(13:00,17:00),TYPE=TIMEBIN,LENGTH=4

TYPE=type

Specifies the type of verification values to generate:

BINARY

Four‑byte binary

CHAR

Character, length determined by the LENGTH operand.

PACKED

Four‑byte packed decimal.

TIMEBIN

Four‑byte binary time, represented internally in units of 0.01 seconds past midnight.

LENGTH=len

Indicates the length of character values to generate. If the values given as operands are shorter than this, they are padded on the right with blanks. LENGTH is ignored for types other than CHAR.