MNSR gate, SET_MONITORING function

The SET_MONITORING function of the MNSR gate is used to set the monitoring classes on or off and to change the monitoring options.

Input Parameters

COMPRESSION
Optional Parameter
Alters the monitoring record compression setting.
Values for the parameter are:
  • NO
  • YES
CONVERSE
Optional Parameter
Indicates if a transaction performance class record is to be produced for conversational tasks for each pair of terminal control I/O requests.
Values for the parameter are:
  • NO
  • YES
DPL_LIMIT
Optional Parameter
Indicates the number of distributed program links for which you want CICS to perform transaction resource monitoring. The value must be in the range 0 - 64.
EXCEPTION_STATUS
Optional Parameter
Indicates the exception class monitoring setting.
Values for the parameter are:
  • OFF
  • ON
FILE_LIMIT
Optional Parameter
Indicates the number of files for which you want CICS to perform transaction resource monitoring. The value must be in the range 0 - 64.
FREQUENCY
Optional Parameter
Is the interval for which monitoring automatically produces a transaction performance class record for any long-running transaction. Frequency times are 0, or in the range 000100 - 240000. The default frequency value is 0, which means that frequency monitoring is inactive.
MONITORING_STATUS
Optional Parameter
Indicates the monitoring status setting.
Values for the parameter are:
  • OFF
  • ON
PERFORMANCE_STATUS
Optional Parameter
Indicates the performance class monitoring setting.
Values for the parameter are:
  • OFF
  • ON
RESOURCE_STATUS
Optional Parameter
Indicates the transaction resource class monitoring setting.
Values for the parameter are:
  • OFF
  • ON
SYNCPOINT
Optional Parameter
Indicates if a transaction performance class record is to be produced when a transaction takes an explicit or implicit sync point (unit-of-work).
Values for the parameter are:
  • NO
  • YES
TIME
Optional Parameter
Indicates whether the monitoring time-stamp fields returned on the INQUIRE_MONITORING_DATA function are to be in GMT or local time.
Values for the parameter are:
  • GMT
  • LOCAL
TSQUEUE_LIMIT
Optional Parameter
Indicates the maximum number of temporary storage queues for which you want CICS to perform transaction resource monitoring. The value must be in the range 0 - 64.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LOOP
The following value is returned when RESPONSE is EXCEPTION:
  • INVALID_FREQUENCY
  • FILE_LIMIT_OUT_OF_RANGE
  • TSQUEUE_LIMIT_OUT_OF_RANGE
  • DPL_LIMIT_OUT_OF_RANGE
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


dfhs3_MNSRset_monitoring.html | Timestamp icon Last updated: Monday, 5 June 2017