reroute

Purpose

Each SAG is associated with a unique SNL ID. Each routing rule is associated with up to four SNL IDs. Only one of these SNL IDs is active at a time. Issue the reroute command to change the active SNL ID for all routing rules with the specified primary SNL ID and service. This routes the message and file traffic to a different SAG.

Because this command is always executed in synchronous mode, you receive a response only after the SAG attempts to execute the command. The response indicates whether the command was successfully executed.

Required access rights:
CT:  DnfSAGopcfg
CO: <SAG name>
attr: reroute
Predefined roles that provide required access rights:
SagOperator
Issue for OU: DNFSYSOU
Issue to service: DNFSAGOP

Format

Read syntax diagramSkip visual syntax diagramrerouterr-sagsag-totoSNLID-fromfromSNLID-srvservice-epfepf-pwdpwd

Parameters

-sag sag
Name of the SAG.
-to
Sets as the active SNL ID:
default
The default SNL ID.
primary
The primary SNL ID.
secondary
The secondary SNL ID.
toSNLID
The specified SNL ID. Traffic is rerouted to this SNL ID for all rules for which all of the following are true:
  • One the four SNL IDs of the rule is the SNL ID specified for the -to parameter.
  • The primary SNL ID of the rule is the SNL ID specified for the -from parameter.
  • The rule includes the specified service (if any).
-from fromSNLID
The ID of the SNL to which the traffic was previously routed.
-srv service
The SWIFTNet service containing the rules for which traffic is to be rerouted.
-epf epf
The common name of the site manager. This is the SWIFTNet user with the role 'SiteManager' for the service 'swift.rug'.
-pwd pwd
Password of the site manager's certificate.
-snl primarySNLID
Specifies the primary SNL ID. If no value is specified, the SNL ID associated with the SAG specified for the -sag parameter is used.

Examples

The following command, issued to an SAG at level Release 7 or later, sets the active SNL ID for all rules with the primary SNL ID snl12345 and the service swift.fin to snl99887. 
INST1.DNFSYSOU.DNFSAGOP>reroute -sag SAG3 -to snl99887 -from snl12345
                                        -srv swift.fin -epf so1 -pwd b7NugT4

For more information about the reroute command, see SWIFTNet Admin Services: Operational Interface.