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

Libraries and Utility Routines

HP COBOL Manual for TNS/E Programs—520347-003

13-49

COBOL_SETMODE_

The COBOL_SETMODE_ routine sets device-dependent functions using a call to the

Guardian environment routine SETMODE.

If a NOWAIT input-output request is active when the COBOL_SETMODE_ routine is

called, the request is completed before the SETMODE routine is called. If the file is

closed when the call is made, the request is queued until the next OPEN request for

the file is issued.

library-reference

is a mnemonic-name associated in the SPECIAL-NAMES paragraph with the DLL

containing an object copy of COBOL_SETMODE_.

file-name

is a COBOL file name associated with a file that is not $RECEIVE and is not open

for HP COBOL Fast I-O. If the file is not open, the call to the Guardian environment

routine SETMODE is made during the next successful open request for the file.

Caution. The HP COBOL run-time library does not attempt to validate calls to SETMODE. To

avoid interfering with the operation of the HP COBOL run-time library, use

COBOL_SETMODE_ only if absolutely necessary.

USING file-name function

param-1

cpinfo

GIVING error-return

param-2

lastparams

OF library-reference

VST611.vsd

ENTER

COBOL_SETMODE_