Usage Note 45627: Improved functionality to detect and stop orphaned SAS® Workspace Server processes
 |  |  |  |  |
A hot fix has been developed to enable the SAS Workspace Server to detect when a client machine unexpectedly closes its connection.
Click the Hot Fix tab in this note to access this hot fix.
As a result of the new functionality, the SAS Workspace Server stops running automatically. For example, this behavior can occur when you use the Microsoft Windows Task Manager to kill a client such as SAS® Enterprise Guide®.
The SAS Workspace Server uses IOM.CurrentClients (an existing counter that has been updated) and IOM.ReconnectEnabled (a new information variable) to determine when a client unexpectedly closes its connection. The SAS Workspace Server only stops when it encounters the following parameters:
Note: in releases earlier than SAS® 9.4, the IOM.ReconnectEnabled information variable is visible only when it is set to True. Starting in SAS 9.4, variable is visible whether it is set to True or False.
This functionality only applies to single-user standard SAS Workspace Servers. It does not apply to multiple-user servers such as pooled workspace servers or to the SAS® Stored Process Server.
If you do not want the SAS Workspace Server to stop automatically in the situation described previously, you should set the environment variable WKSP_KILL_OFF. With the environment variable set, you can check the updated IOM.CurrentClients counter using SAS® Management Console to determine whether orphan processes exist and dealt with at the discretion of the administrator.
- Case 0: IOM.CurrentClients=1 indicates that SAS Workspace Server has a client. YOu probably do not want to kill it.
- Case 1: IOM.CurrentClients=0 indicates that SAS Workspace Server has lost the client, so the process can be killed.
- Case 2: IOM.CurrentClients=0 IOM.ReconnectEnabled=False indicates that SAS Workspace Server has lost the client, so the process can be killed.
- Case 3: IOM.CurrentClients=0 IOM.ReconnectEnabled=True indicates that SAS Workspace Server has lost the client, but that client might be reconnected. So you might not want to kill this one yet.
Operating System and Release Information
| Product Family | Product | System | SAS Release | |
| Reported | Fixed* | |||
| SAS System | SAS Integration Technologies | z/OS | 9.2 TS2M3 | 9.3 TS1M2 |
| Microsoft® Windows® for 64-Bit Itanium-based Systems | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Microsoft Windows Server 2003 Datacenter 64-bit Edition | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Microsoft Windows Server 2003 Enterprise 64-bit Edition | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Microsoft Windows XP 64-bit Edition | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Microsoft® Windows® for x64 | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Microsoft Windows Server 2003 Datacenter Edition | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Microsoft Windows Server 2003 Enterprise Edition | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Microsoft Windows Server 2003 Standard Edition | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Microsoft Windows Server 2003 for x64 | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Microsoft Windows Server 2008 | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Microsoft Windows Server 2008 for x64 | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Microsoft Windows XP Professional | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Windows 7 Enterprise 32 bit | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Windows 7 Enterprise x64 | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Windows 7 Home Premium 32 bit | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Windows 7 Home Premium x64 | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Windows 7 Professional 32 bit | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Windows 7 Professional x64 | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Windows 7 Ultimate 32 bit | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Windows 7 Ultimate x64 | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Windows Vista | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Windows Vista for x64 | 9.2 TS2M3 | 9.3 TS1M2 | ||
| 64-bit Enabled AIX | 9.2 TS2M3 | 9.3 TS1M2 | ||
| 64-bit Enabled HP-UX | 9.2 TS2M3 | 9.3 TS1M2 | ||
| 64-bit Enabled Solaris | 9.2 TS2M3 | 9.3 TS1M2 | ||
| HP-UX IPF | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Linux | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Linux for x64 | 9.2 TS2M3 | 9.3 TS1M2 | ||
| OpenVMS on HP Integrity | 9.2 TS2M3 | 9.3 TS1M2 | ||
| Solaris for x64 | 9.2 TS2M3 | 9.3 TS1M2 | ||
A fix for this issue for Base SAS 9.21_M3 is available at:
http://ftp.sas.com/techsup/download/hotfix/HF2/B25.html#45627A fix for this issue for Threaded Kernel IOM 9.3 is available at:
https://tshf.sas.com/techsup/download/hotfix/HF2/F99.html#45627| Type: | Usage Note |
| Priority: | medium |
| Date Modified: | 2012-03-29 14:05:16 |
| Date Created: | 2012-02-10 09:43:11 |