---
task: Deploy, remove, export, validate and search displays; open them in the browser
version: R1.03
source: IM 36K10C50-01EN §1.5; IM 36K10R30-01EN §1.1, §4; practiced on CI-Eng-Sample 2026-10-01; sample operator HMI (8 displays) and validate test 2026-10-06
status: verified
---

# Deploy and check displays

No admin rights needed (`C:\Users\Public\Yokogawa\tls\wap`). `jwuiutl.cmd` is in `tls\com`
(on `PATH`); call it through `cmd` (`cmd /c "jwuiutl.cmd …"`).

## 1. Deploy / remove (sample scripts)

`examples/CI-Eng-Sample/displays/deploy_displays.cmd`: copies the 8 sample displays
(`CIENG_Header`, `CIENG_Overview`, … `CIENG_TankFaceplate`) to
`%TLS_WAP_PATH%\cfg\operatorInterfaces\DEPLOY\displays\` and runs
`jwuiutl.cmd -e HTML -i -f DEPLOY <name>` for each (HTML into
`%TLS_WAP_PATH%\mobileoperator\operatorInterfaces\DEPLOY\displays\`).
`remove_displays.cmd` deletes both files of each (close the displays in the Edit Module first).
Deploy after `load.cmd` so the items exist. Verified 2026-10-06: remove → 0 sample files left,
deploy → exactly the 8 XML + 8 HTML files.

For another display: copy `<name>.xml` into `DEPLOY\displays` and export it the same way.
Displays with symbols also need the symbol files in `DEPLOY\symbols`.

## 2. Validate (re-saves the validated files)

```
cmd /c "jwuiutl.cmd -d -v -i -l <scratch>\validate.txt"
```

Per display: `Validating <name>` then `Info: No problems found`, or `*** Validation failed for
display <name>:` with `Problem: <component>: Connected item is not found (<item>)`. Skipped:
`*** Display locked <name>` (open in the Edit Module or a stale `.lck`; `-u` unlocks — with
approval), displays saved by a newer version. `-vf` re-saves all displays — only with approval.

**`-v` also re-saves** (tested 2026-10-06: `jwuiutl -d -v -i -l … CIENG_Test` reported *No problems
found* and rewrote the file, 9 618 → 11 191 bytes: default values dropped, positions moved into
attributes - same content). Run it on copies, or redeploy the source files afterwards. On
2026-10-02 a validation of eight displays once hung on one of them and left `<name>.lck` and
`<name>.xml.tmp` (stop the `java` process, delete both files); not reproduced on 2026-10-06
(ISS-075).

## 3. Search

```
cmd /c "jwuiutl.cmd -d -m <term> > <scratch>\match.txt 2>&1"
```

CSV `Type, File, Component` per match; `-M` adds actions and properties. Use it before deleting
or renaming items to find the displays that use them.

## 4. Open in the browser (HTML display)

`http://localhost:8080/mobileoperator/?d=<display>` (`&l=<layout>`). The user logs in with a CI
Server user. The page shows the operator frame (menu, navigation buttons, alarm banner, status
line). To switch displays type the name in the display box and press Enter. To refresh, use the
display menu **View > Reload** (keeps the session) — **reloading the browser page ends the
session** and needs a new login. Check live values by writing a test value (`itmval -p`, test items only).

## Verified (2026-10-01)

Remove → deploy recreated both files; `-e HTML` output identical to the Edit Module's HTML;
validation of `CIENG_Tank` *No problems found* (also after a sample reload with new item ids —
but a stale `<itemId>` then shows 0 at run time, ISS-052);
search worked; browser showed live values. HTML trend without line: ISS-041 (cause and
workaround in `trend.md` §6).