ARSetSessionConfiguration

Description

Sets an API session variable.
If you perform a set operation on an overlay and you provide values for an inherited grain, the values are ignored. Only values for extended or overwritten grains of the overlay are set.

Privileges

This operation can be performed by all users.

Synopsis

#include "ar.h"
#include "arerrno.h"
#include "arextern.h"
#include "arstruct.h"

int ARSetSessionConfiguration(
   ARControlStruct *control,
   unsigned int variableId,
   ARValueStruct *variableValue,
   ARStatusList *status)

Input arguments

control

The control record for the operation. It contains information about the user requesting the operation, where that operation is to be performed, and which session is used to perform it. The user and sessionId fields are required.

variableId

Identification of the variable type:

variableValue

Configuration variable value:

• AR_SESS_CHUNK_RESPONSE_SIZE (integer): An integer value for the maximum data packet size returned from the server to the client in one transmission.
• AR_SESS_TIMEOUT_NORMAL (integer): An integer value for the client timeout value used in fast server operations.
• AR_SESS_TIMEOUT_LONG (integer): An integer value for the client timeout value used in list server operations.
• AR_SESS_TIMEOUT_XLONG (integer): An integer value for the client timeout value used in definition updating and in import/export operations.
• AR_SESS_LOCK_TO_SOCKET_NUMBER (integer): An integer value for the socket number that the client locks to for all server interaction.
• AR_SESS_POOLED (integer): An integer value for the flag that indicates if the session is pooled. Valid values for this option are 0 (No ) and 1 (Yes).
• AR_CLIENT_TYPE_* (integer): An integer value for the client type. For more information, see AR_CLIENT_TYPE_* in the ar.h file.
  Range of values for user-defined, client-type variables: AR_CLIENT_TYPE_END_OF_RESERVED_RANGE: > 5000.
• AR_SESS_VUI_TYPE (integer): An integer value for the type of VUI. For more information, see AR_VUI_TYPE_* in the ar.h file.
• AR_SESS_OVERRIDE_PREV_IP (integer): An integer value for the flag that indicates if the session can be overridden. Valid values for this option are 0 (No) and 1 (Yes).

• AR_SESS_CONTROL_PROP_DESIGN_OVERLAYGROUP (character): A character value that indicates whether to use an object's real or resolved name in administrative and design-time operations (ARCreate, ARDelete, and ARSet calls) and whether to perform the operation only on objects in a specified overlay group. (Unmodified objects are members of all groups, so they are included in all operations regardless of the value of this variable.)
  Valid values for this option are the following strings:

  None or 0 — Use real names; perform operation on origin (overlaid and unmodified) objects.

  overlayGroupID — Use resolved names; perform operation on objects in the specified overlay group. (In AR System 7.6.04, you can only specify group ID 1.)

  -1 — (Base Development mode) Use real names; perform operation on origin (overlaid and unmodified) objects.

  -2 — (Full Development mode) Use real names; perform operation on all objects (overlay, overlaid, unmodified, and custom).

• AR_SESS_CONTROL_PROP_API_OVERLAYGROUP (character): A character value that indicates whether to use an object's real or resolved name in runtime operations (ARGet, ARGetList, and ARGetMultiple calls) and whether to perform the operation only on custom and overlay objects in a specified overlay group. (Unmodified objects are members of all groups, so they are included in all operations regardless of the value of this variable.)
  Valid values for this option are the following strings:

  None or 0 — Use real names; perform operation on origin (overlaid and unmodified) objects.

  overlayGroupID — Use resolved names; perform operation on objects in the specified overlay group. (In AR System 7.6.04, you can only specify group ID 1.)

  -1 — (Base Development mode) Use real names; perform operation on origin (overlaid and unmodified) objects.

  -2 — (Full Development mode) Use real names; perform operation on all objects (overlay, overlaid, unmodified, and custom).

• AR_SESS_CONTROL_PROP_GRANULAR_OVERLAY_RETRIEVE_MODE (int): An integer value that defines what type of object definition is returned. Valid values for this option are:
  • 0 (the default): All Get<object> calls return the complete object definition.
  • 1: For grains of overlays that can be extended (form lists, permissions, and indexes), Get<object> calls return only the values used to extend or overwrite the values retrieved from the origin object.
    For all other grains, the inherited or overwritten values are returned.
• AR_SESS_API_CMD_LOG (char): A character value for the name of the API client side logging command file.
• AR_SESS_API_RES_LOG (char): A character value for the name of the API client side logging result file.

Return values

status

A list of zero or more notes, warnings, or errors generated from a call to this function. For a description of all possible values, see Error checking.

See also

ARGetSessionConfiguration.