ARCHIVE STRUCTURE NETWORKS(3P) — SUNPHIGS LIBRARY

NAME

ARCHIVE STRUCTURE NETWORKS − archive specified structure networks into an archive file

SYNOPSIS

C Syntax

void
parstructnet ( archive_id, struct_ids )
Pintarchive_id;archive identifier
Pintlst∗struct_ids;list of structure identifiers

FORTRAN Syntax

SUBROUTINE parsn ( AFID, N, LSTRID )
INTEGERAFIDarchive file identifier
INTEGERNnumber of structure identifiers in the list
INTEGERLSTRID(N)list of structure identifiers

Required PHIGS Operating States

(PHOP, ∗, ∗, AROP)

DESCRIPTION

Purpose

Use ARCHIVE STRUCTURE NETWORKS to archive a list of structure networks 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 Pintlst structure containing the list of the root structure identifiers of the networks to be archived. The Pintlst structure is defined in phigs.h as follows:

typedef struct {
Pintnumber;/∗ number of Pints in list ∗/
Pint∗integers;/∗ list of integers ∗/
} Pintlst;

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

FORTRAN Input Parameters

AFIDThe archive identifier specifying the open archive file to write to.

NThe number of structure networks to be archived.

LSTRID
An array of integers containing the root structure identifiers of the networks to be archived.

Execution

The structures belonging to the specified networks 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