[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

SET CONFLICT RESOLUTION (PHOP,*,*,*)

Purpose

Use Set Conflict Resolution to set the conflict resolution flags for use by all archive files. The graPHIGS API uses these flags to determine how to resolve conflicts when you are archiving or retrieving one or more structures (e.g., when a structure that exists in a specified archive file has the same identifier as a structure that exists in the structure store).

There are two conflict resolution flags: the archival conflict resolution for moving structure data to an archive file from the structure store and the retrieval conflict resolution for moving structure data from an archive file to the structure store. Your application can set either of these flags to: MAINTAIN, ABANDON, or UPDATE.

  • If the value is set to MAINTAIN, then the graPHIGS API does not transfer any structures when a conflict occurs.

  • If the value is set to ABANDON, then the graPHIGS API does not transfer any structures when a conflict occurs.

  • If the value is set to UPDATE, then the graPHIGS API transfers all the structures and replaces any conflicting structures with the new ones. If this subroutine is not used, then the archival conflict resolution flag defaults to a value of UPDATE and the retrieval conflict resolution flag defaults to a value of ABANDON.

    Language Bindings

    • C

    pset_conf_res (archive_res, retrieval_res)

    Input Parameters

    Pconf_res archive_res
    Archival conflict resolution. (0=PRES_MAINTAIN, 1=PRES_ABANDON, 2=PRES_UPD).

    Pconf_res retrieval_res
    Retrieval conflict resolution (0=PRES_MAINTAIN, 1=PRES_ABANDON, 2=PRES_UPD).

    FORTRAN

    PSCNRS (arccr, retcr)

    Input Parameters

    integer arccr
    Archival conflict resolution (0=PCRMNT, 1=PCRABA, 2=PCRUPD).

    integer retcr
    Retrieval conflict resolution (0=PCRMNT, 1=PCRABA, 2=PCRUPD).

    Errors

    2
    Function Requires State (PHOP,*,*,*)

    Related Subroutines

  • Inquire Conflict Resolution

    • [ Previous | Next | Contents | Glossary | Home | Search ]