fmtreset

Purpose

Use this command to set the counters for the input sequence number (ISN), output sequence number (OSN), or both for a particular LT to the specified values. Because FMT FIN does not use session numbers, these cannot be reset; the session number is always 0000.
Note: To prevent DB2® insertion errors, before you issue this command it is imperative that:
  • The DNF_IAMS table is empty
  • The DNF_OAMS table contains no messages that are in process
  • The DNF_MSGS table is empty
To achieve this:
  1. Stop all traffic (both SIPN FIN and FMT FIN) to and from the LT.
  2. Wait until the LT has finished processing all FIN messages. To check this, periodically issue the query command with the query option m to the DNF_ILC_CMD service. For example, the response to the following command indicates that no OAMS messages are in process, but that the IAMS still contains 2 messages, and therefore is not yet empty: 
    INST1.BANKA.DNF_ILC_CMD>query -lt XXXXUSNYA -qo m

DNFH3555I Outbound messages in OAMS for LT 'XXXXUSNYA':
APC: queued= 0, in process= 0, acknowledged= 0
FIN: queued= 0, in process= 0, acknowledged= 2
Inbound messages in IAMS for LT 'XXXXUSNYA': 2
  3. After the IAMS is empty and the OAMS contains no in-process messages, delete the contents of the DNF_MSGS table manually.
Required access rights:
CT: DnfAccessControlFmtf
CO: <LT name>
attr: FMTRESET
Predefined roles that provide required access rights: DnfFmtOperator
Issue for OU: Business OU
Issue to service: DNF_PF_CMD

Format

Read syntax diagramSkip visual syntax diagramfmtresetfr -ltname -ltlt_name -isnisn -osnosn -isnisn -osnosn

Parameters

-ltname lt_name
Name of the LT for which the sequence numbers are to be reset.
-isn isn
The new input sequence number (ISN) of the LT. It must be a number that is not currently in use.
-osn osn
The new output sequence number (OSN) of the LT. It must be a number that is not currently in use.

Examples

To reset the input sequence number (ISN) for the LT XXXXUSNYA to 000010, enter: 
INST1.BANKA.DNF_PF_CMD>fmtreset -ltname XXXXUSNYA -isn 000010
To reset both the ISN to 000020 and the OSN to 000045 for the LT XXXXUSNYB, enter: 
INST1.BANKA.DNF_PF_CMD>fmtreset -ltname XXXXUSNYB -isn 000020 -osn 000045