Spawner Invocation Options

The following options can be used in the command to start up the spawner for an IOM Bridge server. Note that the spawner must be stopped and restarted in order to reflect configuration updates.

-authProg

UNIX only. Specifies a fully qualified path to the executable to use for authentication. Paths with embedded blanks must be quoted. Refer to the UNIX Install Doc section titled "Configure User Authorization.". This option may be abbreviated as -ap.

-clientinput

Alpha/VMS only. Specifies the directory in which the spawner creates DCL command files that are used when spawning the detached client process. If -clientinput is specified without also specifying a value, the temporary files are created in the directory where the spawner is currently running. If a value is included, the temporary files are created in the specified location. If -clientinput is not specified, the spawner communicates with the spawned process by way of a "pipe," which is the default behavior.

-configFile

Specifies a fully qualified path to the file that contains spawner or dependent spawner configuration information. Enclose paths with embedded blanks in quotation marks. On Windows, enclose paths with embedded blanks in double quotation marks. On OS/390, specify filenames similarly to //dsn:myid.objspawn.log for MVS and //hfs:filename.ext for OpenEdition files.

This option may be abbreviated as -cf.

-deinstall

Windows NT only. Instructs the spawner to to deinstall as a Windows NT Service. This option may be abbreviated as -di.

-dependent

Instructs the spawner to launch as a Dependent Spawner Daemon. This option may be abbreviated as -dep.

-install

Windows NT only. Instructs the spawner to install as a Windows NT service. This option may be abbreviated as -i. When asked to install as an NT service, the spawner records all options specified at install time in the registry under the following key:

"SYSTEM\CurrentControlSet\Services\SAS Object Spawner Daemon\Parameters"

You may also specify options in the Startup Parameters when you manually start the spawner service from the Services dialog box.

-ldapBase

Specifies he Distinguished Name (DN) in which to base all subsequent LDAP searches. This option may be abbreviated as -lb.

-ldap_binddn

Specifies the Distinguished Name (DN) in which to bind to the LDAP server. This, along with ldap_bindpw, might be needed when your network directory is secured. This option may be abbreviated as -lbd.

-ldapHost

Specifies the DNS Name of the machine that is hosting the network directory that contains the spawner's configuration information. This option may be abbreviated as -lh.

-ldapPort

Specifies the port on the ldapHost on which to connect. The default is 389. This option may be abbreviated as -lp.

-ldap_bindpw

Specifies the password that is associated with the ldap_binddn or ldapURL given. This, along with the ldap_binddn or bind information in the ldapURL, might be needed when your network directory is secured. This option may be abbreviated as -lpw.

-ldapURL

Specifies the LDAP URL that contains the host, port, base, bind, and, optionally, password information in which to utilize in order to obtain the spawner configuration information. This option may be abbreviated as -lu.

 -noSecurity

Windows NT only. Instructs the spawner not to authenticate clients. Clients will execute as the user that launched the spawner. This option is useful during development.

WARNING: Because clients connected to the -noSecurity spawner execute as the user that launched the spawner, it is strongly suggested that the host in which the spawner is executing not be connected to a network. Otherwise, data that is accessible by the user that launched the spawner is at risk.

Note: If you use the -install option to install the spawner as an NT service, do not use the -nosecurity option.

-sasDependentSpawnercn

Specifies the sasDependentSpawnercn of the sasDependentSpawner object to utilize for this dependent spawner invocation configuration. When sasDependentSpawnercn is specified, the option dependent is assumed. When sasDependentSpawnercn is not specified (and dependent is), the first sasDependentSpawner definition with a sasMachineDNSName of the current host is used.

This option may be abbreviated as -sdsc.

-sasLogFile

Specifies a fully qualified path to the file in which to log spawner activity. Enclose paths with embedded blanks in quotation marks. On OS/390, filenames should be specified similarly to //dsn:myid.objspawn.log for MVS and //hfs:filename.ext for OpenEdition files. This option may be abbreviated as -slf.

-sasSpawnercn

Specifies the sasSpawnercn of the sasSpawner object to utilize for this spawner invocation configuration. When sasSpawnercn is not specified, the first sasSpawner definition with a sasMachineDNSName of the current host is used. This option may be specified as -ssc.

-sasVerbose

When present, this option causes the spawner or dependent spawner to record more detail in the log file (sasLogFile). This option may be abbreviated as -sv.