FCOPY Reference Manual (32212-90008)

46 Chapter3
FCOPY Applications and Examples
Copying KSAM Files
Copying KSAM Files
If your system supports the KSAM/3000 subsystem, you can use FCOPY to copy KSAM
files. With some exceptions, you can copy KSAM files in the same way that you copy
regular HP 3000 files. The functions SKIPEOF, IGNERR, and SUBSET do not apply to KSAM
files. The KEY option applies to all KSAM files. The NOKSAM option applies only to KSAM
V/E and CM KSAM files. Refer to the KSAM/3000 Reference Manual (30000-90079) and
Using KSAM XL (32650-90168) for more information on using KSAM files.
Copying to Existing KSAM Files
To copy a KSAM V/E file or a CM KSAM file to another existing KSAM V/E or CM KSAM
file, use the FROM and TO parameters, with the value of the TO parameter as
tofile . For
example,
>FROM=KSAM1;TO=KSAMA
FCOPY copies the file in primary key sequence.
To copy a KSAM XL file to another existing KSAM XL file on an MPE XL system, use the
FROM and TO parameters, with the value of the TO parameter as tofile, a single file name.
For example,
>FROM=KSXL5;TO=KSXL6
NOTE You cannot use the NOKSAM option when copying KSAM XL files.
Copying to New KSAM Files
To copy an existing KSAM V/E or CM KSAM file to a new KSAM V/E or CM KSAM file,
include the names of the new KSAM V/E or CM KSAM data file and key file in the TO
parameter, as shown in the example below:
>FROM=OLDKSAM;TO=(NEWKSAM,NEWKSAMKEY)
To copy an existing KSAM XL file to a new KSAM XL file on an MPE XL system, include
the name of the new KSAM XL file in the TO parameter, as shown in the example below:
>FROM=OLDKSXL;TO=(NEWKSXL)
Copying from KSAM XL Files to CM KSAM Files
You can copy a KSAM XL file to a CM KSAM file on an MPE XL system using the FROM and
TO parameters as described under "Copying to Existing KSAM Files" above, with these
stipulations:
• You may not use the NOKSAM option.
• The tofile must be specified as a ( datafile,keyfile ) pair.
• The fromfile must be an existing KSAM XL file.