Administration Commands
activate_session
polarity
The polarity for the session. Possible values are:
POL_EITHER
POL_FIRST_SPEAKER
POL_BIDDER
If POL_EITHER is set, activate_session activates a first speaker session if available, otherwise a bidder session is activated. If POL_FIRST_SPEAKER or POL_BIDDER is set, activate_session only succeeds if a session of the requested polarity is available.
cnos_permitted
Indicates that CNOS processing is permitted. Possible values are:
YES
CNOS processing is permitted.
NO
CNOS processing is not permitted.
If the activation of a new session is not possible because the session limits for the specified mode are reset, and this parameter is set to YES, implicit CNOS processing will initialize the session limits. Execution of this command is suspended while CNOS processing is active.
2.1.2 Returned Parameters
If the command executes successfully, the following parameters are returned:
primary_rc
OK
secondary_rc
Possible values are:
AS_NEGOTIATED
The session was activated successfully; the session limit defined for the mode was negotiated during the activation process.
AS_SPECIFIED
The session was activated successfully; the session limit was not changed.
session_id
The session ID of the new session.
2.1.3 Error Return Codes
If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Parameter Check
If the command does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
PARAMETER_CHECK
secondary_rc
39