promap
Abstract
Displays a list of the processes associated with a specified processor or queue module, or a list of all existing processes if the argument all is passed. Each list entry includes the process’ numeric ID, associated process model, tag string, and owner object ID.
Syntax
promap [<objref> | <object hname> | all]
| Argument | Type | Description |
|---|---|---|
<objref> |
integer | numeric process ID of the object-of-interest A process ID can be obtained from the process list included in the output of the ODB command objprint, or by issuing the promap command with the “all” argument. |
<object hname> |
string | hierarchical name of the object-of-interest |
| all | n/a | Display all existing processes. |
Details
Process IDs are required so that processes can be uniquely identified in ODB commands which operate on processes (these are prodiag/proldiag, prostop/prolstop, protrace/proltrace).
A process can be assigned a more descriptive label, called a tag, by means of the op_pro_tag_set() KP. Process tags are displayed by the promap command if they have been set. Every process is associated with a processor or queue module, which is termed the owner of the process.
Example
ODB> objmap proc application
Obj ID Object Name Object Type Parent ID
------ ---------------------------------------------- ------------- ---------
22 ...ACE_Topology.Applications.application config processor 3
498 top.ACE_Topology.Client.application processor 6
927 top.ACE_Topology.Application Server.application processor 7
1355 top.ACE_Topology.DB Server.application processor 8
ODB> promap 498
____________________________________________________________
10 Active Processes for Module (498)
# process ID process model process tag
-- ---------- ------------------ -------------------
0 17 gna_clsvr_mgr (none)
1 74 traffic_engine (none)
2 76 gna_phase_mgr (none)
3 77 rtp_session_mgr (none)
4 78 rtp_session_cli (none)
5 89 gna_profile_mgr (none)
6 90 gna_custom_app_mgr (none)
7 91 gna_ace_task_mgr (none)
8 92 gna_ace_task_cli ACE_Topology.Client
9 97 gna_ace_task_cli ACE_Topology.Client