cliu/ci-server-engineer
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ci-server-engineer/.claude/skills/history-management/SKILL.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

4 KiB
Raw Blame History

name description
history-management CI Server R1.05 HISTORY Service and item history. Use when the user wants to store item values in history (item storage group, storage group item, Scan/Time, Event/Item, Event/Event, Direct, scan interval, averaging, quality codes, priority), set rollover interval, life time or retention of history, use aggregation (30 minutes, hourly, shift, daily, weekly, monthly, yearly maximum / minimum / average / integral / standard deviation / counter / differential summation, ithsag.sup, completion notification), read history (ITEM_HISTORY, GROUP_NAME, INTERPOLATION, ATTRIBUTE; from applications via ODBC, .NET API, RESTful API or pyTOOLS), load history from CSV (ithloahis), force a rollover, check storage groups and units (hisdbg, his_units, history files h*.his), repair or recover history (hisrep, hisrecover), or archive and retrieve history (has.sup, hasman, hasdbg, tape, DVD, disk archive). Sources IM 36K10L20-01EN, IM 36K10C40-01EN, IM 36K10L35-01EN.

History management (R1.05; first written for R1.03)

Re-checked for R1.05 on 2026-10-08 (read-only): the three manuals have no content change except IM 36K10C40 §4.2 (R1.04), which now lists the RESTful API and pyTOOLS for reading history from applications and drops the C API. The history setup files (has.sup, his*.sup, ith*.sup incl. ithsag.sup) and the dataset definitions HIS_GROUP_DF, ITEM_HIS_DF, ITEM_HISTORY, HIS_UNITS are the same as in R1.03 (compared with snapshots of the R1.05 test server; only the C interface source dsid_ihis_df.c of ITEM_HIS_DF changed, ISS-102). history_start.cmd and item_start.cmd (and their stop files) differ (ISS-100). Storage groups were not re-tested on R1.05: the server is shared, and a new group needs a CI Server restart (ISS-006).

Background: knowledge/manuals/IM36K10C40-01EN.md (storage group fields, types, aggregation, archive, reading history), IM36K10L20-01EN.md (history manager, files, hisdbg, utilities, archive administration), IM36K10L35-01EN.md (item history processes and setup files).

Rules:

  • Run system-check first; follow the user's chosen way of working.
  • Deleting a storage group, a unit or unknown files deletes history for good. Life time changes can delete old units at the next rollover. Only with the user's approval, and never on production data without a backup.
  • A new storage group stores nothing until CI Server is restarted (ISS-006): plan the restart with the user (admin).
  • has.sup / ithsag.sup / ith*.sup changes need admin rights and a restart: hand them to the user (skill portal-setup, task change-setup-file.md).
Task File Status
Create item storage groups (Event/Item, Scan/Time, Aggregation) and add items by quick load; remove them tasks/storage-groups.md verified (R1.03); R1.05: dataset definitions and setup files identical, not re-tested (shared server, needs a restart)
Read history with dssqld (ITEM_HISTORY, per group); aggregates tasks/storage-groups.md §4 verified (R1.03); R1.05 not re-tested
Load history from CSV (ithloahis); which time stamps are accepted skill system-management, task load-history.md verified (R1.03)
Check groups, units, clients, rollover with hisdbg tasks/history-checks.md verified (R1.03); R1.05 read-only options awaiting user verification (ISS-101)
Archive / retrieve, hasdbg C40 summary §4, L20 summary §5 from docs (no archive device)
Repair and recovery (hisrep, hisrecover, isfrename, hiswrn) L20 summary §4 from docs
Reading history from classes and reports C40 summary §5; reports: skill reporting verified for reports (R1.03, rql-interactive.md)
Reading history from applications: ODBC, .NET API, RESTful API (GetHistory, GetHistoryMultiTag), pyTOOLS (getItemHistory) C40 summary §5; ODBC and REST: skill data-access (L45 summary §1, §9); pyTOOLS: IM 36K10P40 §3.13 (no skill yet) from docs