SET FILE OPEN

Opens a file.

Syntax

SET FILE

Read syntax diagramSkip visual syntax diagramSET FILE( data-value)OPEN EMPTY

Condition: FILENOTFOUND, INVREQ, IOERR, NOTAUTH

Note: DSIDERR is equivalent to FILENOTFOUND.

 

Description

SET FILE OPEN allows you to open a local file.

Options

EMPTY
Specifies that the opened file is to be emptied before giving access to the caller.
FILE(data-value)
Specifies the name of the file as it is defined in the File Definitions (FD). The name can be up to eight characters long.

Conditions

FILENOTFOUND
Occurs if the named file cannot be found in the FD (RESP2=18).

Default action: Terminates the task abnormally.

INVREQ
Occurs if the file is remote (RESP2=1).

Default action: Terminates the task abnormally.

IOERR
Occurs if the SET FILE OPEN operation fails. The CICS® queue and file control return code, if any, is set in RESP2.

(For information about handling the IOERR condition, see IOERR condition processing.)

Default action: Terminates the task abnormally.

NOTAUTH
Occurs if a resource security check has failed on FILE(data-value).

Default action: Terminates the task abnormally.