Previous Topic: OPSH205I

Next Topic: OPSH215I

OPSH208W

Based on this information, the maximum utilization reached by the OSF TSL queue is &ACTPCT, threshold value is &THRPCT.

Reason:

The maximum number of commands that have been on the OSF TSL queue as a percentage of the maximum number of commands that the queue can hold, is higher than recommended. That is, the maximum utilization reached by the OSF TSL queue is too high. This queue is where CA OPS/MVS sends TSO commands to be executed in the OSF TSL servers. The OSF execution scheduler dispatches these commands to OSF TSL servers as the servers become available to process work. If the queue utilization reaches 100% and occurrences of message OPS4349S with RC=4 have been issued since CA OPS/MVS started, then CA OPS/MVS has had failures in attempting to send a command to an OSF TSL server because the queue was full. Requested automation commands have failed to be executed.

Action:

You have multiple options to decrease queue utilization:

  1. Decrease the value of parameter OSFTSLQADD if it is currently greater than 2.
  2. Increase the value of parameter OSFTSLQUE
  3. Increase the value of parameter OSFTSLMAX if it is currently lower than 30.

The first option would be to decrease the value of parameter OSFTSLQADD which is currently &VAR1. This parameter sets the threshold that CA OPS/MVS uses to determine whether more OSF TSL servers need to be started. When the number of commands in the OSF TSL execution queue exceeds the value of the OSFTSLQADD parameter, CA OPS/MVS starts another OSF TSL server unless the number of servers has already reached the value of the OSFTSLMAX parameter. If your preference is for CA OPS/MVS to make use of the maximum number of defined OSF TSL servers to process the command load, then this may be the best option for you. With more servers executing commands, the queue utilization can be expected to decrease. A reasonable new value for OSFTSLQADD would be to decrease it to &VAR2. It can be changed while CA OPS/MVS is active.

The second option for decreasing OSF TSL queue utilization is to increase the maximum number of commands that can be held in the queue. If your preference is to maintain, rather than increase, the number of CA OPS/MVS address spaces, then this may be the best option for you. A reasonable new value for OSFTSLQUE would be to increase the current value &VAR3 to &VAR4. This option requires a restart of CA OPS/MVS.

A third option is to increase the value of the OSFTSLMAX parameter which is currently &VAR5. If you are currently not using the maximum number 30 of defined OSF TSL servers to process the command load and prefer to not have longer command queues, then this option may be for you. That is, rather than further decreasing the value of parameter OSFTSLQADD or increasing the value of parameter OSFTSPQUE, a reasonable new value for the OSFTSLMAX parameter would be to raise it by one. With more servers executing the commands from the queue, the queue utilization is expected to decrease. OSFTSLMAX can be changed while the CA OPS/MVS is active.

You can start by lowering OSFTSLQADD and then alternate between adding one to OSFTSLMAX and reducing OSFTSLQADD again. OSFTSLQADD should never be lower than 2 and OSFTSLMAX cannot be greater than 30. If queue is still full, a larger queue size OSFTSLQUE is the last resort.

To modify the value of the parameters, use the OPSPRM function with the SET keyword, that is, OPSPRM('SET','OSFTSLQADD','&VAR6'), or OPSVIEW option 4.1.1. Rerun this health check after a few minutes to see if the OSF TSL queue utilization is decreasing. The OSFTSLQUE parameter can only be set at product initialization.