Suprtool Commands
Privmode
SET PRIVMODE ON | OFF
(Initially: ON)
Suprtool requires privileged mode to quickly scan IMAGE datasets. You can force
Suprtool to read a dataset using DBGET by turning Set Privmode Off, but Suprtool runs about five times slower. You must specify Set Privmode Off before using the
Base command. To enable fast serial reading, turn Set Privmode On and reopen the database with the Base command. This feature is intended for cases where bugs in
MPE are causing Suprtool to fail.
Progress
SET PROGRESS Percent [ number ] Minimum [ number ]
(Initial & Defaults: Percent 5, Minimum 10000 (MPE/V) 50000 (MPE/iX))
The Set Progress command is used to turn the Suprtool progress report feature on or off. The PERCENT value specified tells Suprtool by which percentage increment to report the progress messages of any given input or output phase. The allowed range for set progress is from 0 to 25, the default is every 5 percent. If the PERCENT parameter is not specified, then the next parameter is considered to be the PERCENT value. This is to remain compatible with some earlier pre-release versions of
Suprtool.
The MINIMUM value is the minimum number of records that an input file must have in order for the progress reports to be printed out. If the MINIMUM value is set to 15000, then the input file must have at least 15000 records or else progress messages are not printed out for the entire task. This value allows the user to turn off progress messages when reading smaller files. The default value for the Suprtool/V version of Suprtool is 10000 records, and the default value for the Suprtool/iX version of Suprtool is 50000 records. To always print progress messages, just set the minimum value to 0.
Suprtool does not produce any progress messages under the following conditions:
1. Set Progress is zero.
2. Output is to $stdlist via the Output * or List commands.
3. Chain command has been specified.
4. The number of records from the input source is less than the minimum value.
Suprtool checks whether or not to print a progress message at the end of each buffer
(for NOBUF/MR reads). Consequently, not all progress increments are reported for small files or datasets.
Suprtool reports the phase that it is in: whether input phase, sort phase, output phase or combined input/output phase (not sort).
The content of the progress messages is as follows:
•
Percentage complete
•
Phase and the total number of records processed
•
Delta-Sec(Min) - the time elapsed from the previous message
•
Wall-Sec(Min) - the total elapsed time
Suprtool 5.7 for MPE• 261
