This is version 1 2 3 4 . It is not the current version, and thus it cannot be edited.

Back to current versionRestore this version

Handle Accumulators#

Functionality:#

These three functions manipulate internal numeric accumulators for controlling totalling and counting within the UPPHF and UEEF when something beyond that which is possible with these two programs is needed. There are 20 numeric accumulators provided for in this package.

• P2K_PU.ACCUM_INIT will initialize the values of the accumulators to the number provided, or zero if not specified
• P2K_PU.ACCUM_ADD will change the values of the accumulators by the number provided, or increment by 1 if not specified
• P2K_PU.ACCUM_VALUE will retrieve the current value of the accumulator indicated

P2K_PU.ACCUM_INIT#

Parameters
Return	This is just a pass through value. Whatever is specified here will be returned back. This functionality allows for the initialization of accumulators in a field that is a constant value, with that value being passed back.
Accumulators	Optional. A number from 1 to 20 which indicates which accumulator you wish to set to a specified value. If not provided, all accumulators (1 through 20) will be set to the number provided.
Value	Optional. A number which represents the initialized value. If not provided, the accumulator(s) identified will be set to zero.

If you use any of the following functions without initializing the accumulators, you will always get NULL back.

P2K_PU.ACCUM_ADD#

Parameters
Return	This is just a pass through value. Whatever is specified here will be returned back. This functionality allows for the increment of accumulators without changing the interface value.
Accumulators	A number from 1 to 20 which indicates which accumulator you wish to change to a specified value.
Value	Optional. A number which represents the incremental value. If not provided, the accumulator identified will be incremented by one.

P2K_PU.ACCUM_ADD#

Parameters
Accumulators	A number from 1 to 20 which indicates which accumulator whose value you returned

Example: #

P2K_PU.ACCUM_INIT('HHS521')

will set accumulators 1 through 20 to a zero value, and will return back the constant HHS521.

P2K_PU.ACCUM_INIT('HHS521',3,2)

will set only accumulator 3 to a value of 2, returning the constant value.

P2K_PU.ACCUM_ADD('543123',3)

will increase the value of accumulator 3 by one (default) and return the constant value 543123.

P2K_PU.ACCUM_ADD('543123',3,-27)

will reduce the value of accumulator 3 by 27 (subtract) and return the constant value.

P2K_PU.ACCUM_VALUE(3)

will return the current value of accumulator 3