ADDPOP—start pop-up window mode

The ADDPOP service notifies the dialog manager that all subsequent panel displays are to appear in a pop-up window. No visible results appear on the screen until you issue a DISPLAY, TBDISPL, or SELECT PANEL call.

All subsequent panel displays will be in the pop-up window created with the ADDPOP call, until a REMPOP or another ADDPOP is called. Another ADDPOP call creates a separate pop-up window.

Each pop-up window created as a result of a successful ADDPOP service call can also have a window title. The title is embedded in the top of the window frame border and can be only one line length. If the title is longer than the window frame, the dialog manager truncates it. To define the window title, set system variable ZWINTTL to the desired window title text.

Command invocation format


>>-ISPEXEC--ADDPOP--+--------------------+--+----------+-------->
                    '-POPLOC(field-name)-'  '-ROW(row)-'   

>--+----------------+------------------------------------------><
   '-COLUMN(column)-'

Call invocation format


>>-CALL--ISPEXEC--(buf-len,--buffer);--------------------------><


>>-CALL--ISPLINK--('ADDPOPbb'--,-+-field-name-+--,-+-row-+------>
                                 '-'b'--------'    '-'b'-'   

>--,-+-column-+-);---------------------------------------------><
     '-'b'----'

Parameters

The field-name, row, and column parameters are optional.

Note: When running in GUI mode, the field-name, row, and column parameters are ignored.

If you omit the field-name parameter when using the ADDPOP service, the Dialog Manager offset positions the pop-up window so that the title of the underlying panel is visible, and horizontally four character spaces to the right of the underlying panel.

If the pop-up window will not fit relative to the ADDPOP positioning parameters, the Dialog Manager overrides these parameters and adjusts the window so that it fits on the screen.

field-name: Specifies that the dialog manager is to position the pop-up window relative to the specified field in the currently displayed panel. If omitted, the pop-up window is offset positioned relative to the active window.
row: Specifies that the dialog manager is to adjust the field-specific location row or offset location row by the specified amount. This amount can be either positive or negative. The default value is 0.
column: Specifies that the dialog manager is to adjust the field-specific location column or offset location column by the specified amount. This amount can be positive or negative. The default value is 0.
buf-len: Specifies a fullword fixed binary integer containing the length of buffer.
buffer: Specifies a buffer containing the name of the service and its parameters in the same form as they would appear in an ISPEXEC call for a command procedure.

Return codes

These return codes are possible:

0: Normal completion.
12: An ADDPOP service call was issued before a panel was displayed or another ADDPOP service call was issued before a panel was displayed for the previous ADDPOP call.
20: Severe error.

Example

This EXEC called from the ISPF Primary Option panel:

/*  REXX  */
ADDRESS  ISPEXEC
"ADDPOP"
"DISPLAY PANEL(PANELA)"
"ADDPOP POPLOC(FIELD2)"
ZWINTTL = "POPUP WINDOW TITLE"
"DISPLAY PANEL(PANELB)"
"ADDPOP COLUMN(5) ROW(3)"
ZWINTTL = ""
"DISPLAY PANEL(PANELC)"
EXIT

results in this panel:

Figure 1. Multiple Pop-up Windows