The inquire_monitoring_data call – IBM SC33-1683-02 User Manual

Page 365

Advertising
background image

expression

A valid assembler-language expression that can be expressed in 2
bytes.

name2

The name of a 2-byte source of point data

(Rn)

A register containing the point data in the low-order 2 bytes

RESPONSE and REASON values for MONITOR:

RESPONSE

REASON

OK

None

EXCEPTION

DATA1_NOT_SPECIFIED
DATA2_NOT_SPECIFIED
POINT_NOT_DEFINED
INVALID_DATA1_VALUE
INVALID_DATA2_VALUE

DISASTER

None

INVALID

None

KERNERROR

None

PURGED

None

Notes:

1. For more detail, refer to the explanation of RESPONSE and REASON in

“General form of an XPI call” on page 286.

2. ‘POINT_NOT_DEFINED’ means that the EMP you have specified was not

defined in the MCT.

3. ‘INVALID_DATA1_VALUE’ and ‘INVALID_DATA2_VALUE’ are most likely to have

been caused by provision of bad addresses; this causes a program check.

4. DATA1_NOT_SPECIFIED and DATA2_NOT_SPECIFIED mean that you have

not specified DATA1 or DATA2 respectively when the operation required them.
See the description of DATA2.

5. Any error response terminates processing of the EMP. Operations defined to

execute before the point of failure will have done so; later operations are
canceled.

The INQUIRE_MONITORING_DATA call

The INQUIRE_MONITORING_DATA function returns to the exit program the
performance class monitoring data that has been accumulated for the issuing task.

The DFHMNTDS DSECT that maps the data is of fixed format. Note that:

v

All the CICS system-defined fields in the performance records (including fields
that you have specified for exclusion using the EXCLUDE option of the DFHMCT
TYPE=RECORD macro) are listed.

v

No user-defined data fields are listed.

monitoring functions

Chapter 3. The user exit programming interface (XPI)

333

Advertising