remote_check()

Check the validity of a remote session.

Syntax

remote_check(sessionID)

Parameter

Parameter

Definition

sessionID

identifier of the remote PATROL Agent session that is to be verified The sessionID is returned by the remote_open() function when you open a remote PATROL Agent session.

Description

The remote_check() function verifies whether a remote session to another PATROL Agent is still valid. The function returns 1 if the session is still valid. If the session is no longer valid, the function returns 0 and errno is set toE_PSL_REMOTE_SESSION_INVALID (145). 

For more information on using the remote functions, see remote_open().

Example

The following example shows the remote_check() function:

mysession=remote_open(targetHost, targetPort, "PEM", user, myencrypted_passwd);
# After doing some other stuff, check to see that remote session is still valid.
if ( remote_check(sess) ) {
#We are still connected, so trigger a remote event
remote_event_trigger(mysession,"myorigin","STD","41","ALARM","5","myarg");
} else {
print ("Lost connection to remote Agent. Go to plan B.\n”);
}


Was this page helpful? Yes No Submitting... Thank you

Comments