Using KSAM/XL and KSAM 64 (32650-90886)

12
In This Book
This manual provides programmers with descriptions and examples of the KSAM XL and
KSAM 64 file formats and their accessing routines. The material is organized into nine
chapters and two appendixes.
The "Introduction" describes the KSAM XL and KSAM 64 files, their indexing mechanism,
and their standard recovery methods.
"Creating a KSAM XL or a KSAM 64 File" describes different methods of creating a KSAM
XL or a KSAM 64 file. Standard commands have been adapted to create and load a KSAM
XL or a KSAM 64 file. Intrinsics are also available to create and open a KSAM XL or a
KSAM 64 file. The key characteristics of the files are specified in command or intrinsic
parameters.
"Obtaining File Information" describes the LISTFILE command and two intrinsics that
access file and key characteristics of a KSAM XL file or a KSAM 64 file.
"Opening and Closing the File" describes the intrinsic opening and closing routines. Note
that a KSAM XL and KSAM 64 files can also be created at the time the file is opened.
"Reading File Data" provides various methods of accessing records both sequentially and
randomly using different intrinsics.
"Writing and Updating Record Data" provides the intrinsics that are used to write and
append records to a file. File updates and deletions are also described.
"Protecting the File and Its Data" provides several methods of maintaining file integrity
through error checking routines and regular file backups. Special information is provided
for protecting data when access is shared. This section also describes recovering from
system and software aborts and from internal file structure corruption.
"Migration and Mixed Mode Processing" offers migration strategies for transferring CM
KSAM files to an MPE/iX system and to the KSAM XL or KSAM 64 file formats.
"KSAM XL /KSAM 64 Intrinsics" provides all syntax and operation notes regarding the
use of the KSAM intrinsics.
Two appendixes provide COBOL 68 intrinsics and BASIC/V intrinsics that may be needed
for program maintenance. These intrinsics are not intended for use in new program
development. They are provided here only as a maintenance aid for COBOL 68 or BASIC/V
programs.