SAS 9.1.3 Integration Technologies » Administrator's Guide (LDAP Version)


Setting up an IOM Bridge Server and Spawner
Quick Start: Simple Server and Spawner
Summary of Setup Steps
Spawner Overview
Spawner Requirements
Metadata Overview
Creating the Metadata for an IOM Bridge Server
Using the IT Administrator Wizard
Using IT Administrator
SAS Login Object
Server Object
Spawner Object
Using a Configuration File
Configuring a UUID Generator
Configuring and Starting the Object Spawner on z/OS
Invoking (Starting) the Spawner
On Windows
On UNIX
On Alpha/VMS
Spawner Invocation Options
Administering the Server and Spawner:
Using Telnet
Using the IT Configuration Application
Spawner Error Messages
Metadata Examples
Minimal Configuration
Server and Spawner
Using Logical Names
UUID Generator
Message Queue Polling
Reference Materials
Attributes for Logical Names
Attributes for Logins
Attributes for Servers
Object Server Parameters
Server Startup Command
Attributes for Spawners
Initializing UNIX Environment Variables for Workspace Servers
IOM Bridge Servers

Metadata Overview (IOM Bridge)

The metadata that supports Integration Technologies consists of objects, each defined by a collection of attributes that define the object. If you require metadata, the metadata for an IOM Bridge server configuration must include the following classes of objects:

  • sasServer object. A sasServer object contains startup and connection information for a particular instance of a SAS object server. For each instance of an object server, the following information is defined in the metadata:

    • Server name
    • Machine name
    • Connection information, including service or port
    • Other information including logical names, encryption information, commands, and pooling information, as required.

    For detailed information about the attributes included in the metadata for a server, see the sasServer Attributes List.

  • sasSpawner object. A sasSpawner object contains configuration information for a particular instance of a SAS spawner. The spawner is a program that must run on a server machine when an IOM bridge server configuration is used. The spawner listens for and authenticates incoming client requests and launches server instances as needed. For each spawner instance, the following information is defined in the metadata:

    • Spawner name
    • Machine name
    • Other information, including logical names and encryption information, as required

    For detailed information about the attributes included in the metadata for a spawner, see the sasSpawner Attributes List.

The following classes of objects are optional:

  • The sasLogin object is a convenient tool to provide credentials. A SAS login may need to be available in order to start a SAS session on a server or to connect to a client. For each sasLogin instance, the following information is defined in the metadata:

    • Login name
    • Person references for authorized users or groups of users
    • The SAS login and password needed to access the SAS object server
    • Domain name
    • Logical name

    For detailed information about the attributes included in the metadata for a SAS login, see the sasLogin Attributes List.

  • The sasLogicalNameInfo object is created automatically if you use IT Administrator to assign a logical name to a spawner or server. Logical names are used to create resource groupings. For more information, refer to Assigning Logical Names and sasLogicalNameInfo Attributes List.

The following example configuration files demonstrate the basic metadata needed to create a working IOM Bridge server configuration: