cliu
83af63ab53
Full manual diffs (C50, R30, C60, L20, C40, L35, R10, R20, J10, L30, L50, P30, G10, C10) and read-only checks on the shared R1.05 test server where the permission system allowed them. Skills and summaries moved to R1.05. Issues ISS-092..129 (gaps 104-107, 114-115, 130-131 unused); ISS-074 closed (manual and software agree), ISS-091 corrected by ISS-119. version-differences: unlisted manual changes and installed-only changes. r105-verification: V5-V9 and new not-tested rows. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
69 lines
3 KiB
Markdown
69 lines
3 KiB
Markdown
---
|
||
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).
|