Measure Reference Manual

MEASMONCONTROL
Starts or stops the Measure subsystem. Alternatively, adds a CPU to the Measure subsystem by
starting a measurement control process (MEASCTL) in the specified CPU.
NOTE: The calling process must have a super-group user (255,*) process accessor ID to invoke
this procedure.
error := MEASMONCONTROL ( meascb ! i,o
,start ! i
,[ cpunum ] ); ! i
,[ errDetail ] ); ! o
error
INT:value
is the error code indicating the outcome of the operation. Possible error codes include:
DescriptionError Code
Successful completion.0
A required parameter was missing.err^missingparam3201
An invalid parameter address was supplied.err^bounds3202
A bad parameter value was supplied.err^badparams3203
The attempted call requires the super-group user ID (255,n).err^notsuper3217
Measure subsystem is already started and cannot be started again.err^monalreadyactive3218
Measure subsystem is not started and a stop request is sent.err^nomeasmon3219
If an error is returned from PROCESS_CREATE_ it will be returned in error. If the errDetail
parameter is specified, it contains any error detail information returned from
PROCESS_CREATE_.
meascb
input, output
INT:ref:$LEN(MEASCB^DEF) / 2
is a control block where the Measure subsystem stores data for subsequent procedure calls.
Before calling the first Measure procedure that uses meascb, you must allocate space in your
global data area for the control block and initialize each element of the control block to -1.
After you pass meascb to a Measure procedure, do not modify its contents.
The file $SYSTEM.SYSnn.MEASDECS contains the structure definition for the control block
descriptor (MEASCB^DEF).
start
input
INT:value
if specified as true, MEASMONCONTROL starts the Measure subsystem. If specified as false,
MEASMONCONTROL stops the Measure subsystem. When the Measure subsystem stops, all
measurements stop.
cpunum
input
INT:value
creates a measurement control process (MEASCTL) in the specified CPU. Any currently active
measurements automatically begin receiving information from the newly added CPU. This
parameter is applicable only if start equals true. Under normal operating circumstances,
MEASMONCONTROL 411