NAME

ARCHIVE ALL STRUCTURES − archive all structures into an archive file

SYNOPSIS

C Syntax

void
par_all_structs ( archive_id )
Pintarchive_id;archive identifier

Required PHIGS Operating States

(PHOP, ∗, ∗, AROP)

DESCRIPTION

Purpose

Use ARCHIVE ALL STRUCTURES to archive all structures in the Central Structure Store to the specified open archive file. 

C Input Parameter

archive_id
The archive identifier specifying the open archive file to write to.

Execution

All structures in the Central Structure Store are copied to the indicated open archive file.  If any of the structures to be archived currently exist in the archive file, the conflict is resolved as follows:

•  If the archival conflict resolution flag is MAINTAIN, the conflicting structure will not be copied into the archive (the archive contents are maintained) •  If the archival conflict resolution flag is UPDATE, the conflicting structure in the archive will be overwritten (the archive contents are updated) •  If the archival conflict resolution flag is ABANDON, no structures will be copied to the archive at all

The archival conflict resolution flag is set by the SET CONFLICT RESOLUTION subroutine. 

ERRORS

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

404Ignoring function, the specified archive file is not open

405Ignoring function, name conflict occurred while conflict resolution flag has value ABANDON

406Warning, the archive file is full.  Any structures that were archived were archived in total

SEE ALSO

OPEN ARCHIVE FILE (3P)
SET CONFLICT RESOLUTION (3P)
ARCHIVE STRUCTURE NETWORKS (3P)
ARCHIVE STRUCTURES (3P)
DELETE ALL STRUCTURES FROM ARCHIVE (3P)

September 02, 1992