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

Libraries and Utility Routines
HP COBOL Manual for TNS/E Programs—520347-003
13-64
Non-SMU Routines
end-of-tape-process
is an alphanumeric data item of at least seven characters, whose value specifies
the action to be taken if the file operation causes a reel swap.
If the value is “RETURN ” (in any combination of uppercase and lowercase letters
and with a space after N ), a read or write operation returns an I-O status code of
“97” and a GUARDIAN-ERR of 150 when a reel swap occurs. If the reel swap
occurs during a WRITE statement, the record that was just written and several of
the records previously written might or might not be on the tape just completed.
If the value is not “RETURN ” or end-of-tape-process is omitted, a read or
write operation does not return anything to the program when a reel swap occurs.
return-code
is an identifier of a numeric data item in which an error value will be returned. The
expected values and their respective meanings are:
Non-SMU Routines
This topic explains the individual routines in the ZCOBDLL file that are not Saved
Message Utility (SMU) routines.
Value Meaning
0 Successful execution
1 file-name is missing or is invalid, or an extraneous parameter is present.
2 The value of the open-type, exclusion, sync-depth, or mount-
messages parameter is invalid.
4The device-type of the file specified is not compatible with the value
specified for open-type.
5 An operation error occurred (for example, the file could not be opened).
Table 13-12. Non-SMU ZCOBDLL Routines
Routine Comment
COBOL_SPECIAL_OPEN_
COBOL_ASSIGN_ For the Guardian environment
COBOLFILEINFO
For the Guardian environment
COBOL_FILE_INFO_
For the OSS environment
CREATEPROCESS Cannot create a high-PIN process. To create a
high-PIN process, use CLU_PROCESS_CREATE