Events Logic 

Actions and Parameters

 

The logic settings for event handling consist of two fields: an action and the parameters for that action. When an action is defined for an event type, NOMADS will execute it automatically each time the associated event occurs. If a null value is used for library name, NOMADS assumes the current library.

Note:
The Library name may be a specific or generic reference. See Cascading Language Suffixes.

 

Action

Description/Parameters

Perform or Call

Event logic is often contained in a separate program. To run program code, select a Perform or Call action, specify a program name and label entry point.

Format: "[program;]label ".

For a Perform, variables are shared, so no arguments are required. For a Call, you may pass a comma-separated list of up to 20 optional parameters.

Format: "[program;]label ",[ arg1$,arg2$,...arg20$]

If a Default Program has been specified, then the program name may be omitted from Perform or Call logic. See Default Program.

End

Terminates panel object.

End All Active Wdws

Closes all windows, including the main window and all attached concurrent windows.

Execute

Any sequence of valid PxPlus commands separated by semi-colons can be added directly to the control definition if the Execute action is selected to process the logic. Program code that is included on the panel cannot be performed or called, but commands may include a PERFORM or CALL directive.

Format: "command1[;command2;command3 ...]"

Help

Many controls include a Help option for event logic. For example, you may specify a Help reference to be activated On Exit in the Panel Header to launch a help file when the panel is closed or On Change when a button is pressed.

Format: "helpfile;reference"

Ignore

No logic is performed. (Default)

Jumpto

Jumpto is the equivalent of a PxPlus PERFORM directive. You can launch another panel and specify a different library; however, in the Jumpto action, all variables are passed to the new panel and its associated program(s), so no argument list is needed.

Format: panel","[library]"

Link

This is essentially a CALL to the NOMADS program *winproc.

For example, select Link on an On Exit event to launch a different panel that may reside in the same or a different library. You may pass up to 20 variables to the new panel by specifying the variable name(s) as parameters.

Format: "panel","[library]"[,arg1$,arg2$,...arg20$]

Merge-Jumpto

When a panel is launched via Link or Jumpto, the parent window is disabled. Use Merge-Jumpto to launch Concurrent Panels.

Format: "panel","[library]"

Non-NOMADS

In the Post Display logic event for a panel, you may select Non-NOMADS to run an existing application that was not developed in NOMADS. At run time, NOMADS draws a window and RUNs your specified program within it.

Examples

 

Perform

";init"

 

Call

"c:\mypath\prog_01;validate_custID",cust_ID$,cust_name$

 

Execute

user-name$=arg_1$;MSGBOX "UserID is "+user_name$

 

Non-NOMADS

"c:\mypath\prog_101;init"

 

Help

"C:\MY_PATH\MY.HLP;162"

 

Link

"my_panel","",Cust_ID$,cust_name$

 

Jumpto

"my_panel","my_library.en"