ci-server-engineer/.claude/skills/system-management/tasks/export-dataset.md
cliu 070e578129 Add phase 0-1 knowledge and system skills
Summarize the Release Information (known issues) and System
Design/Management manuals, add the system-check and system-management
skills practiced on the R1.03 test system, and add the progress tracker,
issue register and a CI-Eng-Sample placeholder. CLAUDE.md now requires a
version check, asks once per conversation whether to work directly or
prepare files only, and treats the manuals as development-only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 13:07:37 +10:00

1.8 KiB

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

dssqld -e <output> <filter>.qli exports using a filter file with @<DATASET>, @FIELD and @SELECT keywords (IM 36K10J10 §5.6). The exact filter syntax is not yet verified; export the whole dataset and filter the CSV instead until it is.