Measure Reference Manual

On output
• If mode is READACTIVE_MANY_EXACT, context contains information about the matched
entity. Passing this value back the next time you want data for the same entity will increase
the performance of the request.
• If mode is READACTIVE_MANY_CHANGED or READACTIVE_MANY_LIST, a context of
0F indicates that no more entities matching entitydesc are available for retrieval. -1F
indicates an error return.
On input, if context has a value other than -1F or 0F:
• If mode is EXACT, the counter referenced by context is returned, provided that it applies
to the same object.
• If mode is LIST and the context value applies to the same object, and the entity type is
consistent with entitydesc, then counter records of the same type, from this counter
onward, are returned until bufsize is exhausted. LIST terminates at the end of one pass
through the linked counter list. If at any time context fails the check to ensure that it applies
to the same counter, an error is returned. A LIST/changed-record operation must restart
from the beginning.
• If mode is READACTIVE_MANY_CHANGED, the behavior is similar to LIST, but the ERROR
field in the header part of the record is updated to show whether the record has changed
since last requested. If the record has not changed and the style is ZMS, the 0th and 5th
bits of entity.HDR.ERROR are set to 1. Otherwise, the 5th bit is 0. If the Style is Legacy,
a value of -4 is returned in entity.ERROR field to indicate unchanged records.
• On successful return, context contains information about the next entity to be processed.
It should be passed as is for the future calls in that iteration. A return context of 1F
indicates an error.
templateversion
input
FIXED:value
is the appropriate template version literal from MEASDDLS for the entity type requested in
entitydesc if you want ZMS style external records. If omitted or passed as 0F, legacy style
records are returned.
If passed as -1F, the templateversion for the current release will be used, starting with the
H06.15/J06.04 RVUs. Note that returned external records, in this case, may not match the
counter record definitions with which the application was compiled.
Usage Notes
• The application that calls MEAS_READACTIVE_MANY must be running on the same processor
as the records to be retrieved. This procedure has high performance precisely because it does
not exchange interprocess messages. To retrieve records from multiple processors, run a copy
of the application on each processor.
• MEAS_READACTIVE_MANY does not return all the typical header and ID information for an
entity. Instead, the procedure returns a subset of descriptive information, such as the PIN,
LDEV, OCB or ACB number, and file name.
• In the case of ZMS style records, the procedure returns format and subsystem versions.
• If you specify the TEMPLATE^VERSION parameter to request ZMS style records, counter values
are returned according to the external ZMS type.CTRS^DEF template. If you omit the
TEMPLATE^VERSION parameter, legacy style external records are returned.
MEAS_READACTIVE_MANY_ 431