Normally the ARC0815/ARC0825 and ARC0816/ARC0826 messages supply information on the performance of a backup or restore. The size and number of files and job variables transferred are output, plus the time required. When recording the time the wait time while the tape is mounted is not taken into account. The timer only runs while the save file ARCHIVE.SAVE.FILE is open.
A message is output for each ARCHIVE subtask. Examples:
ARC0815 SUBTASK '0' HAS TRANSFERRED '10' PAM PAGES FOR '1' FILES AND '3' JVS IN '4' SECONDS
ARC0816 SUBTASK '1' HAS TRANSFERRED '27' MEGABYTES FOR '1305' FILES IN '324' SECONDS
If the save times are unexpectedly long or problems are suspected in individual files or tape transition, additional performance statistics can help with problem diagnosis.
These performance statistics are requested with the PERFORMANCE-ANALYSIS=*YES operand of the statement for backup or restore.
The performance statistics are entered in a file for each subtask under the user ID SYSHSMS under the following name:
HSM.S.SYSHSMS<user-id><year><julian date><hour><min><secs>.STATS.<subtask-nr>
The component <user-id> in the name is only included for nonprivileged users.
Nonprivileged users can generate this file under the user ID SYSHSMS, but no access rights are set for them.
A new information line is written into the statistics file in the following cases:
when opening a save file ARCHIVE.SAVE.FILE
when closing the save file
at the start of backing up or restoring a new file
every 2 seconds when backup or restore takes place
The performance statistics thus provide a detailed overview of all the activities of a subtask. Among other things, the time required to back up or restore each file can be ascertained. To facilitate analysis of the statistical data by program, the individual fields are separated from each other by a separator character which can be freely defined when the statistical data is requested (the default is a semicolon). The structure of an information line is described in the table below.
Field | Position | Length | Value | Meaning |
Time stamp | 1 | 19 | YYYY-MM-DD HH:MM:SS | |
Separator 1 | 20 | 1 | ; | Separator |
Number of files | 21 | 11 | Number of files/paths processed so far | |
Separator 2 | 32 | 1 | ; | Separator |
Number of job variables | 33 | 11 | Number of job variables processed so far (always 0 in a UFS file isystem or Windows) | |
Separator 3 | 44 | 1 | ; | Separator |
Number of PAM pages or MBytes transferred internally | 45 | 20 | PAM pages with DMS files, MBytes with UFS or Windows; | |
Separator 4 | 65 | 1 | ; | Separator |
Number of xBytes transferred externally; | 66 | 11 | KBytes/MBytes/GBytes which have been transferred over the network with TCP/IP (external transfer) | |
Separator 5 | 77 | 1 | ; | Separator |
Unit for xBytes | 78 | 1 | ’1’ = K; ’2’ = M; ’3’ = G | |
Separator 6 | 79 | 1 | ; | Separator |
Name of the workstation | 80 | 48 | Name of the current workstation; | |
Separator 7 | 128 | 1 | ; | Separator |
Although the output of the performance statistics only increases the load slightly, it should not be used constantly in normal operation.
The performance statistics can be requested with the following statements (see the “HSMS Statements” manual [1]):
Statement | Function |
ARCHIVE-FILES | Archive files and job variables |
ARCHIVE-NODE-FILES | Archive node files |
BACKUP-FILES | Save files and job variables |
BACKUP-NODE-FILES | Save node files |
| BACKUP-FILE-VERSIONS | Save versions of files |
COPY-EXPORT-SAVE-FILE | Copy save file |
COPY-NODE-SAVE-FILE | Copy node save file |
COPY-SAVE-FILE | Copy save file |
EXPORT-FILES | Export files and job variables |
IMPORT-FILES | Import files and job variables |
MIGRATE-FILES | Migrate files |
MOVE-SAVE-FILES | Moving save or node save files |
RECALL-MIGRATED-FILES | Recalling migrated files |
| REORGANIZE-VERSION-BACKUP | Reorganization of version backup archive |
REPAIR-CATALOG-BY-EXCHANGE | Removing inconsistencies in migrated files using EXCHANGE |
REPAIR-CATALOG-BY-RESTORE | Repair inconsistencies in migrated files using RESTORE |
REPLACE-SAVE-FILE-BY-EXCHANGE | Replacing save file in the migration archive using EXCHANGE |
REPLACE-SAVE-FILE-BY-RESTORE | Replace save file in migration archive using RESTORE |
RESTORE-FILES | Restore files and job variables |
RESTORE-LIBRARY-ELEMENTS | Restore elements of a library file |
RESTORE-NODE-FILES | Restore node files |
UPDATE-EXPORT-SAVE-FILE | Update backup |
Table 8: HSMS statements supporting the use of perfomance statistics