<sasads:Connection>
The Connection Custom Tag allows the user to include SAS DataSet connectivity within a JSP page. The Connection Tag may be used in all four scopes, PAGE, REQUEST, SESSION, and APPLICATION. If the Connection Tag is used with a scope of PAGE, all code must either be contained within the body of the Connection Tag. If the scope is of the Connection Tag is PAGE and a body is present, the connection will be stopped at the end of the Connection Tag's body. If the id or ref attributes are null the connection will be stopped at the end of the Connection Tag's body.
Syntax
<sasads:Connection
[accessMethod="java.lang.String"]
[allowCustomize="true|false"]
[appletCodebaseRelative="true|false"]
[applicationClass="java.lang.String"]
[applicationGroup="java.lang.String"]
[applicationPassword="java.lang.String"]
[applicationUsername="java.lang.String"]
[command="java.lang.String"]
[commandPrompt="java.lang.String"]
[commandPromptTimeout="java.lang.String"]
[deadlockWaitTime="int"]
[deferAllUntilRuntime="true|false"]
[deferApplicationUserInfoUntilRuntime="true|false"]
[deferUserInfoUntilRuntime="true|false"]
[designTimeActive="true|false"]
[encryptionAlgorithms="java.lang.String"]
[encryptionPolicy="java.lang.String"]
[encryptionTarget="java.lang.String"]
[factoryDestroyTimeout="int"]
[funnel="true|false"]
[funnelHost="java.lang.String"]
[handshakeTimeout="int"]
[host="java.lang.String"]
[id="value"]
[ignoreTimeout="true|false"]
[initialClass="java.lang.String"]
[initialStatement="java.lang.String"]
[instantiate="true|false"]
[jdbcDriver="java.lang.String"]
[jdbcDriverURL="java.lang.String"]
[locale="java.util.Locale"]
[logTrap="true|false"]
[parameterMode="java.lang.String"]
[password="java.lang.String"]
[passwordPrompt="java.lang.String"]
[passwordPromptTimeout="java.lang.String"]
[persistedName="java.lang.String"]
[port="int"]
[portPrompt="java.lang.String"]
[portPromptTimeout="java.lang.String"]
[prodauthLoginTimeout="int"]
[profileName="java.lang.String"]
[profiler="true|false"]
[ref="java.lang.String"]
[rocf="java.lang.String"]
[rocfObj="com.sas.rmi.Rocf"]
[routerURL="java.lang.String"]
[runtimeExceptionAlways="true|false"]
[runtimeExceptionNoListeners="true|false"]
[runtimeParamKeyPrefix="java.lang.String"]
[scope="java.lang.String"]
[searchDataSets="java.lang.String"]
[serverArchitecture="java.lang.String"]
[serverEncoding="java.lang.String"]
[serverEncodings="java.lang.String"]
[serverListVersion="int"]
[sessionReleaseTimeout="int"]
[stop="true|false"]
[traceProxyClient="true|false"]
[useProfile="true|false"]
[username="java.lang.String"]
[usernamePrompt="java.lang.String"]
[usernamePromptTimeout="java.lang.String"]
[useRouter="true|false"]
[useRuntimeParams="true|false"]
[useServerBroker="true|false"]>
</sasads:Connection>
Attributes
accessMethod | Sets the accessmethod to use for the connection |
|---|---|
allowCustomize | Allows the use of the customizer when using deferred user info |
appletCodebaseRelative | Turn on a switch making the SAS server be looked up from wherever the web server is for this app to facilitate app porting |
applicationClass | Sets the application class for the connection |
applicationGroup | Sets the application group for the connection |
applicationPassword | Sets the application-level password |
applicationUsername | Sets the application-level user name |
command | Sets the command used to invoke SAS on the remote host |
commandPrompt | Sets the command prompt to search for during telnet initialization |
commandPromptTimeout | Sets the maximum number of seconds to wait for a command prompt. |
deadlockWaitTime | the max time sleeping, waiting for deadlock |
deferAllUntilRuntime | Turns on/off the deferring of all connection properties until runtime |
deferApplicationUserInfoUntilRuntime | Turns on/off the deferring of the application-level username and password properties until runtime |
deferUserInfoUntilRuntime | Turns on/off the deferring of the username and password properties until runtime |
designTimeActive | Turns on/off the design time status for the connection |
encryptionAlgorithms | Sets a comma-separated list of encryption algorithms that the client would like to use to secure this connection in order of preference |
encryptionPolicy | Tells the connection what level of encryption is required for the connection to succeed |
encryptionTarget | Sets the target of encryption (SAS, telnet, or both) |
factoryDestroyTimeout | Sets the Factory Destroy Timeout for the connection |
funnel | Turns on/off the use of a funnel host to share a single SAS session between multiple clients |
funnelHost | Sets the host name for funneling and/or session brokering |
handshakeTimeout | Sets the Handshake Timeout for the connection |
host | Sets the target host name |
id | Case-sensitive name used to identify the object instance. |
ignoreTimeout | Turns on/off method timeout, esp for start and endsas |
initialClass | Sets the initial class to be invoked during the SAS session logon |
initialStatement | Sets the initial statement to be submitted on a newly created SAS session |
instantiate | |
jdbcDriver | Sets the JDBC driver name (such as sun.jdbc.odbc.JdbcOdbcDriver) |
jdbcDriverURL | Sets the JDBC connection URL (such as jdbc:odbc:foobar) |
locale | |
logTrap | Turns on/off the SAS log trace |
parameterMode | Sets the method parameter mode |
password | Sets the user password for the connection |
passwordPrompt | Sets the password prompt to search for during telnet initialization |
passwordPromptTimeout | Sets the maximum number of seconds to wait for a password prompt |
persistedName | Sets the persisted name |
port | Sets the telnet port for the connection |
portPrompt | Sets the port number prompt to search for during telnet initialization |
portPromptTimeout | Sets the maximum number of seconds to wait for a port prompt |
prodauthLoginTimeout | Sets the Prodauth Login Timeout for the connection |
profileName | Sets the connection profile name to use within the Middleware Server |
profiler | Turns on/off method profiling |
ref | |
rocf | the rocf orb to be used. |
rocfObj | the rocf orb to be used. |
routerURL | Sets the router URL for the connection |
runtimeExceptionAlways | Turns on/off the throwing of runtime exceptions for any remote exception |
runtimeExceptionNoListeners | Turns on/off the throwing of runtime exceptions for any remote exception when there are no exception listeners |
runtimeParamKeyPrefix | Sets the runtime param prefix to use |
scope | |
searchDataSets | Sets the data sets to search for name mappings |
serverArchitecture | Sets the architecture on the given connection context |
serverEncoding | Sets the name of the server's preferred session encoding(such as Cp1250) |
serverEncodings | Set the names of the server's supported session encodings (such as "Cp1250,UTF8") |
serverListVersion | Sets the highest HList/SCL list stream version supported by the server |
sessionReleaseTimeout | Sets the Session Release Timeout for the connection |
stop | true if the connection should be stopped. |
traceProxyClient | Turns on/off the tracing of client debug information |
useProfile | Allows the use of a connection profile when funneling |
username | Sets the user name for the connection |
usernamePrompt | Sets the username prompt to search for during telnet initialization |
usernamePromptTimeout | Sets the maximum number of seconds to wait for a username prompt |
useRouter | Enables the use of the JTUNNEL feature |
useRuntimeParams | Allows the use of runtime params (such as from HTML PARAM tags) |
useServerBroker | Turns on/off the use of a server broker to pre-allocate SAS sessions |
More Information
To view the documentation for the related InformationBean, see com.sas.rmi.Connection.
If you need to subclass the tag handler class for the sasads:Connection tag, extend com.sas.taglib.rmi.ConnectionTag.