ARCHIVE STRUCTURES(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

ARCHIVE STRUCTURES − archive specified structures into an archive file

SYNOPSIS

C Syntax

void
par_structs ( archive_id, struct_ids )
Pintarchive_id;archive identifier
Pint_list∗struct_ids;list of structure identifiers

Required PHIGS Operating States

(PHOP, ∗, ∗, AROP)

DESCRIPTION

Purpose

Use ARCHIVE STRUCTURES to archive a list of structures in the Central Structure Store to the specified open archive file.

C Input Parameters

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

struct_ids
A pointer to a Pint_list structure containing the list of structure identifiers to be archived. The Pint_list structure is defined in phigs.h as follows:

typedef struct {
Pintnum_ints;/∗ number of Pints in list ∗/
Pint∗ints;/∗ list of integers ∗/
} Pint_list;

The num_ints component specifies the number of structure identifiers in the list. The ints component is a pointer to a list, num_ints long, of the structure identifiers.

Execution

The specified structures are copied from the Central Structure Store 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.

If any of the structures to be archived do not exist in the Central Structure Store, a warning is generated and the archiving operation continues for the remaining structures.

ERRORS

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

404Ignoring function, the specified archive file is not open

200Warning, ignoring structures that do not exist

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

Museum