HP-UX Workload Manager User's Guide

Advanced WLM usage: Using performance metrics
Supplying data to WLM
Appendix H506
• The glance_tt(5) manpage, which lists some of the more frequently
used metrics (manpage also available at http://www.hp.com/go/wlm)
The ARM API consists of six routines, which are described in the
following table. For complete usage information on these routines, see
arm(3), which is installed when you install GlancePlus. (To see this
manpage, be sure “/opt/perf/man” is part of your MANPATH environment
variable.)
You add the API calls to your source, isolating the desired transactions.
For example, consider the following pseudo-code that tracks individual
times for various tasks and also gets a time for all three processes
together:
arm_init(“application_name”, “user_name”)
arm_getid(“total_time”)
arm_getid(“pull_data”)
arm_getid(“process_data”)
arm_getid(“report_data”)
loop until end of program
arm_start(total_time)
arm_start(pull_data)
(get the data)
arm_stop(pull_data, status)
arm_start(process_data)
Table H-3 ARM API routines
ARM API routine Description
arm_init Initializes the ARM environment for the
application
arm_getid Names each transaction that is to be monitored
arm_start Indicates the start of a transaction
arm_update Updates statistics for a long-running
transaction
arm_stop Indicates the end of a transaction
arm_end Prepares the ARM environment for the
application’s exit