---
name: item-engineering
description: >-
  CI Server R1.05 sections, items and sub-items. Use when the user wants to create or change
  sections, items or sub-items (integrator, min-max, pulse, rate-of-change), set limits,
  scale or value format, string item length, integrator time unit (integration granule),
  PIT filter, block or unblock items or sections, or understand item status and option flags
  (blk, off, uoff, ublk). Sources IM 36K10G10-01EN (Tutorial) and IM 36K10C10-01EN.
version: R1.05 (first written for R1.03)
---

# Item engineering (R1.05)

Re-checked on R1.05 on 2026-10-08: the dataset definitions `SECTION_DF`, `ITEM_DF`,
`SUB_ITEM_DF`, `STATUS_DF`, the item form (`JhmiItemDia.xml`) and `itm.sup` (integration
granule `itm_int_secs` = 1) are identical to R1.03. Only `ITEM_VAL` changed: it has three new
fields `ENG_UNIT`, `SCALE_HIGH_LIMIT`, `SCALE_LOW_LIMIT` (by their names the item's
engineering units and scale limits next to the value; not in any manual, values not yet read,
ISS-126). The R1.05 manuals now give the string
item maximum the software uses (200 bytes, ISS-124).

Background: `knowledge/manuals/IM36K10G10-01EN.md` (chapter 3). Bulk creation of sections and
items uses quick load files: skill `system-management`, task `load-remove-records.md`.
Reading and writing values: `system-management` task `read-write-item.md`.

Rules:
- Run the `system-check` skill first; follow the user's chosen way of working for any change.
- Names: `Section.Sub-section.Item`, max 255 bytes, no `:` or `.` inside a name, case insensitive.

| Task | File | Status |
|---|---|---|
| Sections, items, sub-items (integrator, min-max) by quick load | `tasks/sub-items.md` | verified (R1.03; R1.05 test server 2026-10-08: sample sections, items and sub-items loaded with 0 errors, min-max followed the level) |
| Integrator time unit (`itm_int_secs`) | `tasks/sub-items.md` | verified (R1.03); R1.05 file identical, not re-tested (setup-file change on a shared server) |
| Block / unblock an item; write to a blocked item | `tasks/block-item.md` | verified (R1.03); R1.05 re-test awaits a decision (ISS-129) |
| String items: length limit (1–200) and truncation | `tasks/string-items.md` | verified (R1.03); R1.05 limit checked in the data dictionary, writes not re-tested (ISS-129) |
| Item forms, limits, PIT filter, clamping, alarm tab, option bits, item statuses | `knowledge/manuals/IM36K10C10-01EN.md` §3–4 | from docs (form definition identical on R1.05) |
| Switch on alarming, ack type, delay/repeat, test and acknowledge alarms | skill `alarm-management`, task `item-alarming.md` | verified (R1.03) |
| CENTUM VP virtual test and HIS-TSE connection (new Tutorial ch. 14–15) | `knowledge/manuals/IM36K10G10-01EN.md` | from docs; not tested (no CENTUM VP, ISS-127) |