HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs

ACTIVATE_SESSION

The polarity for the session. Possible values are:

AP_POL_EITHER

AP_POL_FIRST_SPEAKER

AP_POL_BIDDER

If AP_POL_EITHER is set, ACTIVATE_SESSION activates a ﬁrst speaker session if available, other-

wise a bidder session is activated. If AP_POL_FIRST_SPEAKER or AP_POL_BIDDER is set, ACTI-

VATE_SESSION only succeeds if a session of the requested polarity is available.

cnos_permitted

Indicates that CNOS processing is permitted. Possible values are:

AP_YES

CNOS processing is permitted.

AP_NO

CNOS processing is not permitted.

If the activation of a new session is not possible because the session limits for the speciﬁed mode are reset,

and this parameter is set to AP_YES, implicit CNOS processing will initialize the session limits. Execution

of this command is suspended while CNOS processing is active.

3.1.3 Returned Parameters: Successful Execution

If the verb executes successfully, SNAplus2 returns the following parameters:

primary_rc

AP_OK

secondary_rc

Possible values are:

AP_AS_NEGOTIATED

The session was activated successfully; the session limit deﬁned for the mode was negotiated during

the activation process.

AP_AS_SPECIFIED

The session was activated successfully; the session limit was not changed.

session_id

The 8-byte identiﬁer of the activated session.

3.1.4 Returned Parameters: Parameter Check

If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:

primary_rc

AP_PARAMETER_CHECK

secondary_rc

Possible values are:

AP_EXCEEDS_MAX_ALLOWED

The session cannot be activated, because this would exceed the current session limit for this LU-LU-

mode combination.