Application Handle (agent ID)




Snapshot Level
Application
Lock
DCS Application


Logical Data Grouping
appl_id_info
appl_lock
dcs_applinfo


Monitor Switch
Basic
Basic
Basic


Resettable
No
 



Event Type
Connection
Statement


Logical Data Grouping
connheader_event
stmt_event
subsection_event
 


API Element Name
Element Type
agent_id
information

 

Description:  A system-wide unique ID for the application. On multi-node systems, where a database is partitioned, this ID will be the same on every node where the application may make a secondary connection.

Usage:  The application handle can be used to uniquely identify an active application (application handle is synonymous with agent Id).
Note:The name agent_id is still used in the APIs, so that old applications can still be compiled with the Version 5 header files.

It can be used as input to GET SNAPSHOT commands that require an agent Id.

When reading event traces, it can be used to match event records with a given application.

It can be used as input to the FORCE APPLICATION command or API. On multi-node systems this command can be issued from any node where the application has a connection. Its effect is global