The set_parameters call, Response and reason values for set_parameters, Monitoring xpi functions – IBM SC34-6814-04 User Manual

Page 383

Advertising
background image

RESPONSE

REASON

INVALID

None

KERNERROR

None

The SET_PARAMETERS call

SET_PARAMETERS allows you to set the activity keypoint frequency for the CICS
region.

SET_PARAMETERS

DFHLGPAX [CALL,]

[CLEAR,]
[IN,
FUNCTION(SET_PARAMETERS),
[KEYPOINT_FREQUENCY(name4 | (Rn) ),]]
[OUT,
RESPONSE(name1 | *),
REASON(name1 | *)]

This command is threadsafe.

KEYPOINT_FREQUENCY(name4 | *)

specifies the activity keypointing frequency of the CICS region.

Permitted values are 0, or any integer between 200 and 65535 inclusive.

name4

The name of a 4-byte location that contains the new frequency value.

(Rn)

A register that contains the new frequency value.

RESPONSE and REASON values for SET_PARAMETERS:

RESPONSE

REASON

OK

None

EXCEPTION

OUT_OF_RANGE

DISASTER

None

INVALID

None

KERNERROR

None

Note: For more detail, refer to the explanation of RESPONSE and REASON in

“Making an XPI call” on page 308.

Monitoring XPI functions

There are two XPI monitoring functions. These are the DFHMNMNX calls
MONITOR and INQUIRE_MONITORING_DATA.

DFHMNMNX calls cannot be used in any exit program invoked from any global
user exit point in the:

v

Dispatcher domain

v

Dump domain

v

Monitor domain

v

Statistics domain

v

Transient data program.

Chapter 3. The user exit programming interface (XPI)

361

Advertising