|
|
Current version: B.06
Note: SIU requires MPE/iX 6.0 Powerpatch 1 or higher.
The System Inventory Utility (SIU) is a tool(script) to aid
system managers better understand what files exist on their system. SIU
can scan all databases, files, groups, directories, and accounts,
accumulating disk usage, file code data, tracking the largest file,
group, account, etc. For Image databases jumbo sets are counted,
partial key index files are handled, DBE files are reported. Allbase
databases are also counted.
The script name is SIU (you can change this and other files names in the
script). SIU provides two parameters: 1) the name of the account(s) or
directories to scan -- wildcards permitted, multiple names must be
quoted to appear as a single argument, 2) the reporting detail level
desired. Help text is provided by entering ':siu ?'. To see summary
info for all accounts and directories on your system enter: 'siu @'. To
get the most detailed output use a level= parm of -1.
All errors, warnings, and basic progress are reported to a log file
named SIULOG, in the same group as from where the script is executed.
Errors and warnings are also displayed to $STDLIST. Since it is common
for this tool to take a long time to complete an entire system scan, it
may be desireable to periodically monitor the log file to ensure forward
progress. Approximately every 200 CPU seconds a progress entry is
written to the log file.
Samples can be found here.
The SIU tool consists of one CI script, one program binary (and its
source), and a simple ASCII file for mapping accounts to vendors. These
four files are tar'd here,
or available in bytestream Store-to-disk format here.
These archive files contain:
- SIU -- fixed, ascii MPE script file. If no customization is done,
this script needs to reside in a group with PM since the
accompanying program files, SIUDBP, requires PM.
- SIUDBP -- MPE NM program file, default location is the same
group the SIU script resides in. This program needs PM capability
to read database control files.
- SIUVEND -- fixed, ascii file that maps MPE account names to known
vendors, expected to be in the same group as the SIU script.
- SIUDBS -- fixed, ascii Pascal source file for the SIUDBP program
-- just FYI.
The SIU script is also available separately
here.
main changes since prior revision:
- detect many more vendor files based on filecode.
- changed default name of the script, vendor file, DB program,
and log file. Now: SIU=script name, SIUDBP=database program,
SIUVEND=account-vendor mapping file, SIULOG=logfile, SIUDBS=source
code for database program.
- detect multiple accessors to the SIULOG file and script.
Instructions:
download one of the following files (they all contain the same content):
to your workstation and transfer it to your e3000. NOTE: in ftp
use tenex or byte-by-byte transfer method. If using the Reflection
terminal emulator's binary method please ensure that the resulting file
is a fixed record width file, as restore-from-disk does not support
variable width files. Additionally, using a terminal emulator transfer,
the record width should be set to 256 bytes (;rec=-256,,f,binary), and
optionally the file code for the store-to-disk file can be set to 2501. I
think it is much simpler to use FTP's tenex transfer mode. FTP
transfers will result in a bytestream file on your e3000. This works
fine for both Restore-from-disk and tar.
un-pack the tar file from the shell as:
tar -xvopf siu.tar
un-pack the Store-to-disk file from the CI as:
file d=./siu.std;dev=disc
restore *d;@.@.@;local;show
move the SIU script to an MPE group with PM, as this group is
also where the SIUDBP DB program file is expected to reside, and this
program needs PM to open Image root files.
move the SIUDBP program to the same group as the SIU script.
move the SIUVEND, account-vendor mapping file, to the same group as
the SIU script.
If you have any questions or enhancement suggestions please contact
Jeff Vance.
last updated: 2006-04-07
|