OPEN ARCHIVE FILE

POPEN_AR_FILE

CALL SEQUENCE

void popen_ar_file(

Pint	archive_id	/* archive identifier	*/
const char	*archive_file	/* archive file name	*/

)

PHIGS STATE

EFFECT

Opens an archive file.

The archive state is set to AROP and identifier archive_id is added to the list of opened archives in the PHIGS STATE list.

An archive file is a means of saving structure definitions and therefore of making a backup of the centralized structure store (CSS). OPEN ARCHIVE is the first function in a group of functions allowing an element in an archive to be backed up, restored and destroyed.

ERRORS

2

Ignoring function, function requires state (PHOP, *,*,*)

402

Ignoring function, archive file identifier already in use

400

Ignoring function, the archive file cannot be opened

401

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

403

Ignoring function, the archive file is not a GPHIGS archive file

SEE ALSO

close archive file, archive structures, set conflict resolution, retrieve structures, delete structures from archive, inquire archive state value, inquire phigs facilities, inquire archive files