Map Commands › CLOSE

CLOSE

Purpose

(CA ADS Batch only) Closes the dialog input and output file maps.

Syntax

►►─── CLOSE ───────┬─ BOTH ◄──┬─────── file MAPs ─────── . ──────────────────►◄
                   ├─ INPUT ──┤
                   └─ OUTPUT ─┘

Parameters

BOTH

Specifies the dialog's input and output file maps.

BOTH can be specified even if the dialog has only an input or an output file map.

BOTH is the default when no other option is specified.

INPUT

Specifies the dialog's input file map.

OUTPUT

Specifies the dialog's output file map.

Usage

Considerations

• The runtime system automatically closes the files if an application terminates with files still open:
  • A CLOSE command logically closes a file only if other dialogs using different maps have accessed the same file.
  • A CLOSE command must be issued for each map to physically close a file.
• The CLOSE command is required when closing a file before the application terminates, as in the following cases:
  • The application has been reading from or writing to a file and is required to start over at the beginning of the file.
  • An output file to which records were written is to be read as an input file.
  • A run-unit commit is performed by a COMMIT command or at the end of a run unit.

    If a COMMIT command is issued, but not all files used in the application are closed, the runtime system either takes no action, sends a warning message to the log, or abends the application, as specified at system generation or at run time. The default action is abend.