ci-server-engineer/.claude/skills/portal-setup/tasks/read-setup-file.md
cliu 83af63ab53 R1.05 re-check batch 2: graphics, history, portal, system-management, items
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>
2026-10-08 19:29:15 +11:00

3 KiB
Raw Permalink Blame History

task version source status
Read a setup file (active settings and keyword help) R1.05 (first written for R1.03) 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 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:

$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:

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

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).