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.