KeepAliveInterval (MQLONG)

This field specifies the value passed to the communications stack for keepalive timing for the channel.

The value is applicable for the TCP/IP and SPX communications protocols, though not all implementations support this parameter.

The value is in the range 0 through 99 999; the units are seconds. A value of zero indicates that channel keepalive is not enabled, although keepalive might still occur if TCP/IP keepalive (rather than channel keepalive) is enabled. The following special value is also valid:

    MQKAI_AUTO
    Automatic. This value indicates that the keepalive interval is calculated from the negotiated heartbeat interval, as follows:

    • If the negotiated heartbeat interval is greater than zero, the keepalive interval that is used is the heartbeat interval plus 60 seconds.
    • If the negotiated heartbeat interval is zero, the keepalive interval that is used is zero.

  • On z/OS, TCP/IP keepalive occurs when TCPKEEP(YES) is specified on the queue manager object.
  • In other environments, TCP/IP keepalive occurs when the KEEPALIVE=YES parameter is specified in the TCP stanza in the distributed queuing configuration file.

This field is relevant only for channels that have a TransportType of MQXPT_TCP or MQXPT_SPX.

This is an input field to the exit. The field is not present if Version is less than MQCD_VERSION_7.

Parent topic: Fields