!!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.
Note: 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
----
![Notes|Edit:Internal.P2K_PU.ACCUMULATORS]
[{InsertPage page='Internal.P2K_PU.ACCUMULATORS' default='Click to create a new notes page'}]