list (list events from event database table)

Purpose

Use this command to list events from the event database table according to the given filter criteria. If you do not specify any filter criteria, you see all the events of the OU on which the CLI is started. The events are listed sequentially from most recent to oldest. You cannot use wildcard characters with this command.

Required access rights:	CT: DniAEvent.list CO: DniAEvent.list attr: na
Predefined roles that provide required access rights:	DniEventAdmin
Issue for OU:	any OU
Issue to service:	DNI_A_EVENT

Format

Parameters

-dateFrom from_date

This parameter specifies the from date. Only events occurring on this date or later are considered. The default is the beginning of time, unless -timeFrom is specified, in which case the default is today's date. The pattern of the date is locale-dependent. For a list of date formats, see Languages and regions.

-dateTo to_date

This parameter specifies the to date. Only events occurring on this date or earlier are considered. The default is today's date. The pattern of the date is locale-dependent. For a list of date formats, see Languages and regions.

-timeFrom from_time

This parameter specifies the from time. Only events occurring at this time or later are considered. The time zone is in Coordinated Universal Time (UTC). The default is 0 a.m. (midnight). The pattern of the time is locale-dependent. For a list of time formats, see Languages and regions.

-timeTo to_time

This parameter specifies the to time. Only events occurring at this time or earlier are considered. The time zone is in Coordinated Universal Time (UTC). The default is 0 a.m. (midnight). The pattern of the time is locale-dependent. For a list of time formats, see Languages and regions.

-me maxnum

Maximum number of events displayed. The default is 50.

-eid ID

Event ID, for example DNIP3081E. If omitted, all events are listed.

-tc

Type code. Possible values:

E: Eventual action or error.
I: Information.

If omitted, events of all type codes are listed.

-s sname

Service name. If omitted, events of all services are listed. For a list of services, see FTM SWIFT services.

-scn comp

Subcomponent name. If omitted, events of all subcomponents are listed. For a list of subcomponents, see FTM SWIFT services.

-sid ID

System ID. If omitted, the subscription applies to events from all systems. This can be one of the following names:

The name of a queue manager preceded by CP_, for example, CP_Q1A (only events issued by the message flows running in the message broker associated with this queue manager are listed)
The name of an SAG, for example, SAG1
The name of an LT preceded by SNF_, for example, SNF_XXXXUSNYA

-ou ou

The organizational unit (OU) of the events that are to be listed. If omitted, events for the current OU (that is, the OU specified for the dnicli command that was issued to start the CLI) are listed. Users must be authorized to list events of the specified OU.

-sk key

Search key. If omitted, events of all search keys are listed.

-bgrp bgroup

Business group. It groups the messages that belong to the same business transaction. If omitted, events of all business groups are listed.

-mgrp mgroup

Message group. It groups a set of messages that belong together, such as a request message and its corresponding reply message. It can also be used to group the messages that belong to the same business transaction. If omitted, events of all message groups are listed.

Examples

For example:

To list a maximum of 5 events with type code E (to indicate an error) that were issued between 20 January 2016 at 0:00 and 01 March 2016 at 0:00, enter:

INST1.BANKA.DNI_A_EVENT>list -dateFrom 01/20/16 -dateTo 03/01/16 -tc E -me 5

The command returns output similar to this:

DNIP3423E 1/15/06 11:13 AM SYSOU DNI_SYSADM Database access 'CALL CREATE_CT'
failed; SQLCODE: '-471', SQLSTATE: '55023'.
DNIP3423E 1/15/06 11:16 AM SYSOU DNI_SYSADM Database access 'CALL CREATE_CT'
failed; SQLCODE: '-471', SQLSTATE: '55023'.
DNIC1151E 1/8/06 9:54 AM SYSOU DNI_SAMPLE Access denied for sample service.
DNIC1151E 1/8/06 9:53 AM SYSOU DNI_SAMPLE Access denied for sample service.
DNIM5052E 1/7/06 11:48 AM SYSOU DNI_MONITOR No registration with queue
'DNIK.REPLY.TEMP.B8CB3C4CEC989585' and queue manager 'Q464'.

To list a maximum of 25 events with type code E issued by the timer service between 20 January 2016 0:00 and 22 June 2016 0:00, enter:
```
INST1.BANKA.DNI_A_EVENT>list -dateFrom 01/20/16 -dateTo 06/22/16 -s DNI_TIMER -tc E -me 25
```
To list all events generated by the SAG operation service, enter:
```
INST1.BANKA.DNI_A_EVENT>list -s DNFSAGOP
```

To list events for the LT XXXXUSNYA, enter:

INST1.BANKA.DNI_A_EVENT>list -sid SNF_XXXXUSNYA

To list events associated with errors that occurred on or before 10:00 GMT today for SAG1, enter:
```
INST1.BANKA.DNI_A_EVENT>list -sid SAG1 -tc E -timeTo "10:00 AM"
```

These examples assume that the language code is set to English and the region code to the United States. For a list of date and time formats, see Languages and regions.