Previous Topic Next topic Print topic


Control Points

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

AMB control points enable you to write and execute custom processing logic to supplement or override the default logic that Online Express generates. Execute this logic at any of the AMB-provided locations in your program, known as program control points.

The following table shows you the name of each control point and where you can find it in a program:

Control Point Location in Program

After-Receive-Para

After entering a program, regardless of invocation mode.

Post-Screen-Read

After a screen-invoked program receives its screen.

Transid-Invoked-Para

After a transid-invoked program is invoked.

Program-Invoked-Para

When AMB displays the screen of a program invoked by the XCTL or MSG-SW function.

Pre-Term

Before AMB terminates the program.

After-Enter-Check

After the end user presses the processing key (the Enter key is the default), and before the PRE-FUNCTION-TEST paragraph executes.

Pre-Function-Test

Before AMB evaluates all functions except the Terminate, or Exit, function.

Pre-Branch

Before each MSG-SW, XCTL, or Call function executes.

Ed-Error-Pre-Send

Before AMB send a screen whose field edits have failed.

General-Pre-Send

After AMB checks all functions, and before the TP-SEND call executes, when invocation mode is screen-invoked.

Before-Send-Para

Before AMB sends the screen, regardless of invocation mode.

Pre-Screen-To-Rec

Before AMB performs the MOVE-SCREEN-TO-REC paragraph.

Post-Screen-To-Rec

After AMB performs the MOVE-SCREEN-TO-REC paragraph, and the Update or Add function executes.

Pre-Rec-To-Screen

Before AMB performs the MOVE-REC-TO-SCREEN paragraph.

Post-Rec-To-Screen

After AMB performs the MOVE-REC-TO-SCREEN paragraph, and after the Query function executes.

Pre-RB1-Row-To-Rec

Before the Add or Update function executes for a repeated record block row, and before screen fields move to database fields. AMB uses the subscript CTR to reference repeated block rows.

Post-RB1-Row-To-Rec

Before the Add or Update function executes for a repeated record block row, and after screen fields move to database fields. AMB uses the subscript CTR to reference repeated block rows.

Pre-Rec-To-RB1-Row

After the Query or Forward function executes for a repeated record block row, and before database fields move to screen fields. AMB uses the subscript CTR to reference repeated block rows.

Post-Rec-To-RB1-Row

After the Query or Forward function executes for a repeated record block row, and after database fields move to screen fields. AMB uses the subscipt CTR to reference repeated block rows.

Error-Send-And-Quit

When a program terminates abnormally, such as when a database call fails when the Database Call Tailoring screen's Abort On Error parameter is set to Y.

Misc-User-Paragraphs

A location where you can write and store any number of paragraphs to perform at any control point in the program. Code all your paragraphs in one file in this location.

Before DB Access

Before a non-loop database call executes

Before Loop

Before a loop database call executes

Normal Status (Before Record is Processed)

Before Online Express maps looped records to the screen

Normal Status

After Online Express maps any records to the screen

Exception Status

After the database call returns a status flag with the Exception status code

Error Status

After the database call returns a status flag with the Error status code

After DB Access

After a non-loop database call executes

After Loop

After a loop database call executes

The following flowcharts illustrate the locations of all control points in AMB-generated programs.


Standard Control Points


Function Code and PF Key Processing


Function Code and PF Key Processing (continued)


Evaluate Row Actions

The flowchart below illustrates the location of the database call control points in generated programs.


Non-Loop Call and Loop Call

You can set AppMaster Builder to automatically generate comments in your programs that indicate the location of control points in the code.

Previous Topic Next topic Print topic