beautypg.com

Acceptincomingsession, Acceptincomingsession m, Accepticomingsession – Echelon OpenLNS User Manual

Page 702

background image

OpenLNS Programmer's Reference

665

AcceptIncomingSession

Summary

Accepts or rejects an incoming uplink session request after

you have registered your application for uplink session

handling

.

You can use this method to accept or reject an uplink session

request after a request has been received, and the

OnIncomingSessionEvent event has been fired. If an uplink

session request is rejected, the session will be terminated. If

the uplink session request is neither accepted nor rejected

before the session establishment time-out period for the

xDriver Profile handling the session expires, the request will

be rejected automatically.
The session establishment time for a Profile can be

configured using the xDriver Profile Editor. For more

information on this, see Chapter 3 of the OpenLDV

Programmer’s Guide, xDriver Supplement.
Note that your application must register to receive uplink

session requests by invoking the

BeginIncomingSessionEvents method.
Once you have accepted a session, you can open the network

containing the RNI device involved in the session, and use

the OnSessionChangeEvent event to monitor the state of the

xDriver session. These methods and events only apply to

clients that are using the OpenLDV xDriver to connect to

remote network interface (RNI) devices. For an overview of

the OpenLDV xDriver, see the OpenLNS Network Interface

Drivers chapter in the OpenLNS Programmer’s Guide.

Availability

Local, full, lightweight, and independent clients.

Syntax

objServer.AcceptIncomingSession tag, acceptUplink,

postponeUpdates

Element

Description

osObject

The

ObjectServer

object to be acted on.

tag

A Long value identifying the session

being accepted or rejected. This value

is passed to the

OnIncomingSessionEvent

event as the

tag element when the uplink session

request is received.

acceptUplink

A Boolean value indicating whether the

session is to be accepted.

TRUE. Accepts the

incoming uplink

session request

.

FALSE. Rejects the

session

.

postponeUpdates A Boolean value indicating whether

monitor point update events are to be

suspended while the uplink session is