COBOL Manual for TNS and TNS/R Programs

Using HP COBOL in the OSS Environment
HP COBOL Manual for TNS and TNS/R Programs—522555-006
19-25
Utility Routines
Utility Routines
These utility routines accept only Guardian file names:
•
COBOL_RETURN_SORT_ERRORS_
•
COBOL_SET_SORT_PARAM_TEXT_
•
COBOL_SPECIAL_OPEN_
If a program passes a file name to the utility routine COBOL_ASSIGN_, then
COBOL_ASSIGN_ assumes that the file name is a Guardian file name unless the
calling program identified the file name as an OSS file name.
The utility routine COBOLFILEINFO does not return useful information in the OSS
environment. Use the routine COBOL_FILE_INFO_ instead.
When using #DYNAMIC in the OSS environment to dynamically assign Guardian file
names or Guardian spooler process names, you must use "GUARDIAN #DYNAMIC" in
the file-control entry. The file name passed by the COBOL_ASSIGN_ utility is a
standard Guardian name.
Example 19-3. “GUARDIAN #DYNAMIC” in a File-Control Entry
SELECT ASGN ASSIGN TO "GUARDIAN #DYNAMIC"
FILE STATUS IS FILE-STATUS.
...
MOVE "$S.#TEST" TO FILENAM
ENTER "COBOL_ASSIGN_" USING ASGN, FILENAM GIVING asn-error