14.03.2014 Views

Scripting Guide - SAS

Scripting Guide - SAS

Scripting Guide - SAS

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

670 JSL Syntax Reference Appendix A<br />

<strong>SAS</strong> Integration Functions<br />

Arguments<br />

name Optional: quoted string that can contain a physical machine name or the name of a<br />

metadata-defined (logical) server. In the first case, the port must be provided. In the second case, a<br />

port must not be provided. If neither name nor port are included, and JMP is running on Windows,<br />

a connection to <strong>SAS</strong> on the local machine (via COM) is attempted, and all named parameters are<br />

ignored.<br />

port Optional: quoted string or integer. If name is a physical machine name, this is the port on that<br />

machine to connect to. If name is a metadata-defined (logical) server, port must not be included.<br />

Named Arguments<br />

All the named arguments are optional.<br />

UserName(name) A quoted string that contains the user name for the connection.<br />

Password(password) A quoted string that contains the password for the connection.<br />

ReplaceGlobalConnection(0|1) A Boolean. The default value is True. If True, and a successful<br />

<strong>SAS</strong> server connection is made, this connection replaces the active <strong>SAS</strong> connection that becomes the<br />

target of other global <strong>SAS</strong> JSL function calls. If False, the global <strong>SAS</strong> connection is not changed, and<br />

the returned <strong>SAS</strong>Server scriptable object should be used to send messages to this server connection.<br />

ShowDialog(0|1) A Boolean. The default value is False. If True, other arguments (except<br />

ReplaceGlobalConnection) are ignored and the <strong>SAS</strong> Server Connection window appears. This<br />

provides the JSL programmer a way to open the <strong>SAS</strong> Connect window.<br />

Prompt(Always|Never|IfNeeded) A Keyword. Always means always prompt before attempting<br />

to connect. Never means never prompt even if the connection attempt fails (just fail and send an<br />

error message to the log), and IfNeeded (the default value) means prompt if the attempt to connect<br />

with the given parameters fails (or is not possible with the information given).<br />

<strong>SAS</strong> Deassign Lib Refs(libref)<br />

Description<br />

De-assign a <strong>SAS</strong> libref on the active global <strong>SAS</strong> server connection.<br />

Returns<br />

1 if successful; 0 otherwise.<br />

Arguments<br />

libref Quoted string that contains the library reference to de-assign.<br />

<strong>SAS</strong> Disconnect()<br />

Description<br />

Disconnect the active global <strong>SAS</strong> connection, if any.<br />

Returns<br />

Void.<br />

Arguments<br />

None.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!