NAME

CLOSE ARCHIVE FILE - close named archive file

SYNOPSIS

C Syntax

void
pclose_ar_file ( archive_id )
Pintarchive_id;archive identifier

Required PHIGS Operating States

(PHOP, ∗, ∗, AROP)

DESCRIPTION

Purpose

Use CLOSE ARCHIVE FILE to close an archive file. 

C Input Parameter

archive_id
An integer identifying the archive file to be closed.

Execution

If the archive associated with the specified archive file identifier has changed since it was opened, it is written to the file and the file is closed.  If no changes were made, the file will be closed without being rewritten. 

The archive file identifier is disassociated with the file it referred to and removed from the set of open archive files maintained in the PHIGS state list.  The PHIGS archive state is changed to archive closed (ARCL) if no other archive files are open. 

ERRORS

007Ignoring function, function requires state (PHOP, ∗, ∗, AROP)

404Ignoring function, the specified archive file is not open

SEE ALSO

INQUIRE ARCHIVE FILES (3P)
INQUIRE ARCHIVE STATE VALUE (3P)
OPEN ARCHIVE FILE (3P)

September 02, 1992