IBM Support

Retries are controlled by WTRETRIES and MAXRETRIES on Connect:Direct for z/OS. Here is what you should know.

Technical Blog Post


Abstract

Retries are controlled by WTRETRIES and MAXRETRIES on Connect:Direct for z/OS. Here is what you should know.

Body

When you are a C:D z/OS PNODE initiating a session to another node, retries will be attempted for a failed connection.

 

These Init Parms control how often and how many retries will occur.

WTRETRIES = hh:mm:ss – This is the time between retries (Default = 3:00). Processes in the timer retry queue (TI RE) will be attempted at the next WTRETRIES interval.

MAXRETRIES = number of retries – This is the maximum number of times that a retry will be attempted. This is a number in the range of 0-512 (Default = 7).

 

What happens when retries are exhausted?

When all retries are attempted, the process goes into the hold waiting connection queue (HO WC) with a SVTM105I where it will not be reattempted until a successful connection is made or manual intervention occurs.  

If there are multiple processes for the same node, only the first will retry. The others go into HO RH for Restart Held. They will start once another process for that node successfully starts.

 

Once the PROCESS is in HO WC, one of the following things will cause it to attempt execution:

1. The process is manually held, then released.

2. A connection is established by the remote node.

3. A different process submitted on this node successfully establishes a session to the remote node.

4, The Connect:Direct DTF is restarted.

 

Example:

WTRETRIES = 5:00

MAXRETRIES = 3

The first failure will go into a 5 minute wait until retry. If that retry fails, another 5 minutes elapses before the next retry. This will occur for up to 3 cycles, after which the process goes into the HO WC.

 

Additional information can be found here:

System Administration Guide

MAXRETRIES = number of retries

WTRETRIES = hh:mm:ss | 00:03:00

Process Recovery

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS4PJT","label":"IBM Sterling Connect:Direct"},"Component":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

UID

ibm11123485