Read syntax diagramSkip visual syntax diagramSWAPBAR

The list of logical screens can be activated by entering the SWAPBAR or SWAPBAR ON command on the command line. The list is displayed on the last line of the physical screen.

The entry for each logical screen is the screen name if assigned or, if a screen name is not available, it is the panel name of the current panel displayed for the logical screen. The entry for the active logical screen has an asterisk (*) in the first character position and, if the name is 8 bytes long, the last character is not displayed. Also, the alternate logical screen has a "-" in the first position and the 8th character is not displayed.

The list remains active until you enter the SWAPBAR or SWAPBAR OFF command. The setting for the SWAPBAR is maintained in the system profile member and applies across logons.

If the list is longer than the width of the screen, a ">" appears at the right of the list to indicate there are more entries and you can scroll right by either positioning the cursor on the ">" and pressing Enter, or by positioning the cursor on an entry and pressing PF11 which scrolls to the entry indicated. When the start of the list is not displayed, a "<" is displayed at the left of the visible part of the list to indicate that you can scroll left on the list by positioning the cursor on the "<" and Pressing Enter or by positioning the cursor on an entry and pressing PF10.

The active logical screen can be changed by positioning the cursor on an entry and pressing Enter. This logical screen then becomes the active logical screen. The SWAPBAR entries use the same physical attribute as the action bar choices and, if in the options settings Tab to action bar choices is selected, then tabbing to swapbar entries also occurs.

If the cursor is positioned on the swapbar entry for the currently active session and Enter is pressed, this is treated the same as Enter being pressed within the active logical screen panel. When the SWAPBAR is activated, the Always show split line option is deactivated and you are not able to reactivate it until the SWAPBAR is deactivated.

If SWAPBAR is activated on a screen which is split and the lower panel of the split screen does not contain enough rows to allow the SWAPBAR to be displayed, the necessary rows to allow the SWAPBAR to be displayed will be removed from the upper panel display and added to the lower panel display.

You are able to customize the SWAPBAR settings. You can:
  • Choose to have a separator line between the logical screen and the SWAPBAR.
  • Set the colour of the SWAPBAR.
  • Set the highlighting of all the fields within the SWAPBAR (for example, reverse video, underscore or blinking attribute).
  • Set the colour and highlighting attributes of an individual entry (a logical screen) with the SWAPBAR.
  • Save the settings that apply to the SWAPBAR as a whole in your system profile, so that these settings apply to future ISPF sessions (until you modify them).

To set the SWAPBAR customization settings, entering the command SWAPBAR / on the command line. The panel ISPTLCPN is displayed. You can now set the customization attributes. The changes take effect once you exit the panel. The setting for a separator line and the colour and highlighting settings for the SWAPBAR as a whole are saved in your system profile and apply to future ISPF sessions. Any changes to individual entries in the SWAPBAR only apply to the current ISPF session (that is, the session where the SWAPBAR / command was entered), and are also lost if the logical screen should terminate and recover.

To clear the settings for a logical screen swap to that screen, enter the SWAPBAR / command and enter D in the option field to clear the current session.