The set_parameters call, Response and reason values for set_parameters, Monitoring xpi functions – IBM SC34-6814-04 User Manual
Page 383
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