HP 3000 Manuals HP 3000 Manuals
CKCLOSE
A call to CKCLOSE terminates file processing for the specified file.
CALL "CKCLOSE" USING filetable, status
When processing is completed, a KSAM file should be closed with a call to
CKCLOSE. No further processing is allowed on the file until a CKOPEN
procedure call opens the file.
CKCLOSE can be executed only for a file that is open.
PARAMETERS
filetable an 8-word record containing: the name of the file, its
input-output type, access mode, the filenumber given the
file when it was last opened, and a code indicating
whether the previous operation on the file was
successful and if so what it was. (Refer to Filetable
Parameter discussion earlier in this section.)
status one-word (two 8-bit characters) set to a pair of values
upon completion of the call to CKCLOSE. It indicates
whether or not the file was successfully closed and if
not, why not. The left character is set to "0" if
CKCLOSE is successful, to "9" if not. The right
character is set to "0" if CKCLOSE is successful, to the
file system error code if not. (Refer to Status
Parameter discussion earlier in this section.)
USING CKCLOSE
Upon successful completion of CKCLOSE, the file identified by filetable
is no longer available for processing. Note that a KSAM file can be
closed and then reopened in order to specify a different access mode or
input-output type.
EXAMPLES
Assuming the same filetable and status definitions used to define the
sample file in Figure 3-2:
FINISH.
CALL "CKCLOSE" USING FILETABLE, STAT.
IF STATUS-KEY-1 = "9" THEN
CALL "CKERROR" USING STAT, RESULT
DISPLAY "CKCLOSE ERROR NO. ", RESULT;
ELSE DISPLAY"CKCLOSE SUCCESSFUL".