HP 3000 Manuals HP 3000 Manuals
CONVERT
Converts files from USASCII or KSAM to TSAM format or from TSAM to
USASCII format.
Syntax
CON[VERT] filename1[version designator] [|TO| filename2]
[UN[NUMBERED]]
Parameters
Filename1 Is the name of the USASCII, KSAM, or TSAM file to be
converted.
Version Applies only to TSAM formatted files. Allows you to
Designator specify the version of the TSAM file you are converting.
If no version is specified and the from file is owned,
the LATEST version will be assumed. If the from file is
not owned or is used, the REFERENCE version will be
assumed.
The Version Designator takes the form #n, where n is an
integer, L[ATEST], or R[EFERENCE].
Filename2 The destination file. If this filename is omitted,
filename1 will be converted into a temporary file. When
the convert is complete, filename1 will be purged and
the temporary file will be renamed to filename1.
UNNUMBERED Can be used only with TSAM files and creates an
unnumbered MPE XL file.
Description
MPE XL File Conversion
If the MPE XL file you are converting has a COBOL format file code or
sequence numbers in the first six characters, the TSAM file will be
created as a COBOL file with a record size of 74 bytes. Otherwise,
TOOLSET/XL will check the last eight bytes of the record. If they
contain only numbers, they will be used as the edit sequence numbers. If
the last 8 bytes contain characters other than numbers, TOOLSET/XL will
consider the file unnumbered and assign sequence numbers.
Before the new TSAM file is built, the SET EDIT menu will be displayed to
enable you to override any of the default attributes.
Record Size
The default record size for non-COBOL files will be equal to the record
size of the old file if it was not numbered. If the old file was
numbered, the default record size will be equal to the old record size
minus 8. COBOL files will always default to 74 byte records.
File Size
The default file size is one and one half times the number of records in
the old file, rounded up to the nearest 100. You should not decrease the
file size by more than one third. Otherwise, the file will not be large
enough to hold all of the converted records.
TSAM File Conversion
When converting a TSAM file to a USASCII file, you can specify a file
equation for the USASCII file to define your own record size, blocking
factor, file code, etc. The file equation must specify the fully
qualified USASCII file name. If no file equation is specified, the new
USASCII file is built with a record size equal to that of the TSAM file
plus the sequence number length. The file size is then equal to the
active records in the TSAM file, and the blocking factor is calculated to
maximize the use of the storage space.
Example
(1) >>CONVERT SSFILE#4 TO TTFILE
Converts version 4 of the TSAM file SSFILE to the USASCII file TTFILE.
SSFILE will be left unchanged.
(2) >>CONVERT THISFILE
Converts the file THISFILE from one format to another. When finished,
the file will exist only in the new format.