DSWAITTIMEREPLY (FTP server) statement

Use the DSWAITTIMEREPLY statement to specify how often to send the following reply message to the client while the FTP server is waiting for access to an MVS™ data set.
125- Data set access will be retried in 1 minute intervals - number attempts remaining
Results:
  • The server always issues the following reply at one-minute intervals while waiting for access to a data set for the amount of time specified by the DSWAITTIME configuration option.
    125- FTP Server unable to obtain usage use of data set 
    which is held by asid jobname accessmode on qname
    By default, the server also sends the following reply to the client at one-minute intervals.
    125- Data set access will be retried at 1 minute intervals - number attempts remaining

    Set the DSWAITTIMEREPLY value to a number smaller than 60 to cause the server to send this reply more frequently.

  • The DSWAITTIMERREPLY value is applied only when you have configured a DSWAITTIME value that is greater than zero.

Tip: Coding a DSWAITTIMEREPLY value that is smaller than 60 can prevent an FTP client connection from timing out while the server is waiting for a data set.

Syntax

Read syntax diagramSkip visual syntax diagramDSWAITTIMEREPLY 60DSWAITTIMEREPLYseconds

Parameters

seconds
The number of seconds between reply messages that the server sends to the client while it is waiting for access to an MVS data set. The valid range is 15 - 60. The default value is 60. The reply message that is sent:
125- Data set access will be retried at 1 minute intervals - number attempts remaining

Examples

In this example, the DSWAITTIMEREPLY value is 30. The following reply message is issued every 30 seconds:
125- Data set access will be retried at 1 minute intervals - number attempts remaining
If the DSWAITTIMEREPLY value is 30, the following would be the actual output:
125- FTP Server unable to obtain EXCLUSIVE use of
USER.TEST.DATA which is held by: 0035 USER2
EXCL on SYSDSN
125- Data set access will be retried in 1 minute
intervals - 3 attempts remaining
125- Data set access will be retried in 1 minute
intervals - 3 attempts remaining
125- FTP Server unable to obtain EXCLUSIVE use of 
USER.TEST.DATA which is held by: 0035 USER2
EXCL on SYSDSN
125- Data set access will be retried in 1 minute
intervals - 2 attempts remaining
125- Data set access will be retried in 1 minute
intervals - 2 attempts remaining
125- FTP Server unable to obtain EXCLUSIVE use of
USER.TEST.DATA which is held by: 0035 USER2
EXCL on SYSDSN
125- Data set access will be retried in 1 minute
intervals - 1 attempts remaining
125- Data set access will be retried in 1 minute
intervals - 1 attempts remaining
125- FTP Server unable to obtain EXCLUSIVE use of
USER.TEST.DATA which is held by: 0035 USER2
EXCL on SYSDSN
125 Data set USER2.TEST.DATA is not available

Related topics