Creating option-set groups

Some types of option-set COs can be formed into named groups:

File-receive option-set groups

During a FileReceived scenario, the contents of HeaderInfo, TransferInfo, and FileInfo fields in the corresponding FileAct primitive determine which of the file-receive option-set COs in the group is used. For more information, see File-receive option-set groups.

SAG MP option-set groups

SAG MP option-set groups can be used to address the following situations:

For traffic distribution when receiving a message or file,

During a real-time MsgReceived, FileReceived, or RespondDownload scenario, or when receiving a delivery notification for a real-time SendFile scenario, an SAG MP option-set group enables the SNL ID and MP specified in the inbound SAG message to determine which SAG MP option set is used. For more information, see Traffic distribution.

For receiving a delivery notification or system message for a SendFile or SendMsg scenario on a different MSIF transfer service than the one on which the SendFile or SendMsg scenario was processed

When receiving a delivery notification or system message for a SendFile or SendMsg scenario but the SendFile or SendMsg was processed on a different MSIF transfer service, an SAG MP option-set group enables the SNL ID and MP specified in the inbound SAG message to determine which SAG MP option set is used. For more information, see Traffic distribution.

For failover when sending messages or files (SAG switching)

During a SendMsg or SendFile scenario, an SAG MP option-set group provides a way for the MSIF transfer service to switch to a new SAG if the one that was tried first is not running. For more information, see Switching SAG MP option-set COs.

To enable an input channel to switch to a new SAG MP option set in case of errors

Specify an SAG MP option sets group for an input channel to enable that channel to use several SAG MP option sets and to automatically switch in case of errors.

To create an option-set group:

1. Identify which option sets are to belong to the group.
2. For each of the option sets in the group, specify the same name for its Group option:
   • The file-receive option with the name Group specifies to which group a file-receive option set CO belongs (see File receive options: FileReceiveOptions).
   • The SAG MP option with the name Group specifies to which group an SAG MP option set CO belongs (see SAG message partner options: SagMPOptions).
3. For an SAG MP option-set group, choose one of the option sets in the group to be the active option set of the group, then issue the set command for this option set as described in set.