COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines
HP COBOL Manual for TNS and TNS/R Programs—522555-006
13-49
COBOL85^REWIND^SEQUENTIAL and
COBOL_REWIND_SEQUENTIAL_
COBOL85^REWIND^SEQUENTIAL and
COBOL_REWIND_SEQUENTIAL_
The COBOL85^REWIND^SEQUENTIAL and COBOL_REWIND_SEQUENTIAL_
routines enable you to reposition a sequential disk or single-file tape file to its
beginning without closing and reopening it.
library-reference
is a mnemonic-name in the SPECIAL-NAMES paragraph. For the COBOL85
compiler, this mnemonic-name is associated with either
$SYSTEM.SYSTEM.CBL85UTL or some other object file containing an object
copy of COBOL85^REWIND^SEQUENTIAL. For the NMCOBOL compiler, this
mnemonic-name is associated with either $SYSTEM.SYSnn.ZCOBSRL or some
other object file containing an object copy of COBOL_REWIND_SEQUENTIAL_.
file-name
is the name of a COBOL data file; that is, a file described in a File Description
entry. It must be an FD name associated with a file name that specifies an
unstructured or entry sequenced file.
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:
Value Meaning
0 Successful execution
1 file-name is missing or is invalid.
5 An operation error occurred (for example, the file could not be rewound).
USING
library-reference
file-name
ENTER
" "
OF
return-codeGIVING
COBOL85^REWIND^SEQUENTIAL
COBOL_REWIND_SEQUENTIAL_
ns ns
VST345.vsd