query

Purpose

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

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

Required access rights:	CT: DNF_ILC_CMD CO: <LT name> attr: QUERY
Predefined roles that provide required access rights:	SWIFTNetFINOperator
Issue for OU:	Business OU
Issue to service:	DNF_ILC_CMD

Format

Parameters

-ltname or -lt ltname

The name (BIC9) of the LT.

-qo

A query option that determines which information is to be displayed:

a

The following information is displayed:

Information about the session
The protocol version, batch timeout, and other settings
The session layer sequence numbers

This is the default.

m

The following information is displayed:

The number of messages in process, both for outgoing and incoming. The outgoing messages are categorized as follows:
- Outgoing messages queued for processing
- Messages in process that were sent to the SIPN but for which an acknowledgement was not yet received
- Acknowledged messages that were not yet delivered to the application
If messages are in process but the LT is not logged in, you can use the reset command to allow these messages to be processed by other LTs in the same LT group.
If the LT is member of an LT group, the following information is also displayed:
- The number of outgoing FIN messages for the destination
- The name of the LT group
- For each LT that belongs to this group, the number of outgoing FIN messages
The number of incoming messages with recoverable signature verification errors that are awaiting reprocessing

s

Statistics related to FIN batching are displayed.

Examples

To display the status of the LT session for the LT XXXXUSNYA:

Entering the query command without specifying a query option (-qo), like this:

INST1.BANKA.DNF_ILC_CMD>query -ltname XXXXUSNYA

produces output similar to this:

DNFF4450I State of LT 'XXXXUSNYA' at 'Aug 2, 2009 8:20:52 AM'
FSM started at 'Aug 2, 2009 8:19:20 AM' on queue manager 'CSQ1'
using LT connection number: '01' with SAG: 'SAG1'
Current states:   AL: SELECTED   SL: OPEN

GPA Session 0461:
  Messages processed:              Sequence numbers:
    ISN:      1     ACK:      1      ISN:      1
    OSN:      0     ACK:      0      OSN:      0

FIN Session 0417:
  Window size:     12              State: YYN
  Messages processed:              Sequence numbers:
    ISN:    216     ACK:    204      ISN: 787494
    OSN:    108     ACK:    108      OSN: 531800

Protocol version: 02  Batch timeout: 02 count: 30 size: 00

Session Layer sequence numbers:
  USER:     19   SYS:     20.

Entering the query command with the query option m, like this:

INST1.BANKA.DNF_ILC_CMD>query -lt XXXXUSNYA -qo m

produces output similar to this:

DNFH3555I Outgoing messages in OAMS database for LT 'XXXXUSNYA':
APC: queued= 0, in process= 0, acknowledged= 0
FIN: queued= 265, in process= 30, acknowledged= 5
Incoming messages in IAMS database for ltname 'XXXXUSNYA': 7
DNFH3564I LT XXXXUSNYA FIN: 2 inbound messages failed signature verification.
DNFH3556I Destination XXXXUSNY: 900 messages
LT group 'USGROUP':
DNFH3557I LT XXXXUSNYA FIN: queued= 265, in process= 30, acknowledged= 5
DNFH3557I LT XXXXUSNYB FIN: queued= 288, in process= 12, acknowledged= 0
DNFH3557I LT XXXXUSNYC FIN: queued= 300, in process= 0, acknowledged= 0

Entering the query command with the query option s, like this:

INST1.BANKA.DNF_ILC_CMD>query -lt XXXXUSNYA -qo s

produces output similar to this:

DNFF4453I Detailed V2 statistics for LT 'XXXXDEFFA' at 'Apr 13, 2009 1:48:06 PM'
FSM started at 'Apr 13, 2009 1:47:20 PM'

Parameters:
  Batch timeout: 02 count: 30 size: 00

Statistics
  Average batching rates (send/receive): 24 / 24

  Flush buffer reasons:
    FIN batch size limit reached                 0
    FIN batch count limit reached               10
    FIN batching timeout                         6
    SWIFT command APDU (pending)                 2.