SET CONFLICT RESOLUTION(3P) — SUNPHIGS LIBRARY

NAME

SET CONFLICT RESOLUTION − set the conflict resolution flags

SYNOPSIS

C Syntax

void
psetconfres ( archival_resolution, retrieval_resolution )
Pconfresarchival_resolution;archival conflict resolution
Pconfresretrieval_resolution;retrieval conflict resolution

FORTRAN Syntax

SUBROUTINE pscnrs ( ARCCR, RETCR )
INTEGERARCCRarchival conflict resolution
INTEGERRETCRretrieval conflict resolution

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

The SET CONFLICT RESOLUTION subroutine sets the conflict resolution flags controlling how structure archival and retrieval conflicts are resolved. The flag values may be MAINTAIN, ABANDON or UPDATE.

The default value of the archival conflict resolution flag is UPDATE. The default value of the retrieval conflict resolution flag is ABANDON.

C Input Parameters

archival_resolution
An enumerated variable specifying the value of the archival conflict resolution flag.

retrieval_resolution
An enumerated variable specifying the value of the retrieval conflict resolution flag.

Valid values (defined in phigs.h) for these two flags are:

PMAINTAIN
PABANDON
PUPDATE

FORTRAN Input Parameters

ARCCR
An enumerated variable specifying the value of the archival conflict resolution flag.

RETCR
An enumerated variable specifying the value of the retrieval conflict resolution flag.

Valid values (defined in phigs77.h) for these two flags are:

PCRMNT(maintain)
PCRABA(abandon)
PCRUPD(update)

Execution

The SET CONFLICT RESOLUTION subroutine sets the conflict resolution flags in the PHIGS state list. The archival conflict resolution flag controls what happens when an attempt is made to archive structures whose identifiers already exist in the archive file. The retrieval conflict resolution flag controls what happens when an attempt is made to retrieve structures whose identifiers already exist in the Central Structure Store.

The flag values may be MAINTAIN, ABANDON or UPDATE. A value of MAINTAIN prevents conflicting structures from being overwritten, a value of UPDATE allows conflicting structures to be overwritten, and a value of ABANDON indicates that the entire archival or retrieval operation should be abandoned, with no changes made to the archive or the Central Structure Store, if there are any conflicts.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

Museum