DataObject.CreateFromOtherServerDataSetEx

Prototypes

static DataObject CreateFromOtherServerDataSetEx( String sServerName, String sLibrefDotDataSetName, String sOptions )

static DataObject CreateFromOtherServerDataSetEx( <String sName,> String sServerName, String sLibref, String sDataSetName, String sOptions )

Return Value

The return value is a reference to the newly created object of the DataObject class.

Parameters

String sServerName
The name of the server containing the data set to use to populate the DataObject. This name must either be "My SAS Server" (which refers to the installation of SAS on your computer) or the name of a logical SAS Workspace Server defined in the SAS Metadata Server.

String sLibrefDotDataSetName
A string of the form "libref.member" that specifies the data set to use to populate the DataObject. You do not need to specify the libref if it is WORK.

String sLibref
The libref of the library containing the data set to use to populate the DataObject.

String sDataSetName
The name of the data set to use to populate the DataObject.

String sName
The name to assign to the DataObject.

String sOptions
A string containing data set options, as documented in SAS 9.4 Data Set Options Reference. The options must be separated from each other with spaces. This string can be empty.

Remarks

This method creates an object of the DataObject class and populates it with data from the specified data set on the specified server. The server may or may not be the server running the IMLPlus program. The only component of SAS that must be installed on the server is Base. If you do not specify the parameter sName, the string sDataSetName is used as the name of the DataObject.

If the libref is not assigned but the library is defined in the SAS Metadata Server, IMLPlus will assign the libref using the SAS Metadata LIBNAME Engine.

For information about how the DataObject class supports SAS data set passwords, refer to Password Support.

Example
declare DataObject dobj;
dobj = DataObject.CreateFromOtherServerDataSetEx( "My SAS Server",
                                                  "SASHELP.prdsale",
                                                  "OBS=5 KEEP=ACTUAL PREDICT" );
DataTable.Create( dobj ).ActivateWindow();
See Also

DataObject.CreateFromOtherServerDataSet

DataObject.CreateFromServerDataSetEx