RETRIEVE STRUCTURE NETWORKS

PRET_STRUCT_NETS

CALL SEQUENCE

void pret_struct_nets(

Pint	archive_id	/* archive identifier	*/
Pint_list	*structure_ids	/* list of structure ids	*/

)

TYPES

typedef struct {
	Pint	num_ints;	/* number of Pints in list 	*/
	Pint	*ints;	/* list of integers	*/
} Pint_list;

PHIGS STATE

EFFECT

The list of structures specified in structure_ids and their network are copied to the centralized structure store (CSS) from the archive archive_id.

If the identifier of one of the structures specified or one of its descendants is already present in the CSS, the conflict is processed according to the retrieval conflict resolution flag which can be:

- MAINTAIN : Structure already present in the CSS is maintained.

- ABANDON : Saving operation abandoned for conflicting structure.

- UPDATE : Structure already present in the CSS is overwritten by the new one.

If one of the structure specified in structure_ids is not in the archive, a warning is generated and no action is taken for this structure.

ERRORS

7

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

404

Ignoring function, the specified archive file is not open

405

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

408

Warning, some of the specified structures do not exist on the archive file. PHIGS will create empty structure in their place

SEE ALSO

open archive file, archive structures networks, retrieve structures identifiers, retrieve structure, retrieve all structures, retrieve paths to ancestors, retrieve paths to descendant, delete structure network from archive