HP 3000 Manuals HP 3000 Manuals
CONVERT
CONVERT {logfile}
This command converts one or more raw or extracted log files to the
current version's format. The MPE log file format was altered starting
with the B.00.nn release of Performance Collection Software. Earlier
versions of the log files are known as version A log files, whereas the
B.00.00 log files are version B log files.
Only forward conversion is provided. That is, you can only convert log
files of earlier releases to those of this release. Log files converted
to the new release or created under this new release cannot be converted
or accessed by earlier releases of HP LaserRX/MPE or the Performance
Collection Software.
You must be logged on to the same group and account, and have exclusive
write access to the log files in order to convert them.
CAUTION Your existing log files will be altered by the conversion
process. If you did not back up your log files when you
installed this release, you should back them up before you
convert them. See chapter 1.
If you try to access a version A log file with a version B program or
library you will receive error message 1005 (invalid log file version;
see "Introduction to UTILITY" in chapter 2).
To convert a raw or extracted log file, do either of the following:
CONVERT logfile
or
LOG logfile
CONVERT
You may receive the error message when the file is opened but before
conversion. If you try to convert an already-converted file, nothing
will happen.
During the log file conversion process, you must have exclusive access to
the log files. The SCOPE(XL) data collection program must be stopped
before converting raw log files, but before converting extracted log
files.
Since the UTILITY program runs on the HP 3000 system, the parent log
files of any log file downloaded to the PC should be converted on the HP
3000, then downloaded again. If the parent log file does not still exist
on the HP 3000, the log file can be uploaded from the PC if care is
taken to transfer BINARY data to a file with the proper MPE file
characteristics (file code, record size, blocking factor, etc.). Once
transferred back to the HP 3000, it can be converted then downloaded
again.
The conversion process makes a copy of the file during the conversion.
Be sure that sufficient disc space is available on the system before
performing a conversion.
NOTE You will need enough free disc space equal to the size of the file
being converted.
Raw log files always should be converted on the same type of system (MPE
V or MPE/iX) as they were created. Extracted log files can be converted
on any type of system.
The conversion process adjusts log file sizes without losing data. The
CONVERT command requires an open log file. If a log file is not opened,
you will be prompted to open one (in interactive mode) or the batch job
will terminate (in batch mode).
Sample CONVERT Task
In this sample task, an extracted log file is converted into a form
compatible with the current release of Performance Collection Software.
1. LOGFILE RXLOG
RXLOG is still in the old format. Error 1005 indicates that it is
an invalid version. RXLOG must be converted to the new format
before it can be opened.
2. CONVERT
RXLOG is converted to the new format.