ACTION
In a summary subpanel, defines a list of navigation and action options from which a user can select. You can define up to 16 actions for a selectable field for a subpanel. A popup panel with a list of all possible options is dynamically defined. A default action can be defined. These options are displayed in a popup when a user enters a slash ("/") on the selectable row associated with the actions.
ACTION=columnname(action_character,"action_text_description",destination_panelid
[,DEFAULT][,CONFIRM][,REALTIME])
[,DEFAULT][,CONFIRM][,REALTIME])
where:
- columnname
- The name of the column with which the action is associated.
- action_character
- The character associated with the action.
- action_text_description
- A description of the action to be taken, enclosed in single or double quotation marks.
- destination_panelid
- The panel ID of the workspace to which users are taken. Specify NULLDEST for no navigation.
- DEFAULT
- Defines the action as the implicit navigation behavior. If only one action is specified, it is taken as the default. If multiple actions are defined for a subpanel, one must be defined as the default.
- CONFIRM
- Invokes a confirmation popup panel (KOBCONFM) before proceeding to the specified panel ID.
- REALTIME
- Renders the destination workspace in realtime mode, even if the user is in history mode when selecting this action.
- ENTER
- ENTER can be used instead of an action character. Using ENTER changes the behavior of a popup panel so that the Enter key can implement navigation instead of data collection and redisplay. The destination panel ID can be any workspace or popup panel or the special keyword END. END indicates navigate backwards (save and PF3). If a REXX EXEC sets the ZDESTID in an ONACTION stanza, the ENTER key options are ignored, and the popup panel is redisplayed with any updates that the REXX EXEC may have made.
Example 1
This example illustrates an action selection menu:ACTION=HUBNAME(?,"Help Assistance",KOCHELP1,DEFAULT) ACTION=HUBNAME(S,"Select a hub",KOBPANE1) ACTION=HUBNAME(K,"Kill a hub",KOBPANE2,CONFIRM)
Example 2
These examples illustrates the use of the ENTER and END keywords:ACTION=(ENTER,,MYNEXTWS)or
ACTION=(ENTER,,END)These two examples are mutually exclusive.