By default, three blanks appear between columns. You can change the space between columns with BETWEEN(n).

    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.

The fields of records that do not meet the specified criteria are not checked for invalid digits (PD and ZD) or excessive digits (CSF, FS, UFF, and SFF).

See ON(p,m,f) for further details.

   .-,------------------.   
   V                    |   
>>---+-+-mask-------+-+-+--------------------------------------><
     | '-E'pattern'-' |     
     +-L'string'------+     
     +-F'string'------+     
     +-T'string'------+     
     +-LZ-------------+     
     '-+-Ndd-+--------'     
       '-Udd-'              

specifies formatting items that indicate how the data for this field is to be formatted for printing. Formatting items can be specified in any order, but each item can only be specified once. Any formatting item can be specified for a numeric field, but only L'string' and T'string' can be specified for a character field.

The column width is dynamically adjusted to accommodate the maximum bytes to be inserted as a result of all formatting items specified.

mask

See the discussion of mask under ON(p,m,f,formatting) in DISPLAY operator.

E'pattern'

See the discussion of E'pattern' under ON(p,m,f,formatting) in DISPLAY operator.

L'string'

See the discussion of L'string' under ON(p,m,f,formatting) in DISPLAY operator.

F'string'

See the discussion of F'string' under ON(p,m,f,formatting) in DISPLAY operator.

T'string'

See the discussion of T'string' under ON(p,m,f,formatting) in DISPLAY operator.

LZ

See the discussion of LZ under ON(p,m,f,formatting) in DISPLAY operator.

Ndd or Udd

specifies the number of digits to be used for the numeric field. Ndd or Udd can be used to change the column width for numeric fields. dd specifies the number of digits and must be a two-digit number between 01 and 31.

The default number of digits (d) for a numeric field is the maximum number of digits for that field. For example, d is 5 for ON(1,5,ZD). If you know that your numeric field requires less than d digits, you can use a lower number of digits (dd) instead by specifying Udd, thus reducing the column width if it is determined by d. For example, ON(1,5,ZD,U03) reduces d from 5 to 3. If you want your numeric field to be displayed with more than d digits, you can use a higher number of digits (dd) instead by specifying Ndd or Udd, thus increasing the column width if it is determined by d. For example, ON(1,5,ZD,U10) increases d from 5 to 10.

Either Ndd or Udd can be used to set d greater than the maximum for a numeric field, but only Udd can be used to set d less than the maximum for a numeric field.

For Udd:

dd is used for d. For example:

• If ON(1,5,ZD) is specified, 5 digits (default for 5,ZD) are used.
• If ON(1,5,ZD,U10) is specified, 10 digits (from U10) are used.
• If ON(1,5,ZD,U03) is specified, 3 digits (from U03) are used.
• If ON(1,16,FS) is specified, 16 digits (default for 16,FS) are used.
• If ON(1,16,FS,U16) is specified, 16 digits (from U16) are used.
• If ON(1,16,FS,U15) is specified, 15 digits (from U15) are used.

If you use Udd and a numeric value overflows dd digits, ICETOOL terminates the operation. You can prevent the overflow by specifying an appropriately higher dd value for Udd. For example, if ON(1,12,ZD,U09) results in overflow, you can use ON(1,12,ZD,U10) instead.

If E'pattern' is specified, Udd is ignored, because the number of digits is determined from the pattern.

For Ndd:

If dd is greater than or equal to d, dd is used. If dd is less than d, d is used. For example:

• If ON(1,5,ZD) is specified, 5 digits (default for 5,ZD) are used.
• If ON(1,5,ZD,N10) is specified, 10 digits (from N10) are used.
• If ON(1,5,ZD,N03) is specified, 5 digits (from 5,ZD) are used.

If E'pattern' is specified, Ndd is ignored, because d is determined from the pattern.

See ON(p,m,f) for a discussion of p.

m specifies the length of the field in bytes. A field must not extend beyond position 32752 or beyond the end of a record. A field can be 1 to 2000 bytes.

See ON(VLEN) for further details.

   .-,------------------.   
   V                    |   
>>---+-+-mask-------+-+-+--------------------------------------><
     | '-E'pattern'-' |     
     +-L'string'------+     
     +-F'string'------+     
     +-T'string'------+     
     +-LZ-------------+     
     '-+-Ndd-+--------'     
       '-Udd-'              

specifies formatting items that indicate how the data for this field is to be formatted for printing. Formatting items can be specified in any order, but each item can only be specified once.

The column width is dynamically adjusted to accommodate the maximum bytes to be inserted as a result of all formatting items specified.

mask

See the discussion of mask under ON(p,m,f,formatting) in DISPLAY operator.

E'pattern'

See the discussion of E'pattern' under ON(p,m,f,formatting) in DISPLAY operator.

L'string'

See the discussion of L'string' under ON(p,m,f,formatting) in DISPLAY operator.

F'string'

See the discussion of F'string' under ON(p,m,f,formatting) in DISPLAY operator.

T'string'

See the discussion of T'string' under ON(p,m,f,formatting) in DISPLAY operator.

LZ

See the discussion of LZ under ON(p,m,f,formatting) in DISPLAY operator.

Ndd or Udd

See the discussion of Ndd or Udd under ON(p,m,f,formatting) in OCCUR operator.

See ON(VALCNT) for further details.

   .-,------------------.   
   V                    |   
>>---+-+-mask-------+-+-+--------------------------------------><
     | '-E'pattern'-' |     
     +-L'string'------+     
     +-F'string'------+     
     +-T'string'------+     
     +-LZ-------------+     
     '-+-Ndd-+--------'     
       '-Udd-'              

specifies formatting items that indicate how the value count is to be formatted for printing. Formatting items can be specified in any order, but each item can only be specified once.

The column width is dynamically adjusted to accommodate the maximum bytes to be inserted as a result of all formatting items specified.

mask

See the discussion of mask under ON(p,m,f,formatting) in DISPLAY operator.

E'pattern'

specifies an edit pattern to be applied to the value count. The pattern (1 to 24 characters) must be enclosed in single apostrophes. Each 9 in the pattern (up to 15) is replaced by a corresponding digit from the numeric value. Characters other than 9 in the pattern appear as specified. To include a single apostrophe (') in the pattern, specify two single apostrophes ('').

F'string' or a mask cannot be specified with E'pattern'.

When E'pattern' is specified for the value count:

• If the number of significant digits in a value count is less than the number of 9's in the pattern, 0's are filled in on the left. For example, 1234 is shown as 001234 with ON(VALCNT,E'999999').
• If the number of significant digits in a value count is greater than the number of 9's in the pattern, digits are truncated from the left. For example, 1234567 is shown as *4567* with ON(VALCNT,E'*9999*').

L'string'

See the discussion of L'string' under ON(p,m,f,formatting) in DISPLAY operator.

F'string'

See the discussion of F'string' under ON(p,m,f,formatting) in DISPLAY operator.

T'string'

See the discussion of T'string' under ON(p,m,f,formatting) in DISPLAY operator.

LZ

See the discussion of LZ under ON(p,m,f,formatting) in DISPLAY operator.

Ndd or Udd

Specifies the number of digits to be used for the value count when determining the column width. dd specifies the number of digits and must be a two-digit number between 01 and 15.

The default number of digits (d) for the value count is 15. If you know that your value counts require less than 15 digits, you can use a lower number of digits (dd) instead by specifying Ndd or Udd, thus reducing the column width if it is determined by d. For example, if ON(VALCNT,N06) or ON(VALCNT,U06) is specified, 6 digits (from N06 or U06) is used instead of 15 (default for value count).

If you use Ndd or Udd and a value count overflows the number of digits used, ICETOOL terminates the operation. You can prevent the overflow by specifying an appropriately higher dd value for Ndd or Udd. For example, if ON(VALCNT,N05) results in overflow, you can use ON(VALCNT,N06) instead.

If E'pattern' is specified, Ndd or Udd is ignored, because d is determined from the pattern.

For ON(VALCNT), PLUS is treated as BLANK.

ALLDUPS is equivalent to HIGHER(1).

NODUPS is equivalent to EQUAL(1) or LOWER(2).

x must be specified as n or +n where n can be 1 to 15 decimal digits.

y must be specified as n or +n where n can be 1 to 15 decimal digits.

v must be specified as n or +n where n can be 1 to 15 decimal digits.

UZERO overrides the default of treating -0 and +0 as signed zero values, that is, as different values. Without UZERO, -0 is treated as negative and +0 is treated as positive for ON processing.