HP 3000 Manuals HP 3000 Manuals
OVERVIEW
The program KSAMUTIL provides MPE capabilities that allow you to
manipulate KSAM files. With KSAMUTIL commands, you can create a KSAM
file, rename both the data and key files, save a temporary file as a
permanent file, clear all data from a file, purge a file, and verify the
contents and access history of an existing file.
The HP 3000 file copier, FCOPY, is adapted to copy KSAM files. FCOPY
allows you to copy from a KSAM file to another file (KSAM or non-KSAM),
in primary or alternate key sequence; to copy an entire file or a subset
of a file, and to copy either the data or key file.
The MPE commands :STORE and :RESTORE can be used with KSAM files to
transfer the files from disc to magnetic tape and vice versa.
The utility functions that can be performed on KSAM files are summarized
in Table 2-1.
Both KSAMUTIL and FCOPY are programs resident in the system library that
can be executed with the MPE :RUN command. When run in a session, each
program responds by issuing a greater-than (>) prompt. You may then
enter commands to control further operation of the program. Both
programs may be operated in batch mode as well as in a session. In batch
mode, the greater-than prompt is not required. :STORE and :RESTORE are
commands directed to the MPE command interpreter and can be included in
either a job or a session.
Table 2-1. Summary of KSAM Utilities
-----------------------------------------------------------------------------------------------
| | | |
| UTILITY | OPTION/COMMAND | FUNCTION |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| KSAMUTIL | >BUILD or >B | Create KSAM file consisting of a data file a|d key file.
| | | |
| |
| | | |
| | >ERASE | Clear contents of KSAM data file and reset k|y
| | | file pointers. |
| | | |
| |
| | | |
| | >PURGE | Remove KSAM file from system. |
| | | |
| |
| | | |
| | >RENAME or >R | Change name of KSAM key or data file to a ne| name.
| | | |
| |
| | | |
| | >SAVE or >S | Save session/job temporary KSAM file as a pe|manent file.
| | | |
| |
| | | |
| | >VERIFY or >V | Display information on current status of dat| and keys in KSAM file.
| | | |
| |
| | | |
| | >HELP or >H | Request description of KSAMUTIL commands. |
| | | |
| |
| | | |
| | >EXIT or >E | Exit from KSAMUTIL program. |
| | | |
| |
| | | |
| | >KEYSEQ or >KS | Check the sequence of any key (primary or al|ernate) in key file.
| | | |
| |
| | | |
| | >KEYDUMP or >KD | Display a formatted, structural key file dum|.
| | | |
| |
| | | |
| | >KEYINFO or >K1 | Display information on current status of key|file;
| | | in case of system failure, attempt recovery.|
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| FCOPY | ;KEY=keylocation | Copy KSAM file in key sequence by a key spec|fied
| | | by its beginning location in record. |
| | | |
| |
| | | |
| | ;NOKSAM | Copy contents of key or data file in consecu|ive
| | | (physical) order. |
| | | |
| | | If both these parameters are omitted, the da|a file
| | | is copied in sequence by primary key; the ke| file
| | | is established with all links maintained. O|her
| | | FCOPY options apply to KSAM files with minor|
| | | exceptions (refer to Table 2-4). |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| MPE | :STORE datafile, keyfile | Store KSAM data and key files from disc to |
| | :RESTORE datafile, keyfile | magnetic tape. |
| | | Restore KSAM data and key files from magneti|
| | | |
-----------------------------------------------------------------------------------------------