Automatic recovery

For SendMsg, SendFile, and SnF FileReceived scenarios, you can configure an MSIF transfer service so that it automatically attempts to recover scenarios that encounter the following types of errors:

• A response to a request primitive is not received before the end of its timeout period.
• A received response primitive indicates an error in its SwGbl:Status field that the MSIF transfer service regards as being recoverable.
• The envelope of a received response primitive indicates an SAG status Sag:System.002.005 or Sag:System.002.006.
• SWIFT issues an event of type unknown or failed during a file transfer.
• For a SendFile scenario, the MSIF transfer service is not subscribed to receive SNL events from the SAG that is to be used.
• A SendFile or SnF FileReceived scenario encounters an error during an attempt to pass a file to or from an SAG using local file transfer (LFT), as described in File access.
• A SendMsg scenario that uses an SnF input channel encounters an error during an attempt to put a message into an SAG request queue.

Such errors are called recoverable errors.

When automatic recovery is to be used:

• The maximum number of times that the MSIF transfer service is to attempt to automatically recover a scenario is determined by one of the following recovery options, which can be specified separately for scenarios that use real-time and SnF delivery mode:

  MsgSndMaxRecoverCount

  For a SendMsg scenario that encounters a recoverable error while sending a message.

  FileSndMaxRecoverCount

  For a SendFile scenario that encounters a recoverable error while sending a file.

  FileRcvMaxRecoverCount

  For a FileReceived scenario that encounters a recoverable error while receiving a file.

  NotifSndMaxRecoverCount

  For a FileReceived scenario that encounters a recoverable error while sending a delivery notification.

  NotifRcvMaxRecoverCount

  For a NotifReceived scenario that encounters a recoverable error while receiving a delivery notification for a file transfer.

• The number of seconds that the MSIF transfer service is to wait between automatic recovery attempts is determined by one of the following recovery options, which can be specified separately for scenarios that use real-time and SnF delivery mode:

  MsgSndRecoverInterval

  For a SendMsg scenario that encounters a recoverable error while sending a message. For SendMsg scenarios that use the SnF delivery mode and an input channel, this applies only to the second and later recovery attempts; the first recovery attempt is made immediately.

  FileSndRecoverInterval

  For a SendFile scenario that encounters a recoverable error while sending a file.

  FileRcvRecoverInterval

  For a FileReceived scenario that encounters a recoverable error while receiving a file.

  NotifSndRecoverInterval

  For a FileReceived scenario that encounters a recoverable error while sending a delivery notification.

  NotifRcvRecoverInterval

  For a NotifReceived scenario that encounters a recoverable error while receiving a delivery notification for a file transfer.

If a recover command is issued manually before the maximum number of automatic recovery attempts is exhausted, the number of outstanding retry attempts is reset to the maximum.