Setting server connection options

About this task

z/OS Extensions provides a Windows environment variable, RCC_CONNECT_RETRY_TIMES, that you can use to retry a connection to the Remote Build server when the server is busy. If you find that the connection to the Remote Build server times out when you issue the rccbuild command from a Windows client, you can adjust the RCC_CONNECT_RETRY_TIMES environment variable to increase the number of retry attempts. This environment variable can be set at the system level or the user level.
Note: On platforms other than Windows, the default retry time is 1. You must specify the environment variable RCC_CONNECT_RETRY_TIMES to enable it. For example, you can add export RCC_CONNECT_RETRY_TIMES=5 into your profile or system profile when you are using BSHELL.

Procedure

To set the RCC_CONNECT_RETRY_TIMES environment variable on Windows:
  1. On the Start menu, right click My Computer and select Properties.
    The System Properties window opens.
  2. On the Advanced tab, click the Environment Variables button. to open the "Environment Variables" dialog
    The Environment Variables window opens.
  3. To add or modify the System or User environment variables, do these steps:
    1. To add the RCC_CONNECT_RETRY_TIMES variable, click the New button under the User or System variables pane. In the Variable name field type RCC_CONNECT_RETRY_TIMES and in the Variable value field type a value from 1 to 20.
    2. To modify the RCC_CONNECT_RETRY_TIMES variable, select the variable name in the User or System variables pane and click the Edit button. In the Variable value field type a value from 1 to 20.
    The default value is 10 on the Windows platform. This value is used if the environment variable is not set or if a nonnumerical value or nonpositive value is specified. The maximum value 20 is used if a number larger than 20 is specified.
  4. Log off Windows and log back on to enable the new value to take effect.