cliu
ef543cde20
- Summary of IM 36K10C10 (Engineering Module - I/O Processes), checked against dssana.sup, itm.sup and the default datasets - New skill authorization: users and authorization groups by quick load - item-engineering: string item limits (1-200, holds length - 1) and the integration granule (itm_int_secs), both tested on CI-Eng-Sample - CI-Eng-Sample: read-only authorization group CIENG_VIEWER - Closed ISS-001 (uoff/ublk option bits), ISS-010, ISS-019; new ISS-018, ISS-020 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1.3 KiB
1.3 KiB
task: String items: length limit and truncation
version: R1.03
source: IM 36K10C10-01EN §3.3.4; data dictionary (dssqld -f); practiced on CI-Eng-Sample 2026-09-30
status: verified
String items
A string item has a maximum length set when it is created (ITEM_DF.STRING_LENGTH).
| Rule | Value (verified) |
|---|---|
Allowed STRING_LENGTH |
1–200 (default 80); 201 is rejected with DSS-E-VAL_RANGE |
Audit trailing (AUDIT_INFO) |
no effect on the limit (200 loads with audit on) |
| Characters the item holds | length − 1 (length 100 holds 99) |
| Value that fits | stored, status 9 NORMAL |
| Value too long | cut to length − 1, status 12 OVERRANGED, no error from itmval |
The manuals disagree (Engineering Module: max 100; Tutorial: 168); the installed software
allows 200 (knowledge/issues.md ISS-019). Multi-byte characters take more than one byte.
Quick load (the section must exist):
@FIELDS
NAME,DESCRIPTION,ITEM_REP,STRING_LENGTH,AUDIT_INFO
@ITEM_DF
"<Section>.<Tag>","Status text","String",120,0
Write and read: itmval -p -n <Section>.<Tag> -v "text", itmval -g -n <Section>.<Tag>.
After a write, check the status: 12 means the text was cut.
The representation (type) and length cannot be changed on an existing item: remove and load it again.