SAS 9.1.3 Integration Technologies » Server Administrator's Guide


Setting up a Server and Spawner
Best Practices
Quick Start: Standard Workspace Server and Spawner
Quick Start: Load-Balancing Stored Process Server and Spawner
Summary of Setup Steps
Spawner Overview
Spawner Requirements
Planning the Configuration Metadata
Security
Standard Workspace or Stored Process Server
Standard OLAP Server
Creating the Metadata Using SAS Management Console
Defining Servers
Modifying Servers
Workspace or Stored Process Server
OLAP Server
Configuring a UUID Generator
Configuring and Starting the Object Spawner on z/OS
Administering the Server and Spawner
Creating a Metadata Configuration File in SAS
Using ITConfig
Testing Server Connections
Using Telnet
Spawner Error Messages
Reference Materials
Fields for the Server Definition
Object Server Parameters
Fields for the Spawner Definition
IOM Bridge

Using Telnet to Administer the Spawner

The spawner can be controlled and monitored using a telnet client connected to the operator port or service.

Connecting to a Spawner

To connect to an executing spawner, telnet to the operator interface port or service that is specified in the spawner definition.

The following example, run on UNIX, assumes 6337 was specified as the port for the operator:

   myHost> telnet serverhost 6337
   Trying...
   Connected to serverhost.
   Escape character is '^]'. 

After the telnet conversation is active, enter the operator password that is specified. If the operator password was not specified, use sasobjspawn as the password.

Note: You will not be prompted for the password. For example: 

   sasobjspawn
   Operator conversation established

You can now interact with the executing spawner by issuing any of the Available Commands.

Available Commands

The following is a list of commands that are available via the spawner's operator interface:

Command Description
btrace filename Begin trace. filename is a fully qualified path to the file in which to log spawner activity.
bye Terminate the spawner execution.

Note: You cannot shut down an object spawner while there are current or pending load-balancing tasks.
cluster reset all

or

cluster reset <name or ID of load-balancing logical server (cluster)>
  • If all is specified, shuts down all multi-user servers associated with load-balancing logical servers (clusters) defined on the local machine.

    Note: This command only affects SAS Stored Process Servers that were launched from object spawner that you are currently administering.

    For example, to shutdown all servers in a cluster:

    cluster reset all
  • If a load-balancing logical server (cluster) name or ID is specified, shuts down all multi-user servers on the local machine that are part of the named load-balancing logical server (cluster).

    Note: If you use a character encoding other than Latin-1, you must specify the cluster using the object ID (for example, A5JJTGEQ.AX00005L).

    For example:
    • To shut down a cluster by specifying the name of a load-balancing logical server:
      cluster reset "SASMain - Logical Stored Process Server"

      To determine the name of the load-balancing logical server, in SAS Management Console, select the load-balancing logical server definition, and then select File arrow Properties from the menu bar. Use the value in the Name field.

    • To shut down a cluster by specifying the object ID of a load-balancing logical server:
      cluster reset A5JJTGEQ.AX00005L
      To determine the object ID of the load-balancing logical server definition, in SAS Management Console, select the load-balancing logical server definition, and then select File arrow Properties from the menu bar. Use the value in the ID field.

To understand how to locate the logical server definition, see Planning for Metadata Definitions or the Server Manager online Help.

etrace End trace.
help List available operator commands.
list List all known servers that are supported by this spawner.
quit Exit operator conversation.