Module for ISO_8583 9.6.June 2016 | Understanding and Using webMethods ISO8583 | Installing and Using Module for ISO_8583 | Configuring webMethods Module for ISO_8583 | Configure TCP/IP client | Receive ISO_8583 Messages | Configuring an ISO_8583 Port
 
Configuring an ISO_8583 Port
1. Open Integration Server Administrator if it is not already open.
2. Go to Security > Ports.
3. Click Add Port.
4. In the Add Port area of the screen, select webMethods/ISO_8583.
5. Click Submit. Integration Server Administrator displays a screen requesting information about the port. Enter the following information:
Field
Description
Port
The port on which Integration Server listens for ISO_8583 requests. For example, 6000.
Note:
If your Integration Server runs on a UNIX system, using a port number below 1024 requires that the server run as 'root.' For security reasons, Software AG discourages this practice. Instead, run your Integration Server using an unprivileged user ID on a high number port (for example 1024 or above) and use the port remapping capabilities present in most firewalls to move requests to the higher numbered ports.
Package Name
The name of the package associated with the ISO_8583 port. The default is WmISO8583.
When you enable the package, the server enables the port. When you disable the package, the server disables the port and the ISO_8583 port option is not visible on the Integration Server Administrator Add Port screen.
Important:
When you specify a package name other than the default value, the package associated with the ISO_8583 port must have package dependency set to either the WmISO8583 package, or to a package that is dependent on the WmISO8583 package. In this way you ensure that when the WmISO8583 package is disabled, the ISO_8583 port package will be also disabled.
For information about specifying package dependencies, see the webMethods Service Development Help.
Note:
If you replicate this package, Integration Server creates a port with this number and the same settings on the target server. If a port with this number already exists on the target server, its settings remain intact. Module for ISO_8583 will continue to work after it is replicated to another server.
Bind Address (optional)
The IP address to which to bind this port. For example, 10.60.25.217 or myiso8583.server.com.
Specify a bind address if your machine has multiple IP addresses and you want the port to use this specific address. If you do not specify a bind address, the server picks one for you.
Service
The name of the Integration Server service that the ISO_8583 listener invokes when it receives an ISO_8583 message through the TCP/IP transport. The default value is wm.estd.iso8583.tn.service:receive.
Note:
When you use a custom service, the input and output signature of the custom service should have ffdata (byte array) and schemeID (string) as input parameters and response as an output parameter (similar to the wm.estd.iso8583.tn.service:receive service). When the ISO_8583 Listener receives the ISO_8583 message, it sets the received content to the ffdata parameter and picks the response from the response output parameter. The listener sends this response as a ResponseMessage for the received message when you use the synchronous delivery mode.
Run service Synchronously
Specify whether Module for ISO_8583 sends a response synchronously or asynchronously. The default is No. Valid values:
*Yes Module for ISO_8583 sends a synchronous response using the same connection channel.
*No Module for ISO_8583 sends an asynchronous response through a new channel.
Run As User
The name of the Integration Server User that the ISO_8583 listener uses to invoke the service specified in the Service field. By default no user is specified in the field. To specify a user, click the icon and select a User Name from the Select User box.
6. Click Save Changes.
7. On the Ports screen, click Edit in the IP Access column to restrict the IP addresses that can connect to the ISO_8583 port as follows:
*Allow by Default. Set up the port to allow requests from all hosts except for ones you explicitly deny. Use this approach if you want to allow most hosts and deny a few. This is the default setting.
*Deny by Default. Set up the port to deny requests from all hosts except for ones you explicitly allow. Use this approach if you want to deny most hosts and allow a few.