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

Using IT Administrator to Define a Spawner (IOM Bridge)

The SAS Integration Technologies Administrator provides a graphical user interface that allows you to create or modify a definition for a spawner to run on an IOM Bridge server. (Alternatively, you can use the IT Administrator wizard to perform the initial creation of a server and spawner. For details, see Using the IT Administrator Wizard to Define an IOM Bridge Server.)

Note: The following attributes which appear in the IT Administrator interface are not used in Version 9 of SAS Integration Technologies

  • Encryption Modules Path
  • Logical Unit Name
  • Master tab
If you are using Version 9, do not use these attributes for your configuration.

To define an IOM Bridge spawner object using IT Administrator:

  1. Open IT Administrator.

  2. In the manager bar, select SAS Configuration.

  3. In the tree view, select the Spawners folder (found under the SAS Servers folder); then select the New button (Delete) on the toolbar. Alternatively, you can select File right arrow New right arrow Spawner from the menu bar. The following window appears:

  4. Enter the necessary attributes. The attribute fields that are marked with an asterisk (*) are required. The OK button will remain greyed out until you have entered all of the required fields. Select the Help button on any tab to display entry instructions. Brief entry instructions are provided below. For detailed information about a field, click on the corresponding attribute name, which is shown in parentheses. The appropriate definition on the sasSpawner Attributes List will be displayed. You can then use your browser's Back button to return to this page.

    1. Enter a unique name (sasSpawnercn) for the spawner. Optionally, enter a description (description).

    2. On the Connections tab:

      1. Enter a Domain (sasDomainName). The spawner must use the same domain as the server with which it connects.

      2. On the Operator subtab, enter the service (sasOperatorService) or port (sasOperatorPort) and the password (sasOperatorPassword) that operators will use to connect to the spawner in order to perform administration tasks (such as checking status).

      3. On the UUID subtab, enter the service (sasUUIDService) or port (sasUUIDPort) and the password (sasUUIDNode) with which to connect to request UUID generation. See the section titled Request a Universally Unique Identifier (UUIDGEND) for more information regarding UUID generation by the spawner.

    3. On the Logical Names tab, select one more logical names (sasLogicalName) that this spawner is to be associated with. If you want to create a new logical name, select the Add button to create a new sasLogicalNameInfo object. For more information about logical names, refer to Assigning Logical Names.

    4. On the Machines tab, select the Add button, and then enter the fully qualified host name (sasMachineDNSName) for the machine on which the spawner is to run. Repeat for each additional host machine. To change an entry, highlight the machine name and select Edit. To remove an entry, highlight the machine name and select Remove.

    5. On the Encryption tab, select the key length (sasNetEncrKey).

    6. On the Logging tab, specify the log file name and path (sasLogFile), and select the checkbox to indicate whether you want to use verbose logging (sasVerbose).

  5. When you are finished entering information in the fields, select OK. The new spawner object appears in the tree view.

To modify a spawner definition using IT Administrator:

  1. Open IT Administrator.

  2. In the manager bar, select SAS Configuration.

  3. In the tree view, find the Spawners folder (found under the SAS Servers folder) and click the plus sign to open it.

  4. Select the spawner object that you wish to modify. The spawner's current attributes will be displayed in the property view in the right portion of the window.

  5. Select the appropriate tabs, and enter the necessary changes. For a description of the fields, refer to the sasSpawner Attributes List.

  6. When you are finished, select the Save icon (Save) on the toolbar; or select File Save from the menu bar. (If you skip this step, IT Administrator will prompt you to save your changes when you attempt to navigate to another object.)