SWAPBAR

Read syntax diagramSkip visual syntax diagram
>>-SWAPBAR-----------------------------------------------------><

The list of logical sessions 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 session 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 session. The entry for the active logical session 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 session 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 session can be changed by positioning the cursor on an entry and pressing Enter. This logical session then becomes the active logical session. 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 session 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.

You are able to customize the SWAPBAR settings. You can:

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