SUPPORT / SAMPLES & SAS NOTES
 

Support

Usage Note 45627: Improved functionality to detect and stop orphaned SAS® Workspace Server processes

DetailsHotfixAboutRate It

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:

IOM.CurrentClients=0 IOM.ReconnectEnabled=False

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.

image label



Operating System and Release Information

Product FamilyProductSystemSAS Release
ReportedFixed*
SAS SystemSAS Integration Technologiesz/OS9.2 TS2M39.3 TS1M2
Microsoft® Windows® for 64-Bit Itanium-based Systems9.2 TS2M39.3 TS1M2
Microsoft Windows Server 2003 Datacenter 64-bit Edition9.2 TS2M39.3 TS1M2
Microsoft Windows Server 2003 Enterprise 64-bit Edition9.2 TS2M39.3 TS1M2
Microsoft Windows XP 64-bit Edition9.2 TS2M39.3 TS1M2
Microsoft® Windows® for x649.2 TS2M39.3 TS1M2
Microsoft Windows Server 2003 Datacenter Edition9.2 TS2M39.3 TS1M2
Microsoft Windows Server 2003 Enterprise Edition9.2 TS2M39.3 TS1M2
Microsoft Windows Server 2003 Standard Edition9.2 TS2M39.3 TS1M2
Microsoft Windows Server 2003 for x649.2 TS2M39.3 TS1M2
Microsoft Windows Server 20089.2 TS2M39.3 TS1M2
Microsoft Windows Server 2008 for x649.2 TS2M39.3 TS1M2
Microsoft Windows XP Professional9.2 TS2M39.3 TS1M2
Windows 7 Enterprise 32 bit9.2 TS2M39.3 TS1M2
Windows 7 Enterprise x649.2 TS2M39.3 TS1M2
Windows 7 Home Premium 32 bit9.2 TS2M39.3 TS1M2
Windows 7 Home Premium x649.2 TS2M39.3 TS1M2
Windows 7 Professional 32 bit9.2 TS2M39.3 TS1M2
Windows 7 Professional x649.2 TS2M39.3 TS1M2
Windows 7 Ultimate 32 bit9.2 TS2M39.3 TS1M2
Windows 7 Ultimate x649.2 TS2M39.3 TS1M2
Windows Vista9.2 TS2M39.3 TS1M2
Windows Vista for x649.2 TS2M39.3 TS1M2
64-bit Enabled AIX9.2 TS2M39.3 TS1M2
64-bit Enabled HP-UX9.2 TS2M39.3 TS1M2
64-bit Enabled Solaris9.2 TS2M39.3 TS1M2
HP-UX IPF9.2 TS2M39.3 TS1M2
Linux9.2 TS2M39.3 TS1M2
Linux for x649.2 TS2M39.3 TS1M2
OpenVMS on HP Integrity9.2 TS2M39.3 TS1M2
Solaris for x649.2 TS2M39.3 TS1M2
* For software releases that are not yet generally available, the Fixed Release is the software release in which the problem is planned to be fixed.