---
task: Read a setup file (active settings and keyword help)
version: R1.05 (first written for R1.03)
source: IM 36K10R20-01EN §1, §3 (4th Edition, Feb. 2026); IM 36K10R10-01EN §4 (5th Edition, Feb. 2026); practiced on the test system 2026-09-30
status: verified (read-only) on R1.03 (2026-09-30, also compared in the Setup File Editor GUI); commands re-run read-only on the R1.05 test server 2026-10-08 with the same results; R1.05 editor GUI awaiting user verification (ISS-113)
---

# Read a setup file

Shows what the Setup File Editor would show, without opening it. Nothing is changed.

## Where

`%TLS_ROOT_PATH%\tls\sup\<name>.sup` (R1.03 test system:
`C:\Program Files (x86)\Yokogawa\CIServer\tls\sup`; R1.05 test server:
`C:\Yokogawa\CIServer\tls\sup`; about 200 files on both). The file list with descriptions is
what the Setup File Editor shows on start.

## Active settings

Lines that do not start with `!` are the settings in use:

```powershell
$f = Join-Path $env:TLS_ROOT_PATH 'tls\sup\wflidi.sup'
Select-String -Path $f -Pattern '^\s*[^!\s]'
```

Example result (`wflidi.sup`, installed defaults): `FLOW_CONTROL = 30`, `TIMER = 20`,
`SCAN_TIME = 0`, `RETRY_COUNT = 3`, `QUEUE_BUSY_LEVEL = 10`, `DUR_QUEUE_SIZE = 500`,
`NODE = -1, 1000, 0.1, 30`, `LOCK_TIMEOUT = 60` (same file and values on R1.05).

A keyword that has no active line uses the program's built-in default (see its help).

## Meaning of a keyword

Each keyword is described in a `!KEYWORD : …` block: label and unit (`!ARG1 = label,unit`),
type (`!KIND`), limits (`!OPTIONS`) and help (`!HELP`/`!KEYHELP`). Show the block:

```powershell
Select-String -Path $f -Pattern '^!KEYWORD\s*:\s*TIMER\b' -Context 0,10
```

For `TIMER` this shows label *Clear cache after*, unit *sec*, kind *number*, option *pos*.

## Tabs and description

```powershell
Select-String -Path $f -Pattern '^!(DESCRIPTION|TAB)\s*='
```

`!TAB` lines give the editor's tabs; a keyword belongs to the last `!TAB` above it.
Keywords before the first `!TAB` appear on a *General* tab in the editor (checked on
`wfla_display.sup`). Active values that differ from the `!DEFAULT` block show as Status
*Changed* in the editor.

## Notes

- Use the Setup File Editor tabs and labels when talking to the user; the keyword names are
  what is in the file. Keyword tables for the user-interface files are in
  `knowledge/manuals/IM36K10R10-01EN.md` §4.
- Trust the installed file over the manual. The alarm item/display relation file is
  `wfla_display.sup` (the manual says `wfla_displays.sup`), and some installed values differ
  from the manual's defaults (see `knowledge/issues.md` ISS-012 to ISS-015).
- Some files have no `!DESCRIPTION`.
- R1.05 (2026-10-08): `jwuiisg.sup` and `dur.sup` gained keywords (R10 summary §3–4,
  ISS-109 to ISS-112); `wfl*.sup`, `jwuiged.sup` and `jwuiaan.sup` are identical to R1.03,
  `jhmiset.sup` differs only in spacing. Two new `jwuiisg.sup` blocks end with
  `!ENDKEYWORD!` instead of `!ENDKEYWORD`; how the editor shows them is not yet checked
  (ISS-112).