Specifying your tally register

The tally register is defined when you provide a literal value as an additional operand to the functions in Functions supporting a TALLY register. For functions that have a fixed number of operands, the literal operand is the next positional operand beyond the defined operands for the given function. For functions that have an indefinite number of operands, a null operand is required to delimit the function operands and to denote the next operand as a tally literal.

Example 1

IF FLD_CO(1,8,c,'a',,'Number of records with "a"') then
  chg_out('a','c',0,,,,'Number of strings changed from "a" to "c"')

produces this tally report:

TALLY summary report
---------------------------------------------------------
Number of records with "a"                     4
Number of strings changed from "a" to "c"     32

Note: FLD_CO can have an indefinite number of search literals. As a result, the tally register is specified by

,,'Number of
records with "a"

For CHG_OUT, no null positional delimiter is required and the TALLY literal must be the seventh operand.

Example 2

*FASTREXX
if fld_tm(1,'01'x) then do;
  OVLY_OUT('**',1,2,,, 'Count of first 2 chars set to "**"')
  return
end;

produces this tally report:

TALLY summary report
------------------------------------------------------
Count of first 2 chars set to "**"     4