Using KSAM XL MPE/iX 5.0 Documentation
Using KSAM XL
Table of Contents
Using KSAM XL
Using KSAM XL : COPYRIGHT NOTICE
Ch 1. Introduction
KSAM XL File Format
Index Area
Data Area
Automatic Recovery
Ch 2. Creating a KSAM XL File
Creating the File With the BUILD Command
KSAM XL File Characteristics
Key Characteristics
First Record Number
REUSE Option
Language ID
OPTMBLK/DEFBLK Option
Sample BUILD Command
Specifying an Indirect File
Loading Data to a KSAM XL File
Modifying Existing File Specifications While Copying
Building a KSAM XL File Programmatically
Language ID
Flag word
Number of Keys
Key Parameters
Using Related Commands
Deleting a KSAM XL File
Renaming a KSAM XL File
Modifying File Attributes
Ch 3. Obtaining File Information
Displaying File and Key Information
Accessing File Information from a Program
Accessing Key Information From a Program
Accessing User-Defined Labels
Ch 4. Opening and Closing the File
Opening an Existing KSAM XL File
Using the HPFOPEN Intrinsic
Using the FOPEN Intrinsic
Opening a New File
Closing a KSAM XL File
Ch 5. Reading File Data
Sequential Access by Primary Key
Sequential Access by Primary and Alternate Key
Specifying the Record Number
Specifying a Key Value
Sequential Access by Partial Key Value
Random Access of a Single Record
Using a Key Value
Using the Relative Record Number
Using a Physical Record Number
Sequential Access in Physical Record Order
Shared File Access
Ch 6. Writing and Updating Record Data
Writing New Records
Updating Existing Records
Deleting a Record
Shared Access
Ch 7. Protecting the File and Its Data
Checking Error Information
Protecting Data When File Access is Shared
Writing Directly to Disk
Recovering from a System or Software Abort
Backing Up KSAM XL Files
Recovering from Index Corruption
Ch 8. Migration and Mixed Mode Processing
Similarities in KSAM File Features
Differences in KSAM File Features
Migrating KSAM Files
Mixed Mode Operation
Ch 9. KSAM XL Intrinsics
FCHECK
FCLOSE
FCONTROL
FERRMSG
FFILEINFO
FFINDBYKEY
FFINDN
FGETINFO
FGETKEYINFO
FLABELINFO
FLOCK
FOPEN
FPOINT
FREAD
FREADBYKEY
FREADC
FREADDIR
FREADLABEL
FREMOVE
FRENAME
FSPACE
FUNLOCK
FUPDATE
FWRITE
FWRITELABEL
HPFOPEN
Ap A. COBOL Intrinsics
Calling a KSAM Procedure
Filetable Parameter
Status Parameter
KSAM Logical Record Pointer
Shared Access
Sample KSAM File
CKCLOSE
CKDELETE
CKERROR
CKLOCK
CKOPEN
KSAM Logical Record Pointer (contd)
Sample KSAM File (contd)
CKOPENSHR
CKREAD
CKREADBYKEY
CKREWRITE
CKSTART
KSAM Logical Record Pointer (contd.)
Sample KSAM File (contd.)
CKUNLOCK
CKWRITE
Examples of KSAM File Access
Sequential Write
Sequential Read
Random Update
Ap B. BASIC/V Intrinsics
Overview
Calling a KSAM Procedure
Optional Parameters
Status Parameter
KSAM Logical Record Pointer
Shared Access
BKCLOSE
BKDELETE
BKERROR
BKLOCK
BKOPEN
KSAM Logical Record Pointer (contd)
Shared Access (contd)
BKREAD
BKREADBYKEY
BKREWRITE
BKSTART
BKUNLOCK
KSAM Logical Record Pointer (contd.)
Shared Access (contd.)
BKWRITE
Ap C. HP C/iX Example Program
INDEX
Index
MPE/iX 5.0 Documentation