CONNECT Statement
INTERFACEIID=UUID UUID
is a 36-character alphanumeric string that represents a valid UUID of the desired interface within the object acquired.
Alias IID
CONNECT Statement 175
Note Enclose the option in quotation marks. Separate multiple options with a comma.
Example opts='iid=0E3B1810-6646-11D5-8863-00C04F48BC53, user=myusername,pass=mypswd'
LOCALE=locale-name
The value for the LOCALE option specifies the locale of the connecting peer.
locale-name is a valid locale.
Note Enclose the option in quotation marks. Separate multiple options with a comma.
Example opts='locale=french,
servername=SASApp - Stored Process Server'
MAJOR=major-version-number
specifies the major portion of the bridge protocol version to use.
major-version-number
is a number that represents the major (tenths) portion of the bridge protocol version.
Note Enclose the option in quotation marks. Separate multiple options with a comma.
Example For SAS 9.4 this would be MAJOR=4 MINOR=0.
MINOR=minor-version-number
specifies the minor portion of the bridge protocol version to use.
minor-version-number
is a number that represents the minor (hundredths) portion of the bridge protocol version. When a minor version number does not exist, use the number zero.
Note Enclose the option in quotation marks. Separate multiple options with a comma.
Example For SAS 9.4 this would be MAJOR=4 MINOR=0.
NOREDIRECT
disables any load-balancing redirection that would be performed by the server. Use this option with caution. It should be used only when attempting to get an administrative connection to a load-balanced server.
Example opts='noredirect,
servername=SASApp - Stored Process Server'
USER=user-ID
specifies the identity to use when connecting to the peer identified in this IOM URI.
user-ID
is a valid metadata identity with permission to access the peer.
Note Enclose the option in quotation marks. Separate multiple options with a comma.
Example opts='user=myusername,pass=mypswd,
servername=SASApp - Stored Process Server'
PASS=password
specifies the password for the identity to use when connecting to the peer identified in this IOM URI.
password
is a valid password for the metadata identity used to access the peer.
Note Enclose the option in quotation marks. Separate multiple options with a comma.
Example opts='user=myusername,pass=mypswd,
servername=SASApp - Stored Process Server'
SECURITYPACKAGE=package-name | NEGOTIATE
identifies the security package that the IOM server uses to authenticate incoming client connections.
package-name
specifies the security package that the IOM server should use to authenticate incoming client connections. Valid values are Kerberos and NTLM.
NEGOTIATE
enables the server to present a set of valid security packages (through the SECPACKAGELIST system option) that the server uses to find a match with an incoming client connection. If the client specifies a security package in the list, then the server attempts to authenticate the client using the matched security package.
Default NEGOTIATE
Note Enclose the option in quotation marks. Separate multiple options with a comma.
See “SECPACKAGE System Option” on page 161
Example opts='sspi,securitypackage=negotiate, securitypackagelist=Kerberos,NTLM'
SECURITYPACKAGELIST=package-name, …
specifies the security authentication packages used by the server.
Note Enclose the option in quotation marks. Separate multiple options with a comma. To use the SECPACKAGELIST system option, SECPACKAGE must be set to negotiate.
See “SECPACKAGELIST System Option” on page 163
Example opts='sspi,securitypackage=negotiate, securitypackagelist=Kerberos,NTLM'
CONNECT Statement 177
SERVERNAME=server-name
specifies the name of the server to which you want to connect.
server-name
is a valid server name or a unique URI that is stored in metadata.
Note Enclose the option in quotation marks. Separate multiple options with a comma.
Example opts='servername=SASApp - Stored Process Server,timeout=3600'
SPN=name
specifies the service principal name that the client wishes to use with this IOM Server instance.
name
is a valid service principal name.
Note Enclose the option in quotation marks. Separate multiple options with a comma.
Example opts='spn=SAS [Config-Lev1] SASMeta - Metadata Server,timeout=3600'
SSPI
identifies support for the Security Support Provider Interface for single sign-on (SSO) csign-onnectisign-ons to IOM servers.
Note Use SSPI in conjunction with SECURITYPACKAGE and SECURITYPACKAGELIST.
See “SECURITYPACKAGE=package-name | NEGOTIATE” on page 177 , “SECURITYPACKAGELIST=package-name, …” on page 177
Example opts='sspi,securitypackage=negotiate, securitypackagelist=Kerberos,NTLM'
TIMEOUT=milliseconds
specifies the time-out, in milliseconds, of all outcall activity.
milliseconds
a number that represents the number of milliseconds to wait before abandoning the server connection.
Note Enclose the option in quotation marks. Separate multiple options with a comma. The value of the TIMEOUT never reaches the target IOM server.
Example opts='timeout=3600,servername=SASApp - Stored Process Server'
TRUSTEDSAS
indicates that the owner of the current IOM Server is to be used as the identity when connecting to the peer identified in this IOM URI.
Alias IOMOPTS=, OPTS=
Note Enclose IOM-option in quotation marks. Separate multiple options with a comma.
See “Example 8: CONNECT Example Using Kerberos” on page 195
Example opts='servername=SASApp - Stored Process Server,timeout=3600'
CLSID=
specifies the type of server being connected to.
This is an optional parameter and is required only when connecting to a SAS 9.2 or earlier server. When connecting to SAS 9.3 and later servers, this parameter can be omitted.
The LIST TYPES command on page 187 displays the full name, short name, and UUID of the known server types. Any of the UUIDs can be used with CLSID.
class-UUID
is a 36-character alphanumeric string that represents a valid class UUID for the server.
Note When used as a connection parameter, enclose class-UUID in quotation marks.
See “Example 3: CONNECT Example Using a URI and a Class Identifier ” on page 193
Example clsid="0E3B1810-6646-11D5-8863-00C04F48BC53"
SERVERTYPE=
specifies the type of server being connected to.
This is an optional parameter and is required only when connecting to a SAS 9.2 or earlier server. When connecting to SAS 9.3 and later servers, this parameter can be omitted.
The LIST TYPES command on page 187 displays the full name, short name, and UUID of the known server types. Any of the types can be used with SERVERTYPE.
"type-name"
an alphanumeric string that represents a valid type for the server.
Alias TYPE=
See “Example 5: CONNECT Example with a Server Name” on page 194
Example type=storedprocess
SPAWNED=
specifies the UUID of a spawned server.
This parameter is valid only when connecting to an object spawner. It has the effect of connecting through the spawner to the spawned server.
"UUID"
is a 36-character alphanumeric string that represents a valid UUID (unique universal identifier) for the spawner.
Alias LAUNCHED=
Note Enclose UUID in quotation marks. Because you are connecting to the object spawner, any other connection options that follow (like PORT=, TYPE=, and so on) refer to the spawner.
CONNECT Statement 179
See “Example 7: CONNECT and LIST Examples Using a Spawner” on page 194
Example spawned="E3D5D132-5DC0-46CB-A4FD-713098B1EE95"