query

Purpose

Use this command to display information about the status of an FMT FIN session for an LT.

For a description of the query information, see Displaying status information for an LT session.

Required access rights:
CT: DnfAccessControlFmtf
CO: <LT name>
attr: QUERY
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 diagramquery  -ltname -lt lt_name -qos -qom

Parameters

-ltname or -lt lt_name
The name (BIC9) of the LT.
-qo
The query option, which determines which information to display:
s
Display:
  • Information about the state of the LT session
  • The sequence numbers that were most recently used for ISN and OSN messages
This is the default.
m
Display:
  • The total numbers of outgoing and incoming messages that are in process for the LT
  • The numbers of outgoing and incoming messages that are in process for the LT and that are to be sent to or are being received from an LT associated with an FTM SWIFT instance that is different from that with which the specified LT is associated.

Examples

To display the status of the session for the LT XXXXUSNYA:
  • Entering the query command without specifying the query option (-qo) parameter, like this: 
    INST1.BANKA.DNF_PF_CMD>query -ltname XXXXUSNYA
    produces output similar to this: 
    DNFP9414I FMT state of LT 'XXXXUSNYA' at 'Feb 8, 2016 3:16:22 PM'
Current states:    sending:   enabled and started
                   receiving: stopped

Sequence numbers:  ISN:       10
                   OSN:       14
  • Entering the query command Entering the query command with the query option m, like this: 
    INST1.BANKA.DNF_PF_CMD>query -lt XXXXUSNYA -qo m
    produces output similar to this: 
    DNFP9415I FMT FIN messages to be sent to or received from LTs of this instance:
- Outgoing messages in OAMS for LT 'XXXXUSNYA': 10
- Incoming messages in IAMS for LT 'XXXXUSNYA': 2
- Incoming messages in IAMS for destination 'XXXXUSNY': 0
    DNFP9425I FMT FIN messages to be sent to or received from LTs of other instances:
- Outgoing messages in OAMS for LT 'XXXXUSNYA': 12
- Incoming messages in IAMS for LT 'XXXXUSNYA': 3
- Incoming messages in IAMS for destination 'XXXXUSNYA': 9