cliu 1c3558c37c Complete phase 1 and build the CI-Eng-Sample project

Add verified system-management tasks (item read/write, quick load
records, history load, monitoring processes, consistency check, tuning
checks), the importable CI-Eng-Sample project with load/remove scripts,
the unlicensed 1-hour shutdown note, and the sample-project re-test
rule. Close ISS-002/003/004 and log ISS-005..007.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-09-30 14:01:33 +10:00

2.4 KiB

Raw Blame History

task	version	source	status
Export dataset contents with dssqld	R1.03	IM 36K10J10-01EN §2.9.2, §5.6; practiced on the test system 2026-09-30	verified

Export dataset contents (dssqld)

Read-only. Needs CI Server running. Works from a normal or elevated prompt.

Export a whole dataset

dssqld -e <output>.qli -d <DATASET> -c -l <listing>.lst

-d dataset name (e.g. ITEM_DF, STATUS_DF, LOCAL_NODE_DF, CLASS_DF, OBJECT_DF).
-c comma-separated output: first line is the field names, then one quoted row per record.
-l writes the result summary to a listing file.
-a also exports hidden fields.

The console (and listing) end with a summary; check Errors is 0:

Data set                   Recognized  Exported    Not found   Errors
ITEM_DF                    184         184         0           0

Find datasets and fields

dssqld -f -l dict.lst

Dumps the data dictionary: every dataset with its description and fields (name, type, length, description). Search it to find which dataset holds what, e.g. the version fields are in LOCAL_NODE_DF, HOST_NODE_DF and ENTERPRISE_SERVER_DF.

Useful datasets seen on R1.03

Dataset	Contents
`LOCAL_NODE_DF`	This node: name, number, version (`VERSION_MAJOR/MINOR/PACK`), licence state
`ITEM_DF`	Item definitions: full name, section path, description, limits, format, type, station, I/O address
`STATUS_DF`	Item status definitions: name, number, alarm state, priority, colour, mnemonic (e.g. 9 = NORMAL)

Filtered exports

Export only matching records with a filter file (IM 36K10L50 §3.6, verified 2026-09-30):

@SELECT
'GROUP_NAME = "CIENG_EVENT"'
@HIS_GROUP_DF

dssqld -e <output>.qli <filter>.qli [-c] -l <listing>.lst

@SELECT, then the filter in single quotes with strings in double quotes, then @<DATASET>. The filter applies only to the next dataset. Operators: =, !=, <, >, and.
Some datasets (e.g. ITEM_HISTORY, ITEM_VAL, ALARM_CHRONO) are not exported unless named explicitly (NO-EXPORT list in dssqld.sup).
ITEM_HISTORY returns nothing unless the filter names ITEM_NAME and a SAMPLE_TIME range (see load-history.md).
%TLS_DAT_PATH%\dss_export.qli is Yokogawa's own filter file for exporting all engineering definitions (dssqld -e out.qli dss_export.qli); it also shows @MACRO usage.

2.4 KiB Raw Blame History