HP 3000 Manuals

KSAM/3000 Reference Manual

FILETABLE PARAMETER 

The first parameter in every KSAM procedure call must be filetable, a
table describing the file and its access.  This table is defined in the
WORKING-STORAGE SECTION of the COBOL program.  It requires eight words as
illustrated in Figure 3-1.


          Figure 3-1.  Filetable Structure 

filenumber       A number identifying the file returned by the CKOPEN
                 procedure after the file named in words 2-5 has been
                 successfully opened.  After the file is closed by
                 CKCLOSE, filenumber is reset to 0.  (This number should
                 be set to zero when the file table is initially
                 defined.)  It must be defined as a COMPUTATIONAL item.

filename         The name of the KSAM file.  This name is the actual
                 designator assigned to the file when it is created with
                 the KSAMUTIL BUILD command; filename may be a formal
                 designator if it is equated to the actual designator in
                 a :FILE command.

input-output     A code that limits the file access to input only, output
type             only, or allows both input and output:
                   0 = input only
                   1 = output only
                   2 = input-output

                 It must be defined as a COMPUTATIONAL item.

access mode      A code that indicates how the file will be processed:
                 sequentially only, randomly only, or either
                 (dynamically):
                   0 = sequential only
                   1 = random only
                   2 = dynamic (sequential or random)

                 It must be defined as a COMPUTATIONAL item.

MPE/iX 5.0 Documentation