Operand descriptions
The operands described in this section can
be specified in any order.
- FROM(indd)
- See the discussion of this operand on the DISPLAY statement in DISPLAY operator.
- ON(p,m,f)
- Specifies the position, length, and format of the numeric field
to be used for this operation. p specifies the first byte of the field relative to the beginning of the input record. p is 1 for the first data byte of a fixed-length record and 5 for the first data byte of a variable-length record as illustrated in the following (RRRR represents the 4-byte record descriptor word):
Fixed-length record | Variable-length record | D | A | T | A | ... | | R | R | R | R | D | A | T | A | ... p= 1 2 3 4 | p= 1 2 3 4 5 6 7 8
m specifies the length of the field in bytes. A field must not extend beyond position 32752 or beyond the end of a record. The maximum length for a field depends on its format.
f specifies the format of the field as follows:Field formats of the ICETOOL RANGE operatorFormat CodeLength Description BI 1 to 8 bytes Unsigned binary FI 1 to 8 bytes Signed fixed-point PD 1 to 16 bytes Signed packed decimal ZD 1 to 31 bytes Signed zoned decimal CSF or FS 1 to 32 bytes (31 digit limit) Signed numeric with optional leading floating sign UFF 1 to 44 bytes (31 digit limit) Unsigned free form numeric SFF 1 to 44 bytes (31 digit limit) Signed free form numeric Note: See Data format descriptions for detailed format descriptions.For a CSF, FS, UFF, or SFF format field:- A maximum of 31 digits is allowed. If a value with more than 31 digits is found, ICETOOL issues an error message and terminates the operation.
For a ZD or PD format field:- If a decimal value contains an invalid digit (A-F), ICETOOL identifies the bad value in a message and terminates the operation.
- A value is treated as positive if its sign is F, E, C, A, 8, 6, 4, 2, or 0.
- A value is treated as negative if its sign is D, B, 9, 7, 5, 3, or 1.
For a ZD, PD, CSF, FS, or SFF format field, a negative zero value is treated as a positive zero value.
- ON(VLEN)
- See the discussion of this operand on the DISPLAY statement in DISPLAY operator.
- HIGHER(x)
- Values higher than x are counted as contained in the range.
If only HIGHER(x) is specified, the range count is incremented when
x < value. If LOWER(y) is also specified, the range count is
incremented when x < value < y.
x must be specified as n, +n, or -n where n can be 1 to 31 decimal digits.
- LOWER(y)
- Values lower than y are counted as contained in the range.
If only LOWER(y) is specified, the range count is incremented when
value < y. If HIGHER(x) is also specified, the range count is
incremented when x < value < y.
y must be specified as n, +n, or -n where n can be 1 to 31 decimal digits.
- EQUAL(v)
- Values equal to v are counted as contained in the range. The
range count is incremented when v = value.
v must be specified as n, +n, or -n where n can be 1 to 31 decimal digits.
- NOTEQUAL(w)
- Values not equal to w are counted as contained in the range.
The range count is incremented when w ¬= value.
w must be specified as n, +n, or -n where n can be 1 to 31 decimal digits.
- VSAMTYPE(x)
- See the discussion of this operand on the COPY statement in COPY operator.