---
task: Export dataset contents with dssqld
version: R1.03
source: IM 36K10J10-01EN §2.9.2, §5.6; practiced on the test system 2026-09-30
status: 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.