OIL2 Class Standard.EstablishConnection

class Standard . EstablishConnection {
        oid     client;
        string  destination;
        oid     ioObj;
        assoc   ioObjACL;
} inherits from Object;

DESCRIPTION

The EstablishConnection class implements a convenient facility that attempts to establish a connection to a remote network service. When the result of the connection attempt is known, the client is sent either a connectionEstablished or connectionAttemptFailed message. The connectionEstablished message includes as its single argument the object Id of the IOobject representing the newly established connection.

METHODS

Standard.EstablishConnection:create

EstablishConnection:create(string dest, oid notify, optional assoc aclForIO)

Method Description

The create method takes two mandatory arguments:

a URL specification of the transport and destination address
the object Id of the object to be sent a connectionEstablished message
an optional access control list for the IOobject that will represent the connection. If not provided, a default access control list will be used.

Standard.EstablishConnection:attemptNewConnection

EstablishConnection:attemptNewConnection()

Method Description

The attemptNewConnection method can be used to re-establish a connection to the destination that was set at the time the object was created. This method takes no arguments and does not return a value.