This manual provides programmers with descriptions and examples of the KSAM XL file format and its accessing routines. The material is organized into nine chapters and two appendixes.
The "Introduction" describes the KSAM XL file, its indexing mechanism, and its standard recovery methods.
"Creating a KSAM XL File" describes different methods of creating a KSAM XL file. Standard commands have been adapted to create and load a KSAM XL file. Intrinsics are also available to create and open a KSAM XL file. The key characteristics of the file 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.
"Opening and Closing the File" describes the intrinsic opening and closing routines. Note that a KSAM XL file 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 file format.
"KSAM XL 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.
