Actions

Restriction: This topic applies only when the AppMaster Builder AddPack has been installed, and applies only to Windows platforms.

You can customize your actions by providing your own code to execute at an event, or you can choose from one of several reserved actions provided by AppMaster Builder.

Predefined Actions

Online Express provides predefined actions you can customize to execute specific code or a reserved action. You specify what code is executed by providing each with an argument. The available actions are:

Call
Calls a subroutine or, for a CICS application, performs a CICS LINK. Provide a program name as its argument.
Global Code
Executes code that is available for any program of an application. It can consist of any procedural source code and paragraphs that the code performs. Entering code into a Global Code action automatically makes it available to other program within the application.
Local Code
Executes code that you write specifically for the current program. It can consist of any procedural source code, paragraphs that the code performs, and Data Division source code for the code.
User Rule
Executes the logic in a user rule. Provide the name of a user rule as its argument.
Perform
Executes a PERFORM statement. Provide a paragraph name as its argument.
Reserved
Executes one of several reserved actions you can specify as its argument. See the section Reserved Actions below.
XCTL
Transfers execution to another program and terminates the current program. Provide a program name for its argument.
MSG-SW
IMS only. Schedules a new program; optionally you can pass a character screen record or other data record to the program. Provide a transaction ID, program name, or data name for its argument.
SEND
Transmits an input/output screen. Provide a screen name with its appropriate arguments as its argument.
Alias

Reserved Actions

Online Express provides predefined action logic that you can assign to your program. These actions include database read and write actions, and teleprocessing actions. You simply select the ones that you need; Online Express generates default processing logic. For many of these, you supply an argument that enables you to customize the

The Reserved action enables you to specify one of several reserved actions that execute predefined logic. The reserved actions are:

Add
Stores records in your database.
Clear
Moves low-values to all entry fields and clears all controls. There is one exception: for non-CICS applications, Clear moves spaces or low-values, depending on which option you select on the Express Generation Options window - either Clear Screen with Spaces or Clear Screen with Low Values.
Delete
Erases records in your database.
Next
Retrieves the next sequential record and displays its data; not applicable to SQL.
Query
Obtains one or more records and displays them on the screen.
Refresh
Re-reads the database when the end user executes any database write function on one or more repeated record block rows, and re-displays the record block to reflect the database updates.
Term
Terminates the program.
Update
Modifies records in your database.
Forward
Pages forward through a repeated record block in a character application.
Backward
Pages backward through a repeated record block in a character screen.

All of these actions can be specified in Online Express as an argument for the Reserved database action.