Table G_AGENT_STATE_HISTORY

This table contains detailed information about state changes during the agent's login session. The records inserted into this table include:

• changes to the agent's state.
• changes to the agent's pending state.
• changes to the agent's workmode.
• indication that the agent connected to a call.
• indication the agent disconnected from a call.

The setting of the gls-enable-acw-busy and gls-acw-first configuration options may affect the values of certain fields in this table. The setting of configuration options in the [filter-data] section may also impact records in this table. Refer to the Interaction Concentrator Deployment Guide for a description of the gls-enable options and those options available in the [filter-data] section.

Tip

To assist you in preparing supplementary documentation, click the following link to download a comma-separated text file containing information such as the data types and descriptions for all columns in this table: Download a CSV file.

Hint: For easiest viewing, open the downloaded CSV file in Excel and adjust settings for column widths, text wrapping, and so on as desired. Depending on your browser and other system settings, you might need to save the file to your desktop first.

Column List

Legend

Column	Data Type	P	M	F	Description
ID	numeric(16)	X	X		The unique, autonumbered ID of the record. This is the primary key.
Type	int		X		The type of the record. One of the following values: -1—unknown 0—normal–Reserved. 5—state–Records of this type track changes of agent's state. 6—pending_state–Records of this type track changes of agent's pending state (when agent's state remains the same). 7—add_party–Records of this type track addition (one by one) of parties connected with the agent (at least one party is already connected). 8—rem_party–Records of this type track removal (one by one) of parties connected with the agent (at least one party is still connected). 9—state_forced–Records of this type track changes of agent's state that were forced by information received for another device. 10—pending_forced–Records of this type track changes of agent's pending state that were forced by information received for another device. 11—reason–Records of this type track changes of agent's workmode (when agent's state remains the same). #DICTIONARY TYPE 13
State	int		X		The state of the agent on the device (endpointid) against a queue (queueid), or the previous state in G_AGENT_STATE_HISTORY table. One of the following values: 0—null–Agent is logged off. 1—login–Agent is logged in, but no information indicates whether the agent is ready to receive calls. 2—notready–Agent is not ready to receive calls. 3—ready–Agent is ready to receive calls. 4—acw–Agent is in the After Call Work state. 5—busy–Agent is on the call. 6—unknown–Agent's login session is present, but ICON has no information about agent's state (due to disconnection from T-Server or some similar reason). #DICTIONARY TYPE 16
PendingState	int				The pending state of the agent (if known). The agent's state will be changed to this state after the current state finishes. One of the following values: null–No pending state at the time. 2—notready–Not ready. 3—ready–Ready. 4—acw–After call work. #DICTIONARY TYPE 17
Seq	int		X		The sequence number of the state changes record. Each time that an agent's state on a device changed (against queue, if specified), this field has the next value. Agent state change types are listed at the top of this topic.
LSeq	int				The sequence number of the record within the a given login session.
PSeq	int				The sequence number of the record within the same state. If a pending state changed, this field has the next value. Records that reflect state changes have 0 in this field. Records that reflect pending state changes have a non-zero value in this field.
PrevState	int				State of the agent on device (endpointid) against queue (queueid), or previous state in G_AGENT_STATE_HISTORY table. One of the following values: 0—null–Agent is logged off. 1—login–Agent is logged in, but no information indicates whether the agent is ready to receive calls. 2—notready–Agent is not ready to receive calls. 3—ready–Agent is ready to receive calls. 4—acw–Agent is in the After Call Work state. 5—busy–Agent is on the call. 6—unknown–Agent's login session is present, but ICON has no information about agent's state (due to disconnection from T-Server or some similar reason). #DICTIONARY TYPE 16
PrevSEnter	datetime				The GMT-equivalent date and time when the previous agent state was detected.
PrevSEnter_ts	int				The UTC-equivalent value of the PREVSENTER field.
PrevSEnter_tcode	int				A reference, derived from the value of the PREVSENTER_TS field, to a record in the G_TIMECODE table.
Cause	int				The cause of creation of the record 0—nocause–No cause. Reserved for future use. 1—normal–The record was added as result of a TEvent that was received for the endpoint specified in the record. 2—forced_pause–Reserved. 3—forced_transition–The record was added to reflect changes in the agent's state (for example, pending state or workmode) that were forced by information received for another endpoint, or that resulted from information taken from the pending state. 4—autowork–After call work has started. #DICTIONARY TYPE 14
AgentStateCondition	int				Additional, detailed information regarding the forced state change. One of the following values: 0—nocondition–Reserved. 1—normal–The state change was not forced. 2—forced_by_another_device–The state change was forced by another device. 3—forced_by_pending_state–The state change was forced by a pending state. 4—forced_by_connection_info–The state change was forced by information in EventRegistered or was a result of a disconnection from T-Server. #DICTIONARY TYPE 15
WorkMode	int				The workmode of the agent state as reported by T-Server. One of the following values: 0—unknown–Reserved for cases when ICON and/or T-Server is unable to determine WORKMODE. 1—manualin–(AgentManualIn) the agent has to perform a manual operation to become available. 2—autoin–(AgentAutoIn) the switch's control system decides agent availability. 3—aftercallwork–(AfterCallWork) the state where a device, on behalf of an agent, is no longer involved with an ACD call. While in this state, the agent is performing administrative duties for a previous call and cannot receive further calls from the ACD. 4—auxwork–(AgentAuxWork) auxiliary work, the agent is not ready to receive calls (specific to the G3 switch only). 6—walkaway–(Walk Away) the state where an agent is logged in to an ACD group, but is understood not to be at the agent workstation, and thus not prepared to handle calls that the ACD distributes. 7—returnback–(AgentReturnBack) the agent has indicated return to the agent workstation (only used for transition from Walk Away state). #DICTIONARY TYPE 18
ReasonCode	varchar(255)				The hardware reason code value (switch reason code) by the value of the key ReasonCode in the Extensions section.
SysReason	int				The system reason. An internal ICON reason to create a record.
AgentID	int			X	The DBID of the agent (person) configuration object.
LoginID	int				The DBID of the Login (the AgentID in the configuration database) on the switch. In a SIP Cluster environment, the value for this field is NULL.
EndPointID	int				The DBID of the agent's endpoint (DN) configuration object in Configuration Server. In a SIP Cluster environment, the value for this field is 0.
QueueID	int				The DBID of the Queue (ACDQ) configuration object in Configuration Server, where the agent logged in. A value of 0 (zero) indicates that no queue is specified for this record.
PlaceID	int				The DBID of the place configuration object (if configured). This is the place where the agent logged in. In a SIP Cluster environment, the value for this field is NULL.
LoginSessionID	varchar(50)				The ID (GUID) of the agent's login session. Refer to the record in G_LOGIN_SESSION.
PartyID	varchar(50)				The PartyID of the party that is related to the record. Refer to G_PARTY. The PartyID can be either the party that connected with the agent or the party for the detected ACW state.
Added	datetime		X		The GMT-equivalent date and time when information about an agent's change of agent's state was detected.
Added_ts	int				The UTC-equivalent value of the ADDED field.
Added_tcode	int				A reference, derived from the value of the ADDED_TS field, to a record in the G_TIMECODE table.
GSYS_DOMAIN	int				Contains the data source session ID (DSS_ID) for the session that was active when the data was processed by ICON. For more information, see the description in System Fields (for DB2, Microsoft SQL Server, Oracle, or PostgreSQL, respectively).
GSYS_PARTITION	int				A key that is used for partitioning.
GSYS_SYS_ID	int				System ID. Reserved for future use.
GSYS_SEQ	bigint				Insert Sequence. Not unique.
GSYS_USEQ	bigint				Update Sequence. Not unique.
GSYS_TS	datetime				Reserved
GSYS_TC	int				Reserved
GSYS_EXT_VCH1	varchar(255)				A string value with the name of the media type for a 3rd Party Media interaction, as reported by Interaction Server. When the field GSYS_EXT_INT1 indicates that this is a 3rd Party Media interaction (1000—Open Media), the stored string is the name of the media type. For example, "fax". In a SIP Cluster environment, records the DN name.
GSYS_EXT_VCH2	varchar(255)				If the gls-store-event-seq configuration option is set to 1, then this field stores the event sequence number, as a string, from the triggering event for this record. Otherwise, this field is either 0 (when events come from Interaction Server 7.5) or null (when events come from Interaction Server 7.6 or T-Server 7.5+).
GSYS_EXT_INT1	int				The media type of this interaction. One of the following values: 0—Unknown. Reserved for when ICON is unable to determine media type. 1—Voice. 2—Email. 3—Chat. 1000—Open Media. #DICTIONARY TYPE 6
GSYS_EXT_INT2	int				The Agent's busy level—The number of calls with which the agent was connected at the time the history record was added. The calls are counted separately for each login session of the agent (if more than one login session exists at the same time on different switches).