Pop-up windows

Pop-up windows display information that extends the user's interaction with the underlying panel. When a pop-up is displayed, the user must finish interacting with that pop-up window before continuing with the dialog in the underlying panel.

The ADDPOP service allows your application to use pop-up windows. After you issue the ADDPOP service, subsequent DISPLAY, TBDISPL, or SELECT service calls display panels in that pop-up window until your application issues a corresponding REMPOP service or issues another ADDPOP service.

You specify the location of the pop-up window using the ADDPOP service call.

Note: When you are running in GUI mode, this pop-up window location specification is ignored. Default positioning is used.

You can specify the size of the window (width and depth) on the panel definition BODY statement or use the WIDTH and DEPTH attributes on the DTL PANEL tag. If you do not specify the size, the Dialog Manager displays the pop-up window in a 76 X 22 window with a border.

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 in 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.

Note: If you are running in GUI mode, the value in ZWINTTL has a maximum length of 255 characters and will be truncated without notice to the user at display time if it does not fit on the panel.

This example will display three pop-up windows, as shown in Figure 1. The window that panel B is displayed within will have the title POPUP WINDOW TITLE.

PROC 0
ISPEXEC ADDPOP
ISPEXEC DISPLAY PANEL(A)
ISPEXEC ADDPOP POPLOC(F1)
SET ZWINTTL = POPUP WINDOW TITLE
ISPEXEC DISPLAY PANEL(B)
SET ZWINTTL =
ISPEXEC ADDPOP
ISPEXEC DISPLAY PANEL(C)

Figure 1. Example panel displaying three pop-up windows

   Menu  Utilities  Compilers  Options  Status  Help
 - ┌───────────────────────────────────┐  -------------------------------------
   │ -------- Panel A ------------     │  ption Menu
   │                                   │
 0 │   Field 1  . . . . ___________    │  ters            User ID . : USERID
 1 │   Field 2  . . . . ___________    │  istings         Time. . . : 14:27
 2 │   Field 3  . . .  ┌───────── POPUP WINDOW TITLE ──────────┐  . : 3278
 3 │   Field 4  . . .  │ --------- Panel B ------------        │  . : 1
 4 │                   │                                       │  . : ENGLISH
 5 │                   │   This is Panel B                     │  . : ISR
 6 │                   │       ┌────────────────────────────────────────┐  OC
 7 │ COMMAND ===> ___  │  Fiel │ --------- Panel C ------------         │  D
 8 │  F1=HELP    F2=S  │  Fiel │                                        │
 9 │  F4=RETURN  F5=R  │  Fiel │    This is Panel C                     │  6,B
 1 ⋘────────────────── │  Fiel │                                        │  4.1
                       │       │   Field E  . . . . ___________         │
 Enter X to Terminate  │COMMAN │   Field F  . . . . ___________         │
                       │ F1=HE │   Field G  . . . . ___________         │
                       │ F4=RE │   Field H  . . . . ___________         │
                       ⋘────── │                                        │
                               │ COMMAND ===> _________________         │
 Option ===> TSO ADDP          │  F1=HELP      F2=SPLIT     F3=END      │
  F1=Help      F2=Split     F3 │  F4=RETURN    F5=RFIND     F6=RCHANGE  │
 F10=Actions  F12=Cancel       ⋘────────────────────────────────────────┘

The REMPOP service removes the current pop-up window. After you call the REMPOP service, a subsequent DISPLAY service will either display a panel in the full panel area of the screen or in a lower-level pop-up window, if it is active.

See z/OS V2R2 ISPF Services Guide for a complete description of the ADDPOP and REMPOP services.