Attributes for sasSpawner

The sasSpawner object class contains information for an instance of a SAS spawner. The sasSpawner object class is defined using the attributes listed in the following table. For each option, the table shows:

• The name that identifies the attribute on the LDAP server (or in the configuration file). Under each attributes name, the table shows the corresponding tab and field name in the IT Administrator application.

• "Required" or "Optional" to indicate whether the attribute is required.

• The type of server configuration for which the attribute is used. Note: Spawners are used only in IOM Bridge configurations. Therefore, IOM Bridge is listed as the server type for each option.

• A definition of the attribute.

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

• sasEncryptionModulesPath
• sasMasterPort
• sasMasterService
• sasLUName

For step-by-step instructions on defining the metadata for a spawner, refer to Using the IT Administrator Wizard to Define a Server and Spawner or Using IT Administrator to Define a Spawner. If you are not using an LDAP server, you can use a configuration file to define a spawner. For instructions, see Using a Configuration File to Define the Metadata.

sasSpawner Attribute Definitions
Attribute Name	Required/ Optional	Server Type	Definition
description In IT Administrator:: Description	Optional	IOM Bridge	Text to summarize why this object definition exists. This attribute is not used by the spawner.
objectClass In IT Administrator: N/A	Required	IOM Bridge	The object class identifier. For sasSpawner objects, this is always sasSpawner. If you use IT Administrator, this identifier is assigned automatically.
sasDomainName In IT Administrator: Connections    Domain	Optional	IOM Bridge	The security domain in which the sasSpawner definition participates. The spawner definition must have the same domain name as the server with which it connects. The spawner uses the domain name, along with the machine name and logical name, to determine which server(s) it services. The lack of a domain is considered a domain; therefore, if the spawner definition has no domain name, it will be associated only with servers that have no domain name.
sasLogFile In IT Administrator: Logging    Log File	Optional	IOM Bridge	A fully qualified path to the file in which spawner activity is to be logged. Paths with blanks must be in quotation marks. On Windows, paths with embedded blanks must be in double quotation marks. On z/OS, specify filenames similar to UNIX file paths due to the requirement for z/OS UNIX System Services.
sasLogicalName In IT Administrator: Logical Names	Optional	IOM Bridge	The logical names associated with this sasSpawner definition. When a spawner receives a request to start a SAS session, it looks for servers in its own domain and on its own machine that have the same logical name as the spawner. If logical names are specified, then the spawner supports only those sasServer instances whose logical names are a subset of the logical names defined here. If you are using a configuration file instead of LDAP, specify each logical name as a separate attribute and value pair.
sasMachineDNSName In IT Administrator: Machines	Required	IOM Bridge	The DNS name(s) and IP address(es) for the machine(s) on which this spawner definition may execute. Multiple values can be assigned to this attribute. The machine name must be the official network name (for example, machine.corp.com). The string localhost can be used to signify the host on which the spawner is executing.
sasNetEncrKey In IT Administrator: Encryption    Key Length	Optional	IOM Bridge	A numeric value (0, 40, or 128) that specifies the encryption key length. See SAS/SECURE for more information regarding this attribute.
sasOperatorPassword In IT Administrator: Connections    Operator    Password	Optional	IOM Bridge	The password that an operator must enter to connect to the spawner in order to perform administration tasks. The default password is sasobjspawn.
sasOperatorPort In IT Administrator: Connections    Operator    Port	Optional	IOM Bridge	The port on which to connect to the spawner in order to perform administration tasks (such as checking status). If neither sasOperatorPort nor sasOperatorService is specified, the service name sasobjoper is used as the sasOperatorService. The spawner will not start without an Administrator listen port or service.
sasOperatorService In IT Administrator: Connections    Operator    Service	Optional	IOM Bridge	The service in which to connect to the spawner in order to perform administration tasks. If neither sasOperatorPort nor sasOperatorService is specified, the service name sasobjoper is used as the sasOperatorService. The spawner will not start without an Administrator listen port or service.
sasSpawnercn In IT Administrator: Name	Required	IOM Bridge	The unique name for this sasSpawner object. When specified at spawner invocation, its value identifies which sasSpawner definition to use.
sasUUIDNode In IT Administrator: Connections    UUID    Node	Optional	IOM Bridge	The 12-character string that represents this spawner's node portion of its generated UUIDs. See the section titled Request a Universal Unique Identifier (UUIDGEND) for more information regarding UUID generation by the spawner.
sasUUIDPort In IT Administrator: Connections    UUID    Port	Optional	IOM Bridge	The port on which to connect to request UUID generation.
sasUUIDService In IT Administrator: Connections    UUID    Service	Optional	IOM Bridge	The service on which to connect to request UUID generation.
sasVerbose In IT Administrator: Logging    Verbose	Optional	IOM Bridge	When present, this attribute causes the spawner to record more details in the log file (sasLogFile or slf).