Configuring a master LT

<ltname>

The LT name provided by SWIFT. Note that an LT name must fulfill the format rules of LT names according to SWIFT even if it is used for FMT FIN only. In particular, a zero (0) is not allowed as LTID at the 9th position of the LT name.

DefaultLTConn <connectionNumber>

Two-digit number of the initial LT connection for this LT, for example, 01. When the SFD first connects to an SAG, it concatenates the name of the LT with this number. The resulting name, for example, XXXXDEFFA01, must denote a CO of type DnfLTConn, which represents a connection between an LT and an SAG. To create a CO of type DnfLTConn, see Configuring a connection between a master LT and an SAG.

DefaultQMgr <defaultQM>

Queue manager on which the SFD is started, for example, the local queue manager. If you do not want to start the SFD on a dedicated queue manager, deactivate the add command for this attribute by placing a semicolon (;) at the beginning of the corresponding line of the script.

DefaultProtocolVersion <protocolVersion>

The number of the FIN protocol version that is to be used if the login command is entered without the -pv parameter. The only valid value is 3. This is the default.

FSMInstanceDir <instanceDirectory>

The FSM instance directory, in which FTM SWIFT stores temporary files used by an SFD such as shared memory handles and trace files. This is the directory that you created in step 1. Its name is:

/var/ftmswift_v300/run/fsm

Do not specify a slash (/) at the end of the directory name.

InitialService swift.fin

The initial service is the SWIFT service to which an OPEN request from this LT is to be sent. It must be set to swift.fin for both live and pilot (also called "test and training" or "T&T") FIN traffic.

ResyncStartDelay <resyncStartDelay>

The initial delay in seconds before the SFD attempts to reestablish a failed connection. This value is often the same as the resyncWaitTime value, for example, 240.

ResyncWaitTime <resyncWaitTime>

The delay in seconds before the SFD attempts to reestablish a failed connection. You must specify a value in the range 20 - 300 (5 minutes).

ResyncMaxTime <resyncMaxTime>

The maximum duration in minutes during which the SFD makes consecutive attempts to reestablish a failed connection, for example, 60. You must specify a number in the range 1 - 60.

ResyncMaxNumber <resyncMaxNumber>

The number of consecutive attempts that the SFD makes to reestablish a failed connection, for example, 9. You must specify a number in the range 0 - 40.

If you specify 0, an attempt to reestablish the connection is not performed. You specify this value if you do not want to use RP User Synchronisation.

BatchingTimeout <batchingTimeout>

The maximum number of seconds that the SFD delays a SWIFT input message, or the acknowledgment of a SWIFT output message, before routing it to the SAG. Possible values are the numbers 01 through 99. The default is 02. The value you enter can be overwritten by SWIFT. This parameter is valid only for FIN Protocol Version 02 and later. Refer to note 4.d.

MaxBatchCount <maxBatchCount>

The maximum number of FIN application protocol data units (APDUs) that the SFD sends in a single data message. Possible values are the numbers 01 through 99. The default is 30. The value you enter can be overwritten by SWIFT. This parameter is only valid for FIN Protocol Version 02 and later. Refer to note 4.d.

MaxBatchSize <maxBatchSize>

The maximum size, in kilobytes, of the InterAct message that is used as a vehicle for outbound FIN messages. Possible values are the numbers 30 through 99. The default is 98. This parameter is valid only for FIN Protocol Version 02 and later. Refer to note 4.d.

SwitchOpenConfTO, SwitchSeqGapTO, and SwitchSignalTO

These pseudo attributes control under which circumstances the SFD switches to an alternative LT connection:

SwitchOpenConfTO

An open confirmation timeout, that is, if an open session confirmation message is not received from a FIN system within the sequence gap timeout value.

SwitchSeqGapTO

A sequence gap timeout, that is, if a sequence-number gap could not be resolved in time.

SwitchSignalTO

A signal timeout, that is, if no life signal message was received from a FIN system within the life signal frequency of 300 seconds plus the sequence gap timeout value.

If you do not want the SFD to switch to an alternative LT connection after detecting one of these types of timeouts, deactivate the add command for this attribute by placing a semicolon (;) at the beginning of the corresponding line of the script, like this:

;add -ou DNIvOU -ct DnfLT -co <ltname> -attr Switch...

If you define only one LT connection for an LT (see Configuring a connection between a master LT and an SAG), do not specify any of these pseudo attributes.

If you already specified one of these attributes and want to remove it, issue the remove command:

rem -ou DNIvOU -ct DnfLT -co ltname -attr Switch...

SLRetry

This pseudo attribute controls whether the Session Layer (SL) Retry protocol element is to be used for SL PDUs sent by the LT, but for which no success indicator was received. When using SL Retry, the sending LT attempts to retransmit an SL PDU until either the transmission, that is the sending of the request plus receiving of a null response, is successful or the retry time is exhausted. Only after the retry time is exhausted is the corresponding session aborted. The retry time is set by SWIFT to 180 seconds.

DefaultFINState <state>

The default of the -state parameter of the select command, which is described in select. This value is composed of three characters, each of which is an N or a Y, that specify the default select states and the LT-directed queue value for an LT:

• The first character specifies the select state for messages to be sent. If N is specified, the LT does not send any FIN messages to the SIPN in this session.
• The second character specifies the select state for messages to be received. If N is specified, the SIPN does not send any FIN messages to this LT in this session.
• The third character specifies the LT-directed queue value. If N is specified, messages from the LT-directed queue are not passed to this LT in this session.

The default is YYY.

DefaultFINWindowSize <windowSize>

The default of the -window parameter of the select command, which is described in select. The window size is the maximum number of FIN messages that can be sent or received in a FIN session before an acknowledgment is sent or received. The number you enter must be in the range 1 - 100. The default is 12.

DefaultDeliverySubsets <deliverySubsets>

The default of the -delivery parameter of the select command, which is described in select. The value you specify is a single string of up to 180 characters. Because each delivery subset is a 6-character substring within the specified string, the length of the specified string must be a multiple of 6, and you can specify a maximum of 30 delivery subsets. The default is SYSTEMURGENTNORMAL.

LTGroup <LTGroup>

The name of the LT group to which this LT belongs. If you do not want the LT to belong to an LTGroup, do not remove the comment symbol (;) from in front of the corresponding add statement.

The LTs in an LT group can share their message processing workload. All LTs within an LT group must have the same destination (BIC8). For more information, see Configuring LT groups.

send

If an LT is to be used to send FIN messages to the SIPN, this attribute is required to ensure that access control functions properly.

Queue <applicationQ>

If an LT is to be used to receive FIN messages from the SIPN, this attribute specifies the IBM® MQ queue into which FTM SWIFT is to place the FIN messages it receives. MERVA ESA or a FIN application retrieve the messages from this queue.

QueueManager <applicationQM>

If an LT is to be used to receive FIN messages from the SIPN, this attribute specifies the queue manager of the application queue (that is, the queue specified for the Queue attribute).

Note: If the application queue is a cluster queue, do not configure a queue manager for the CO of type DnfLTApplicationSettings. Instead, place a comment character (;) at the beginning of the corresponding line of this script. To remove a queue manager that was already configured, issue the following command on a single line after the INST1.SYSOU.DNI_SYSADM> prompt:

rem -ou DNIvOU
    -ct DnfLTApplicationSettings
    -co ltname
    -attr QueueManager

ExceptionOptionSet <exceptionOS>

The name of the exception option set that this LT is to use to determine which error queues it is to use. For more information, see Configuring exception queues for FIN messages.

UETRGenerate

This attribute controls whether the DNF_ILC_FIN message flow automatically performs the following tasks if mandatory field 121 is missing in a FIN message:

• Generate unique end-to-end transaction reference (UETR)
• Add field 121 containing the generated UETR

The default is true. If you want to disable this behavior, configure value false for the attribute.

UETRResponse

This attribute controls whether message flows DNF_ILC_FIN and DNF_ILS_ACK provide the content of field 121 in the UETR field of the response message that is passed to the reply-to queue specified by the sending application. The default is true. If you want to disable this behavior, configure value false for the attribute.

dnicli -i instance -ou SYSOU -s DNI_SYSADM -cft ou_dnfcfcco.cli -cp IBM-1047

dnicli -i instance -ou SYSOU -s DNI_SYSADM
app -ou ou
dep -ou ou

dnicli -i instance -ou SYSOU -s DNI_SYSADM
app -ou DNFSYSOU
dep -ou DNFSYSOU

If dual authorization is enabled, another user with the appropriate access rights must approve the changes before they can be deployed. If dual authorization is disabled, you can skip approving the changes and immediately deploy them.