PERFORM specifies the Process Module (PM) trigger to be executed when the user has pressed one of the keys defined in @CANCEL_CODE or @END_CODE.
The @FILL_ACTION system field is used to communicate between the PM trigger and the form operation. When the specified PM trigger is executed, @FILL_ACTION contains the form's termination status. The termination status can be one of the following values:
"OK" indicates the form operation is normally terminated (during the form operation, the key specified in the @END_CODE system field is entered).
- "CANCEL" indicates the form operation is aborted (during the form operation, the key specified in the @CANCEL_CODE system field is entered).
During the execution of the trigger, the value can be changed in @FILL_ACTION. If @FILL_ACTION is not changed, the FILL statement is terminated after the execution of the trigger. To restart the form operation requires that one of the following values to be assigned to @FILL_ACTION:
"INVALID" resumes the form operation; everything on the form remains the same as before. The cursor is pointed to the first modifiable data field.
"RESTART" restarts the form operation for more data entry. The data entry areas associated with the form are cleared.
If the form is operated at the command level, this statement is ignored. This statement is also ignored in a PM if the specified trigger does not exist.
/[PERFORM final_trigger_name]
|
final_trigger_name |
specifies the name of a trigger in the PM. |
/PERFORM SUMMARY
This statement specifies that the PM trigger SUMMARY should be executed when the form is completed. The trigger must be the name of a ROUTINE or TRIGGER in the PROCESS SECTION of a PM.