WSDISCON—disconnect from a workstation

The WSDISCON service enables you to disconnect from the workstation without having to terminate your ISPF session.

You can issue the WSDISCON service from a program, CLIST, or REXX exec to disconnect from the workstation.

Command invocation format


>>-ISPEXEC--WSDISCON-------------------------------------------><


>>-CALL--ISPLINK--('WSDISCON');--------------------------------><


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

buf-len: This specifies a fullword fixed binary integer containing the length of "buffer".
buffer: This specifies a buffer containing the name of the service.

These return codes are possible:

0: Normal completion. User is disconnected from workstation.
8: User is trying to disconnect from workstation, but there is no current connection.
10: User is trying to disconnect from GUI mode, but is connected with GUISCRD or GUISCRW values that are different than the host emulator session. User is not disconnected.
12: User is trying to disconnect from a GUI display when running BATCH GUI mode. User is not disconnected.
14: User is trying to disconnect from workstation while running the Workstation Tool Integration Configuration Program. User is not disconnected.

If the CODEPAGE and CHARSET parameters were specified on the WSCON service, the Initiate Workstation Connection panel, or the ISPSTART GUI statement when a connection was made to the workstation, their values might no longer be the host code page and character set in 3270 mode following a WSDISCON service invocation. The values returned from the terminal query are restored as the active code page and character set. If your terminal or emulator does not support code pages, the CODEPAGE and CHARSET parameter values originally specified on your ISPSTART statement are used. If these parameters were not specified on ISPSTART, English is the default.
If you are running with TSO line mode support while displaying ISPF in GUI mode, the ISPF/TSO window continues to display TSO line mode after the WSDISCON service is issued. The ISPF/TSO window is not removed until your ISPF session is terminated.

When disconnecting from GUI mode, the name of any group boxes defined on the panel that WSDISCON was issued from will display on the screen in 3270 mode. After the user presses the Enter key, causing the panel to reprocess, then these group box names disappear and any panel text under the names reappears.
If the user is in GUI mode and in split screen mode when the WSDISCON service is invoked, he is disconnected from the workstation, and the screen from which the WSDISCON service was invoked is displayed in the full 3270 emulator session without a split line. The setting of the user's "Always show split line" parameter has no effect on this. The other ISPF sessions are hidden and available for display after the SWAP command is entered. Additional split requests cause the split line to redisplay, provided that the "Always show split line" setting is selected.
If pop-up windows are displayed in GUI mode when the WSDISCON service is invoked, the pop-up windows are suspended on the 3270 session. The panels are displayed as full-screen panels. If new addpops are then invoked, the new panels display as pop-ups.
The user cannot issue WSDISCON when running in Batch GUI mode.