OPEN ARCHIVE FILE(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

OPEN ARCHIVE FILE − open specified archive file

SYNOPSIS

C Syntax

void
popen_ar_file ( archive_id, archive_file )
Pintarchive_id;archive identifier
char∗archive_file;archive file name

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use OPEN ARCHIVE FILE to open an archive file and associate a specified archive file identifier with the open archive file.

C Input Parameters

archive_id
An integer specifying the identifier to be associated with the open archive file.

archive_file
A character string giving the file name of the archive file. The application should not open this file; PHIGS will do this when it needs to access the file.

Neither the application nor the operator should attempt to interact with this file after passing it to OPEN ARCHIVE FILE.

Execution

If the specified archive file does not exist, then a new file is created and remains empty until CLOSE ARCHIVE FILE is called. At that time, any archived structures will be written to the file.

If the specified file exists and is a valid PEX-SI archive file, the contents are read and available for retrieval. If the named file exists but is empty, it is treated as if it did not exist (in other words, it becomes a valid PEX-SI archive file and remains empty until it is closed, at which time any archived structures are written to it).

The physical file is opened only by PHIGS when reading from or writing to it (in other words, during calls to OPEN ARCHIVE and CLOSE ARCHIVE).

The PHIGS archive state is set to archive open (AROP), and the specified archive file identifier is added to the set of open archive files maintained in the PHIGS state list.

Note: It is recommended that the application leave an archive file open until it is no longer needed, in order to avoid repeating the overhead associated with the OPEN ARCHIVE FILE operation.

One archive file format is supported: a private binary format. The binary format is supported for users who want compact archives over standard conformance.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

402Ignoring function, archive file identifier already in use

400Ignoring function, the archive file cannot be opened

401Ignoring function, opening this archive file would exceed the maximum number of simultaneously open archive files

403Ignoring function, the archive file is not a PHIGS archive file

Museum