EMS Manual

Procedure Calls for Standard Events
EMS Manual—426909-005
11-40
EMS_USAGE_THRESHOLD_EVT_BLD_

If Job ID is not present or the value is zero, the procedure calls system procedure
PROCESS_GETINFO_ to get the job ID. If the job ID obtained is nonzero, the job
ID is added to the event buffer. Otherwise, the job ID is not added to the event
buffer.
The nonzero job ID obtained from calling PROCESS_GETINFO_ is the NetBatch
job ID associated with the process that calls this EMS event-building procedure.
If the subject reported in this event is managed by a process different from the
process that calls this EMS event-building procedure, the caller should provide the
Job ID, which is the NetBatch job ID associated with the process that manages
the subject.

If the Subject token ID has a variable-length value, choose one of these ways
to specify the length.

If the Subject length is present, the Subject length is the length, in
bytes, of the Subject value.

If the Subject length is not present, place the subject length in the two
bytes that immediately precede the Subject value. Make the Subject
value point to the extra two bytes. Do not count the two-byte length field as
part of the subject length.

The subject of this event is the object whose usage is being reported. The
Subject value must be fully qualified so that it can be uniquely identified from
any point in a network. An example is
\nodename.$volume.subvolume.filename.
Use EMSADDSUBJECT or EMSADDSUBJECTMAP to specify additional subjects.

The caller should not modify the content of the Usage Threshold Control
Block.