Output from the piartool -al command
- Last UpdatedJan 13, 2023
- 2 minute read
- PI System
- PI Server
Output from the piartool -al command lists archives in reverse chronological order (newer data first). The output lists the primary archive first. The output shows the dates spanned by each archive. Archives cannot contain an overlap in dates. Unused archives have start and end times shown as Current Time. The output displays unused archives in random order.
The output shows the following information for every currently registered archive:
|
Label |
Description |
|
Used |
Percentage of archive records used. This is an estimate, as the calculation only considers empty records. |
|
Version |
Identifier of the archive's internal architecture. This label allows Data Archive to mount and upgrade archives from older versions of PI. |
|
ArcSetNo |
The archive set number. |
|
Corrupt |
PI Data Archive sets the flag when corruption is detected in the archive file. For more information, see Reprocess an archive in PI System Management Tools (SMT). |
|
Path |
Full path of the archive file. |
|
State |
Current condition of the archive. In piartool -al output, this is always 4, which means mounted and ready. All other states correspond to unregistered states, in which case the archive is not visible in piartool -al output. |
|
Type |
0 = Fixed, 1 = Dynamic. |
|
Write Flag |
1 = Archive is currently writable, 0 otherwise. |
|
Shift Flag |
1 = Archive is potentially a target for archive shift, 0 otherwise. |
|
Record Size |
Size in bytes of one record. This is always 1024. |
|
Count |
Number of records in the archive file. |
|
Add Rate |
Average number of overflow-records added per hour, over the archive lifetime. |
|
Offsets: Primary |
Start and end record numbers for primary records. The end record number is always half of the record count. |
|
Offsets: Overflow |
Start and end record numbers for overflow records. |
|
Annotations |
Number of annotations used and the maximum number available. The archive shifts when this number is reached. |
|
Start Time |
Start date and time of the registered archive. |
|
End Time |
End date and time of the registered archive. |
|
Backup Time |
Last time the registered archive was backed up. See PI Data Archive backups for more information. |
|
Last Modified |
Date and time the registered archive was last modified. |