ARCHIVE STRUCTURES

PAR_STRUCTS

CALL SEQUENCE

void par_structs(

Pint	archive_id	/* archive identifier	*/
const Pint_list	*struct_ids	/* list of structure identifiers	*/

)

TYPES

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

PHIGS STATE

EFFECT

The structures specified by the struct_ids list are archived in archive archive_id.

Conflicts may appear during archiving when one of the structure identifiers to be saved corresponds to a structure already present in archive archive_id. In this case, the archival conflict resolution flag entry in the PHIGS STATE list allows three TYPES of action to be defined:

- MAINTAIN Structure already present in the archive is maintained.

- ABANDON Saving operation abandoned for conflicting structure.

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

If one of the structures specified in struct_ids is not in the centralized structure store (CSS), 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

200

Warning, ignoring structures that do not exist

405

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

406

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

SEE ALSO

open archive file, archive structures networks, archive all structures, set conflict resolution, retrieve structures, delete structures from archive, inquire all conflicting structures