This publication is the reference manual for KSAM/3000. KSAM stands for
Keyed Sequential Access Method, a method of accessing files indexed by
keys. KSAM/3000 operates on the HP 3000 Computer System.
The methods used to access a KSAM/3000 file differ depending on the
particular language used. A COBOL user, an RPG user, a BASIC user,
and an SPL user each has his own set of procedures with which to access
a KSAM file; a FORTRAN user can choose to access a KSAM file with
either COBOL or SPL procedures. All users can create, copy, purge, or
perform other utility functions with the KSAMUTIL and FCOPY programs.
This manual is organized so that the more general functions available
to all users are described in the first two sections followed by a
section describing KSAM access from each of the four languages:
COBOL, SPL, FORTRAN, and BASIC. Access to KSAM from a COBOL II program
is through COBOL II's indexed I/O Module and is not documented in this
manual. Access to KSAM files from an RPG program is not described in
this manual, but is included as part of the RPG manual:
RPG/3000 Compiler Application & Reference Manual (32104-90001,
Second Edition, 2/77)
In order to use this manual effectively, you should be familiar with
the MPE Operating System and with FCOPY. Also, it is assumed that you
are familiar with the language in which you are programming.
SECOND EDITION
The second edition of the KSAM manual provides the following new
information:
Full syntax for and description of how to use the new KSAMUTIL
commands: KEYSEQ, KEYDUMP, and KEYINFO. (section II)
Enhancements to the KSAMUTIL utility to allow abbreviated command
names, offline listing of displays, and entry of MPE commands from
KSAMUTIL. (section II)
Discussion of record pointer positioning in all languages; with
special emphasis on using the record pointers for shared access.
(sections III, IV, VI)
Description of how pointers are set internally. (appendix B)
Discussion of recovery procedures in case of system failure.
(appendix E)
In addition, there are minor corrections throughout the manual as well
as documentation of minor enhancements.
This edition covers the version of KSAM number A.02.04 release on the
1918 IT.