OPENC command

From m204wiki
Jump to navigation Jump to search

Summary

Privileges
Any user
Function
Opens a Model 204 file or a temporary or permanent group, preserving the previous default file or group

Syntax

OPENC {[FILE] filename [AT location] [[,defupdt1] [,defupdt2]] | [PERM | TEMP] [GROUP] groupname}

Where:

filename The name of the Model 204 file to be opened.
location
  • For Parallel Query Option/204 files, the symbolic name (as many as eight characters) that refers to the location of the node on which the remote file resides. An unquoted equal sign (=) specifies that the file is local.
  • If remote, must match a symbolic destination name specified in the DESTINATION parameter of the relevant local client DEFINE PROCESS command.
defupdt1 The name (one to eight characters in the form TAPExxxx) of the fixed-length deferred update data set. If you specify this option, deferred updates to the hashed index (KEY and NUMERIC RANGE fields) are written to this data set.

Deferred updates are updates to the Model 204 file that are saved and applied all at the same time.

For information about opening remote files in deferred update mode, see PQO: Remote files and scattered groups.

defupdt2 The name (one to eight characters in the form TAPExxxx) of the variable-length deferred update data set. If you specify this option, deferred updates to ORDERED fields are written to this data set.

All index updates are written to defupdt2 if defupdt1 is not specified. If defupdt2 is not specified, updates to ORDERED fields are not deferred.

groupname The name of the Model 204 file group to be opened.

Syntax notes

A comma is required if a deferred update data set is specified. If the comma is omitted, the data set is ignored and no message is generated.

If neither FILE nor GROUP is specified, Model 204 searches for a temporary group, followed by a permanent group, followed by a file. If neither TEMP nor PERM is specified, Model 204 assumes a temporary group.

Example

OPENC FILE CENSUS OPENC WEEK OPENC PERM GROUP GDATA

Usage notes

Like the OPEN command, you can use OPENC to open a file or a permanent or temporary group. Unlike OPEN, however, OPENC preserves the previous default file or group.

The syntax and use of the OPENC command is identical to that described for the OPEN command.