COBOL Manual for TNS/E Programs (H06.03+)

Libraries and Utility Routines
HP COBOL Manual for TNS/E Programs—520347-003
13-71
COBOL_FILE_INFO_
COBOL_FILE_INFO_
The COBOL_FILE_INFO_ routine is for both the OSS and Guardian environments.
The COBOL_FILE_INFO_ routine is for these situations:
•
An application needs to perform some operation not defined in HP COBOL on a
file normally managed by the HP COBOL run-time routines. This application must
obtain the file system file number assigned when the file was opened.
•
An application can put the file-system file name of a file into an application-
generated error message.
As with any ENTER statement, you must either qualify the name COBOL_FILE_INFO_
with the library-reference ZCOBDLL or include a SEARCH directive specifying
ZCOBDLL to provide automatic resolution of the reference. The general form of the
ENTER statement to use COBOL_FILE_INFO_ follows.
library-reference
is a mnemonic-name associated, in the SPECIAL-NAMES paragraph, with either
ZCOBDLL or some other object file containing an object copy of
COBOL_FILE_INFO_.
file-name
is the COBOL name of the file in the FD entry.
ENTER COBOL_FILE_INFO_
"
USING
library-referenceOF
"
TAL
name-buffer
name-size
error
file-name
file-number
VST636.vsd