DATAKEEPALIVE (FTP client and server) statement

Use the DATAKEEPALIVE statement to specify the data connection keepalive timer.

Results:
  • The DATAKEEPALIVE statement overrides the keepalive timer value that you configured in the PROFILE.TCPIP file.
  • The keepalive timer causes TCP/IP to send a keepalive packet on the data connection when the connection is idle for the length of time specified in the DATAKEEPALIVE statement. Keepalive packets prevent the data connection from timing out as a result of long periods of inactivity.
Server
Specifies how often the server sends a keepalive packet.
Client
Specifies how often the client sends a keepalive packet.

Syntax

Read syntax diagramSkip visual syntax diagram
   .-DATAKEEPALIVE 0---------.   
>>-+-------------------------+---------------------------------><
   '-DATAKEEPALIVE --seconds-'   

Parameters

seconds
The number of seconds of inactivity that passes before a keepalive packet is sent out on the FTP data connection. Valid values are 0 (DATAKEEPALIVE not used) or 60 - 86 400. The default is 0.

Rule: If you specify 0 seconds, the DATAKEEPALIVE timer is disabled, and the only keepalive packets that flow on the data connection are controlled by the interval for the keepalive packets that you configured in the stack.

Guidelines:
  • Use the DATAKEEPALIVE statement if the DSWAITTIME configuration option is a value other than 0.
  • Use the DATAKEEPALIVE statement for FILETYPE=JES transfers.

Examples

Use the following code to set the data connection keepalive timer to 60 seconds:

DATAKEEPALIVE 60

Related topics