Popup panel definitions

Edit online

Popup panels overlie a portion of a workspace panel. Popup panels are typically used to display navigation or action options, to supply information for a particular field, or to provide additional information about actions. Popup panels are also used to confirm actions. Popup panels are linked to a subpanel through an ACTION setting in a subpanel definition.

Popup panel definitions begin with <POPUP> and end with <POPUPEND>. Popup panels may contain a header, free-form text, and a subpanel.

Popup panels suspend Auto update in the parent workspace: until the popup panel is dismissed, the Auto update field in the workspace displays SUS instead of Off or Interval.)

Popup panels can contain variables. The variables must be set in the parent workspace or in a previously accessed workspace.

As in workspace definitions, stanzas that define subpanels are introduced by a <SUBPANEL> statement. A corresponding <SUBPANELEND> statement is not required. Unlike workspace panels, which may contain up to 15 subpanels, popup panels can contain only one subpanel. Moreover, subpanels in popup panels cannot contain the QUERY keyword or PROLOG and EPILOG stanzas. Subpanels may contain ONACTION and ISPF stanzas. As in subpanels, ONACTION stanzas may contain SET commands and REXX exec calls. See Supported ISPF statements for more information allowable ISPF statements.

Example 1

The following example shows the use of a subpanel with actions defined, an ISPF )LIST statement with the POPUPACTIONS argument, with the width of the popup panel specified. The POPUPACTIONS argument displays the actions defined in the popup panel in a numbered list, in a popup panel with a width of 50 characters.

Figure 1. Example of a popup panel definition

/********************************************************************/
/*                                                                  */
/*        OMEGAMON BASE EXIT CONFIRMATION                           */
/*                                                                  */
/********************************************************************/
<POPUP>                                                               
<SUBPANEL>
ACTION=(X,"Exit and terminate the session (X)",=LOGOFF)
ACTION=(R,"Resume (R)",=END)
<ISPFPANEL>
)LIST POPUPACTIONS
)BODY WIDTH(50)
                 Exit Menu

Type a selection number, enter X to exit,
enter R to resume, or press PF3 to return.

)INIT
)PROC
)END
<ISPFPANELEND>
<POPUPEND>

Example 2

This is a sample popup panel action , which takes the actions defined in the subpanel from which the popup panel is invoked and inserts them after the text in the )BODY statement. A color variable is used to apply color to text .:

Figure 2. Example of action popup that inserts actions from the subpanel definition

/********************************************************************/  
/*                                                                  */  
/*        OMEGAMON ACTION CHARACTER LIST                            */  
/*                                                                  */  
/********************************************************************/  
<POPUP>                                                                 
<SUBPANEL>                                                              
<ISPFPANEL>
)ATTR                                          
@ TYPE(TEXT)  SKIP(ON) COLOR(&ZCLRTEXT))
)LIST PANELACTIONS
)BODY WIDTH(50)                                                         
          Action Command Menu 
Select an action and then press Enter.

)INIT
)PROC
)END                                                                    
<ISPFPANELEND>
<POPUPEND> 
******************************** Bottom of Data ************************