Control Commands › EXECUTE NEXT FUNCTION

EXECUTE NEXT FUNCTION

Purpose

Passes control in a dialog that is associated with an application function.

Syntax

►►──── EXECute next function ─── . ───────────────────────────────────────────►◄

Usage

EXECUTE NEXT FUNCTION is appropriate for use in applications defined by using the CA ADS application compiler (ADSA).

When the user selects a response that is valid for a dialog function at runtime, the function associated with the response is established as the next function to be executed. The EXECUTE NEXT FUNCTION command initiates execution of that function. Control is passed to the function by means of the control command associated with the application response during application compilation.

Considerations

• An EXECUTE NEXT FUNCTION command in a dialog that is not associated with an application function is processed by the CA ADS runtime system as a DISPLAY command. The runtime system displays the following message in the map's message field:

  DC177018 PLEASE SELECT NEXT FUNCTION
  

• The EXECUTE NEXT FUNCTION command executes the function that is invoked by the application response specified in the AGR-CURRENT-RESPONSE field of the ADSO-APPLICATION- GLOBAL-RECORD. Note that the response is moved into AGR-CURRENT-RESPONSE when the user selects an application response.
• Premap and response process commands can modify the value of AGR-CURRENT-RESPONSE, thereby modifying the function executed by the EXECUTE NEXT FUNCTION command.
• The premap process of a mapless dialog must move a valid application response to AGR-CURRENT-RESPONSE before issuing an EXECUTE NEXT FUNCTION command.
• If AGR-CURRENT-RESPONSE is modified by a process command, the runtime system does not perform security checking.

Example

In this example, control passes to the next function in the CA ADS application after the end-of-set condition is reached:

WHILE NOT DB-END-OF-SET
   REPEAT.
      OBTAIN NEXT ORDOR WITHIN CUST-ORDOR.
      .
      .
      .
   END.
EXECUTE NEXT FUNCTION.

Because EXECUTE NEXT FUNCTION is used to pass control in this example, the CA ADS runtime system determines which function to execute next.

More information:

Runtime Flow Of Control

ADSO-APPLICATION-GLOBAL-RECORD