ci-server-engineer/.claude/skills/history-management/SKILL.md
cliu d7e30fa46e Add reporting skill and DSS tools task
New skill reporting: REPORT Service checks, interactive RQL, report
definitions by quick load, file output devices. New task
system-management/dss-tools.md: DSS processes, dss.sup, quick load
directives, dssutl, DSS compiler syntax check.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 16:17:02 +10:00

2.7 KiB

name description
history-management CI Server R1.03 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), 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.03)

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
Read history with dssqld (ITEM_HISTORY, per group); aggregates tasks/storage-groups.md §4 verified
Load history from CSV (ithloahis); which time stamps are accepted skill system-management, task load-history.md verified
Check groups, units, clients, rollover with hisdbg tasks/history-checks.md verified
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; ODBC C40 summary §5; reports: skill reporting verified for reports (rql-interactive.md); ODBC from docs