17.5 UNDO Functionality

For Allocations that insert or update data in the Management Ledger and Ledger Stat tables, an UNDO operation reverses the effect of that rule run. For allocations that update data in instrument or transaction tables, and UNDO operation updates the column targeted by that allocation run with a value of zero.

The reason UNDOING a rule effectively removes completed allocation data from your environment, your management may wish to restrict your access to UNDO functionality. For details on restricting action to UNDO functionality, see Application Preferences. The UNDO icon is enabled whenever you select one or more rows from the summary table. Upon requesting an UNDO operation, a pop-up dialog appears offering the following UNDO options:

• Selected Allocations: If you choose Selected Allocations, each row that you have selected from the summary table will be UNDONE. This functionality works only if the Enable Undo for Selected Allocations option in the Application Preferences is set to Yes.
• Selected Batches: If you choose Selected Batches, all rule executions that belong to any of the batches you have selected will be UNDONE. This functionality works only if the Enable Undo for Selected Batches option in the Application Preferences is set to Yes.
• Selected Allocation Models: If you choose Selected Allocation Models, all rule executions that belong to any of the Allocation Models that you have selected will be UNDONE. This functionality works only if the Enable Undo for Selected Allocation Models option in the Application Preferences is set to Yes.

  The Allocation Model is supported using the Batch Execution screen.

  For creating the Batch for UNDO of Allocation Models, follow these steps:

  • In the Batch Maintenance screen, create a Batch and a corresponding Task with the component as "RUN EXECUTABLE", and provide the following as the "Executable" property value.

    PFTUNDO.sh,<INFODOM>_<BATCH_RUN_ID> 
    ParameterID=<ALLOCATION_MODEL_SYS_ID>-<ALLOCATION_MODEL_SEQ_NUM> A

    where:

    • INFODOM: Information Domain name
    • BATCH_RUN_ID: Any unique identifier to identify the batch execution
    • ALLOCATION_MODEL_SYS_ID: Sys ID number of the allocation model to be undone
    • ALLOCATION_MODEL_SEQ_NUM: Sequence number to specify which execution of the allocation model is to be undone. This can be obtained from the Allocation History screen.
• Mass UNDO: If you choose “Mass UNDO”, every rule execution whose "Completion Date”, (a time-stamp value) is chronologically later than the earliest row that you have selected from the summary table will be UNDONE. This functionality works only if the Enable Mass Undo option in the Application Preferences is set to Yes.

Figure 17-2 Allocation Execution History - Undo Options