The Set_Parameters Call; Monitoring Xpi Functions - IBM SC34-6814-04 Customization Manual

RESPONSE
INVALID
KERNERROR

The SET_PARAMETERS call

SET_PARAMETERS allows you to set the activity keypoint frequency for the CICS
region.
SET_PARAMETERS
DFHLGPAX [CALL,]
This command is threadsafe.
KEYPOINT_FREQUENCY(name4 | *)
RESPONSE and REASON values for SET_PARAMETERS:
RESPONSE
OK
EXCEPTION
DISASTER
INVALID
KERNERROR
Note: For more detail, refer to the explanation of RESPONSE and REASON in

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.
[CLEAR,]
[IN,
FUNCTION(SET_PARAMETERS),
[KEYPOINT_FREQUENCY(name4 | (Rn) ),]]
[OUT,
RESPONSE(name1 | *),
REASON(name1 | *)]
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.
"Making an XPI call" on page 308.
REASON
None
None
REASON
None
OUT_OF_RANGE
None
None
None
Chapter 3. The user exit programming interface (XPI)
361