Create a New Input Channel

Each BIC8 that is subscribed to at least one service working in store-and-forward mode has a default/generic input channel that is automatically created by SWIFT. The number of input channels should be limited and most users only use the generic input channel because, for most users, the messaging interface uses the same input channel for all traffic for the different services and applications.

However, if you want to create an additional input channel, a sample business process is provided with the Sterling B2B Integrator.

Note: Any additional input channel may be subject to SWIFT charges, so please contact SWIFT to avoid any unexpected charges.

To create a new input channel, only need to enable the SWIFTNet Server Adapter or SWIFTNet7 Adapter to start the SWIFTNet MEFG Server so it can forward the create request to SWIFT. You do not need to configure the SWIFTNet Server Adapter or SWIFTNet7 Adapter to use the input channel.

This is the sample business process you can use to create a new input channel for SWIFTNet 6.x:


<process name="SWIFTNetCreateInputChannel">
   <sequence name="SWIFTNetCreateInputChannel">
      <operation name="set user token">
         <participant name="SetUserToken"/>
         <output message="SetUserTokenMessage">
            <assign to="USER_TOKEN">admin</assign>
            <assign to="." from="*"></assign>
         </output>
         <input message="inmsg">
            <assign to="." from="*"></assign>
         </input>
      </operation>
      <!-- build Create request -->
      <operation>
         <participant name="SWIFTNetClientService"/>
         <output message="createInputChannelRequest">
            <assign to="." from="*"></assign>
            <assign to="authoriserDN">Put a value here</assign>
            <assign to="inputChannelName">Put a value here</assign>
         </output>
         <input message="inmsg">
            <assign to="." from="*"></assign>
         </input>
      </operation>
   </sequence>
</process>

This is the sample business process you can use to create a new input channel for SWIFTNet 7:


<process name="SWIFTNet7CreateInputChannel">
   <sequence name="SWIFTNetCreateInputChannel">
      <operation name="set user token">
         <participant name="SetUserToken"/>
         <output message="SetUserTokenMessage">
            <assign to="USER_TOKEN">admin</assign>
            <assign to="." from="*"></assign>
         </output>
         <input message="inmsg">
            <assign to="." from="*"></assign>
         </input>
      </operation>
      <operation name="Send CreateInputChannelSnFRequest">
      <participant name="SWIFTNet7ClientService"/>
      <output message="createInputChannelRequest">
            <assign to="." from="*"></assign>
            <assign to="authoriserDN">Put a value here</assign>
            <assign to="inputChannelName">Put a value here</assign>
         </output>
         <input message="createInputChannelResponse">
            <assign to="." from="*"></assign>
         </input>
      </operation>
      <operation name="Receive CreateInputChannelSnFResponse">">
      <participant name="SWIFTNet7ClientService"/>
      <output message="handleInputChannelResponse">
            <assign to="." from="*"></assign>
      </output>
      <input message="inputChannelOut">
         <assign to="." from="*"></assign>
      </input>
      </operation>

   </sequence>
</process>

To create an input channel:

  1. Edit the sample business process, SWIFTNetCreateInputChannel (for SWIFTNet 6.x) or SWIFTNet7CreateInputChannel (for SWIFTNet7), and supply the following parameters:
    • authoriserDN, which must have at least one RBAC role for store-and-forward.
    • inputChannelName, which must be composed of the following:
      
            inputChannelName = domain "_" component ["!" environment]
      

      The domain identifies the institution, (that is, the BIC-8 in lowercase text). The component allows identification of different input channels for a specified BIC-8, and you can choose this part of the name. The environment identifies whether the queue is used on ITB, Pilot, or Live, and uses the same naming conventions as the service name.

      Input channel names are always in lowercase text (for example, bankus33_system2!x).

  2. After you have finished editing, save the business process.
  3. Configure the SWIFTNet Client service and the SWIFTNet Server Adapter or SWIFTNet7 Adapter. You do not have to configure the SWIFTNet Server Adapter or SWIFTNet7 Adapter to use the input channel; instead, you can select False for Use Input Channel.
  4. Enable the SWIFTNet Server Adapter or SWIFTNet7 Adapter, which starts the SWIFTNet MEFG Server. Wait to ensure that the SWIFTNet MEFG Server is started.
  5. Execute the SWIFTNetCreateInputChannel (for SWIFTNet 6.x) or SWIFTNet7CreateInputChannel (for SWIFTNet7) business process to send the Create Input Channel request.
  6. Monitor the execution of the business process. If it is successful, you have successfully created your new input channel. To start using your new input channel, you must configure the SWIFTNet Server Adapter or SWIFTNet7 Adapter to use the new input channel name you just created and you must restart the SWIFTNet Server Adapter or SWIFTNet7 Adapter for the change to occur.