<open options>

──┬────────────────────────────┬─┬──────────────────────────────┬──────►
  └─ , ──<open control option>─┘ └─ , ──<associateddata option>─┘
►─┬────────────────────────────────┬───────────────────────────────────┤
  └─ , ──<connecttimelimit option>─┘

<open control option>

──┬─ ATEND ───────┬────────────────────────────────────────────────────┤
  ├─ AVAILABLE ───┤
  ├─ AVAILATEND ──┤
  ├─ CONDITIONAL ─┤
  ├─ DONTWAIT ────┤
  ├─ MUSTBENEW ───┤
  ├─ OFFER ───────┤
  └─ WAIT ────────┘

Open Control Options

If no open control option is specified, the WAIT option is assumed. The WAIT option sets the current position to the beginning of the file. Use the ATEND option to set the current position to the end of the file.

Use the AVAILABLE option to prevent the OPEN operation from being suspended if the file cannot be opened. The AVAILABLE option sets the current position to the beginning of the file. Use the AVAILATEND option to set the current position to the end of the file.

The DONTWAIT and OFFER options are meaningful only for port files. Refer to the following examples for information about when to use these options.

The CONDITIONAL and MUSTBENEW options are meaningful only for disk files. When creating a new file, use either of these options to ensure that an existing file is not replaced. Use the MUSTBENEW option to cause the OPEN operation to fail if an existing file would be replaced. Use the CONDITIONAL option to cause the existing file to be opened instead of replaced. Both options prevent the OPEN operation from being suspended if the file cannot be opened. If the file is opened, the current position is set to the beginning of the file.

ASSOCIATEDDATA Option

This option is only meaningful for port files and is used to send associated data with an OPEN request.

For more information on the ASSOCIATEDDATA option, see CLOSE Statement.

CONNECTTIMELIMIT Option

This option is only meaningful for port files and is used to specify the maximum amount of time (in minutes) that the system allows for a successful OPEN operation on a subfile.

For more information on the CONNECTTIMELIMIT option, see AWAITOPEN Statement.