dsseventview - DSS 6 | Data Source Solutions Documentation
Documentation: dsseventview - DSS 6 | Data Source Solutions Documentation
dsseventview
Usage
**dsseventview** [-<em>options</em>] [<em>hub</em>]
Description
Command dsseventview displays events and their results derived from the DSS_EVENT and DSS_EVENT_RESULT repository tables.
Options
This section describes all the options available for the dsseventview command.
| Parameter | Description |
|---|---|
| -bbegin_id | Display only events with event IDs newer than begin_id. Value begin_id must have one of the following formats:
|
| -Bbegin_updated | Display only events that were updated since begin_updated. Value begin_updated must have one of the following formats:
|
| -cchn | Display only events for channel chn. This option can be supplied multiple times. |
| -C | Display only the current event. This is either the earliest event with state ACTIVE or, if no such event exists, the latest event with state DONE, CANCELED, or FAILED. This option requires -j. |
| -eend_id | Display only events with the event IDs older than end_id. Value end_id must have one of the following formats:
|
| -Eend_updated | Display only events that were updated before end_updated. Value end_updated must have one of the following formats:
|
| -f | Follow mode. Displays events that get updated after dsseventview was invoked. Runs in an endless loop. If specific event IDs are specified with -i, then it terminates as soon as all of these events have state DONE. |
| -iev_id | Display only event with the event ID ev_id. This option can be supplied multiple times. |
| -jjob_name | Display only events for job job_name. This option can be supplied multiple times. |
| -lres_loc | Display only event results for location res_loc. This option can be supplied multiple times. This option requires option -r or -R. |
| -nres | Display only the latest event and the results where one of the results matches res. |
| -Nnum_events | Display only the number of events specified in num_events. This option displays only the latest events. For example, if -N5 is supplied, then it displays the latest 5 events. |
| -oofile | Write output to file ofile instead of displaying it. |
| -P | Display the repository events. |
| -r | Display results from the events. All results are shown except the ones starting with `_` (these are advanced/internal). |
| -Rres_patt | Display only event results with names matching the res_patt pattern. Value res_patt may contain alphanumerics and any of the symbols: `*`, `?`, `|`, `_`, and `-`. This option requires -r. To see all the results (including advanced/internal results starting with `_`), use -R *. |
| -sstate | Display only events with state state. Value state may be either of:
|
| -Sbodypatt | Display only events with contents of body matching the bodypatt pattern. Value bodypatt may contain alphanumerics and any of the symbols: `*`, `?`, `|`, `_`, and `-`. |
| -tres_tbl | Display the event results for table res_tbl. This option can be supplied multiple times. |
| -Ttypepatt | Display only events with event types matching the typepatt pattern. Value typepatt may contain alphanumerics and any of the symbols: `*`, `?`, `|`, `_`, and `-`. |
Example
To display all active refresh events for channel test_channel dated December 15, 2023, use the following:
dsseventview -b "2023-12-15T00:00:00.000Z" -e "2023-12-15T23:59:59.000Z" -c mychannel -s ACTIVE -T Refresh myhub
To monitor all compare events as they run, including their results, use the following:
dsseventview -f -T Compare myhub