Example: configuring an SAG for a master LT

Table 1 shows the values used for this example.
Table 1. Sample values for an SAG used with a master LT
Information type Parameter description Parameter value
General information FTM SWIFT instance name INST1
SAG information SAG name SAG1
Message partner name XXXXUSNYA
Message partner type ClientServer
Message format Sag:RelaxedSNL
Certificate list name certlist1
LAU key name LAU42123
First half-key (hk1) 12qwertzuAsdrgt2
Second half-key (hk2) 8u8kjhU2339ikkut
IBM® MQ information Queue manager QM1
Local queue cluster SAGCLUS1
Queue prefix DNI
Server connection channel QM1.SAG1
Transport type TCP
Host name HOSTA
Port number of the queue manager 1415
LT information LT XXXXUSNYA
Because FTM SWIFT uses InterAct to implement its SIPN FIN service, both request and response queues are needed. If an LT is to be used by both client and server applications, request and response queues for both the client and the server side must be configured. These queues are:
Client request queue

FTM SWIFT naming schema: DNIvQPFX.DNFvLQCLUS

Example: DNI.SAGCLUS1

Client response queue

FTM SWIFT naming schema: DNIvINST.DNF_FSM_CNR.ltname

Example: INST1.DNF_FSM_CNR.XXXXUSNYA

Note: The client response queue for an LT is created automatically during its LOGIN processing and does not have to be configured.
Server request queue

FTM SWIFT naming schema: DNIvINST.DNF_FSM_SLS.ltname

Example: INST1.DNF_FSM_SLS.XXXXUSNYA

Note: The server request queue for an LT is created automatically during its LOGIN processing.
Server response queue

FTM SWIFT naming schema: DNIvQPFX.DNIvSRV.SERVER.RESPONSE

Example: DNI.SAG1.SERVER.RESPONSE

where in this example:
  • DNIvINST (FTM SWIFT instance name) is INST1
  • DNIvSRV (SAG) is SAG1
  • DNFvLQCLUS (local queue cluster) is SAGCLUS1
  • DNIvQPFX (queue prefix) is DNI
  • ltname (name of the LT) is XXXXUSNYA
Before you configure an SAG for a master LT:

To configure an SAG for a master LT:

  1. Start the SAG (see Starting the SAG).
  2. Open the CLI with the following parameters: 
    dnicli -i INST1 -ou DNFSYSOU -s DNFSAGCFG
  3. Configure the MQ connection. To do this, issue the amqc (addMQConnection) command: 
    amqc     -sag SAG1
         -qm  QM1
         -cid 1208
         -ch  QM1.SAG1
         -tt  TCP
         -cn  'HOSTA(1415)'
         -crq DNI.SAGCLUS1
         -srq DNI.SAG1.SERVER.RESPONSE
    This command configures the IBM MQ connection needed to transfer FIN messages between the SIPN FIN service and an SAG.
  4. Configure a certificate list. To do this, issue the ac (addCert) command: 
    addCert -cln  certlist1
        -cert cn=department-a,o=xxxxusny,o=swift
        -cert cn=department-a1,o=xxxxusny,o=swift
        -cert cn=department-a2,o=xxxxusny,o=swift
  5. Configure a LAU key. To do this, issue the alk (addLauKey) command: 
    alk -lkn LAU42123
  6. Specify the half-key values for a LAU key. To do this, issue the ulk (updateLauKey) command: 
    ulk -lkn LAU42123 
    -hk1 12qwertzuAsdrgt2 
    -hk2 8u8kjhU2339ikkut
  7. Configure a message partner. To do this, issue the amp (addMessagePartner) command: 
    amp   -sag  SAG1
      -mpn  XXXXUSNYA
      -type ClientServer
      -mfm1 Sag:RelaxedSNL
      -cln  certlist1
      -dfm  Sag:RelaxedSNL
      -lkn  LAU42123
      -mqha    (
               -name XXXXUSNYAP
               -qm   QM1
               -rqq  INST1.DNF_FSM_SLS.XXXXUSNYA
               -cid  1208
               -mex  180
               -con  MQFMT_NONE
               -env  With
               )
    This command configures the interface between the SIPN FIN service for a specific LT and the MQ Host Adapter running on the SAG workstation.
  8. Configure an SI endpoint. Issue the aep (addSiEndpoint) command: 
    aep   -sag  SAG1
      -epn  XXXXUSNYA
      -sep  XXXXUSNYA_FIN
      -mpn  XXXXUSNYA
      -spro Relaxed
      -cpro Advanced
    This command configures the routing. All inbound messages that refer to the SNL endpoint XXXXUSNYA_FIN are routed to the message partner XXXXUSNYA.
  9. To configure an additional LT, repeat the steps 7 to 8 with the appropriate values for the additional LT, and the business OU for which it is configured.
  10. Approve and deploy the SAG configuration by issuing the following commands: 
    app -sag SAG1
dep -sag SAG1
  11. Stop and restart the SAG (see Stopping and restarting the SAG).
  12. Issue the enable command (see enable) for the following SAG entities:
    • The MQ connection 'DnfMqConnection'
    • The message partner 'XXXXUSNYA'
    • The endpoint 'XXXXUSNYA'
  13. Set up SWIFTNet user and security information as described in Managing SWIFTNet users and SWIFTNet security.