CA XCOM Data Transport Health Checks › XCOM_MAXTASK_LEVEL@stcname

XCOM_MAXTASK_LEVEL@stcname

Description

This check monitors the total number of tasks that are active within the CA XCOM Data Transport region. The purpose of this check is to provide an alert when the number of active tasks reaches a threshold percentage of the maximum allowed by the MAXTASK parameter. The default interval for this check is every 30 minutes.

Best Practice

The MAXTASK value should be set to a level that will not allow more concurrent transfers to run than there are system resources to support. It is necessary to ensure that sufficient system resources (particularly virtual storage) are available to enable the number of transfers specified by MAXTASK to run concurrently.

Parameters Accepted

This check accepts one parameter, THRESHOLD(nnn). The value specified in THRESHOLD(nnn) is used to determine how close to the MAXTASK limit the total number of active tasks can be before an exception is recognized. This parameter must be an integer in the range of 1 to 100. The default is THRESHOLD(80).

Reference

For information about tuning the MAXTASK parameter, see the chapter "Configuration Parameters."

Exception Message

XCMH513W The total number of active tasks within the CA XCOM Data Transport region has exceeded nnn% of the configured limit as specified on the MAXTASK parameter.

The MAXTASK configuration parameter limits the number of active tasks that are allowed in the CA XCOM Data Transport region at any given time. An exception condition is recognized when the active task level reaches a certain threshold percentage of that limit. The default threshold percentage is 80%. This threshold may be modified by specifying a different percentage via the "THRESHOLD(nnn)" parameter for this particular health check.

When a CA XCOM Data Transport region reaches the MAXTASK limit, additional file transfer requests are delayed and retried at a later time. This may result in unacceptable processing delays for new file transfer requests. The overhead required to manage this exception condition may degrade the overall performance of the CA XCOM Data Transport region and adversely affect its ability to complete existing file transfer requests.

For more information, see the chapter "Health Check Messages" in the CA XCOM Data Transport for z/OS Message Reference Guide.