_createRemoteInstance

_createRemoteInstance

Creates instance in remote SAS session.

Syntax
Example

Syntax

CALL SEND(robjInst, '_createRemoteInstance',
remote_name, class_name, rc);

Where... Is type... And represents...

remote_name C remote destination

class_name C fully-qualified class name

rc N return code

Where...	Is type...	And represents...
remote_name	C	remote destination
class_name	C	fully-qualified class name
rc	N	return code

_createRemoteInstance: creates an instance of the specified class in the remote environment. The user is responsible for obtaining the instance of the ROBJECT class, and then sending it the _createRemoteInstance method. After the _createRemoteInstance method has successfully completed, methods can be invoked using the remote instance.
remote_name: designates the remote destination in which to create the instance. It is the concatenation of the keyword "remote", a double-slashed delimiter, and then the REMOTE= value that was supplied in the SIGNON statement. For example, if OAK is the node signed onto, then the remote_name would be, "remote//oak".
class_name: is the fully qualified class name that is used to create a remote instance (that is, library.catalog.classname).
rc: is a return code that indicates success or failure. A value of zero indicates success. A non-zero value indicates failure.

Example

This example creates a remote instance of the class sashelp.fsp.object by first signing on to the remote host OAK and then issuing the _createRemoteInstance method.

filename rlink 'tcpunix.scr';
signon oak;

robj = loadclass('sashelp.connect.robject.class');
robjInst = instance(robj);
call send(robjInst, 
          "_createRemoteInstance", 
          "remote//oak", 
          "sashelp.fsp.object",
          rc);

Chapter Contents
Previous
Next
Top of Page