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

Libraries and Utility Routines
HP COBOL Manual for TNS/E Programs—520347-003
13-69
COBOLFILEINFO
COBOLFILEINFO
The COBOLFILEINFO routine is for the Guardian environment. In the OSS
environment, use the COBOL_FILE_INFO_ routine.
The COBOLFILEINFO 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 COBOLFILEINFO
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 COBOLFILEINFO 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
COBOLFILEINFO.
fd-name
is the COBOL name of the file in the FD entry.
ENTER COBOLFILEINFO
"
USING
library-reference
fd-name
OF
TAL
error-code
file-name
file-number
ns
"
ns
VST357.vsd