NAME

RETRIEVE ALL STRUCTURES − retrieve all structures from an archive file

SYNOPSIS

C Syntax

void
pret_all_structs ( archive_id )
Pintarchive_id;archive identifier

Required PHIGS Operating States

(PHOP, ∗, ∗, AROP)

DESCRIPTION

Purpose

Use RETRIEVE ALL STRUCTURES to retrieve all structures from the specified open archive file into the Central Structure Store (CSS). 

C Input Parameter

archive_id
The archive identifier specifying the open archive file from which to read.

Execution

All structures in the specified open archive file are copied into the CSS.  If any of the structures to be retrieved currently exist in the CSS, the conflict is resolved as follows:

•If the retrieval conflict resolution flag is MAINTAIN, then the conflicting structure will not be copied into the CSS (its contents are maintained). 

•If the retrieval conflict resolution flag is UPDATE, then the conflicting structure in the CSS will be overwritten (its contents are updated). 

•If the retrieval conflict resolution flag is ABANDON, then no structures will be copied to the CSS. 

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

If the currently open structure must be overwritten because of a conflict while the retrieval conflict resolution flag is UPDATE, then it is closed, its contents are overwritten, and it is re-opened. The element pointer will be set to point to the last element. 

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

SEE ALSO

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

September 02, 1992