# 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"