HP-UX Workload Manager Toolkits User's Guide

HP-UX WLM Duration Management Toolkit and HP-UX WLM Toolkit for Base SAS Software
How do I use DMTK / SASTK?
Chapter 6 127
Instrumenting SAS jobs for better duration
management
DMTK comes with the macro hp_wlmtk_goals_report. Use this macro
to instrument your SAS jobs for more precise duration management.
Place the macro throughout the source code to report “percent complete”
to the HP-UX Workload Manager duration management data collector
wlmdurdc. The syntax is
hp_wlmtk_goals_report(percent_complete)
where percent_complete is an integer from 1 to 99 inclusive.
Using this macro is optional. If you are satisfied with your current
duration management, do not use the hp_wlmtk_goals_report macro.
If, however, you prefer more precise duration management, use this
macro to guide wlmdurdc to more accurate management. With accurate
input from hp_wlmtk_goals_report, wlmdurdc can fine-tune its
estimates of the amount of CPU resources a job needs to finish in the
desired duration.
Each invocation of hp_wlmtk_goals_report in a SAS job collects the
following data:
• percent_complete, as read from the user-supplied argument
If the percent_complete value is invalid (not an integer from 1 to 99
inclusive), the value is logged to syslog but ignored for the purposes
of duration management.
•The job’s PID
This data is then passed to wlmdurdc, which makes the information
available in syslog.
NOTE Each macro invocation is numbered in syslog. This allows you to match
the data in the file to the invocation in the SAS job, which is helpful in
debugging. For example, assume syslog has an entry including:
Percent update: 79, Tag: 5 (pid 20179)