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

GPCNRS - Set Conflict Resolution

GPCNRS (aflag, rflag)

Purpose

Use GPCNRS to set the conflict resolution flags. 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 current structure store).

There are two conflict resolution flags: aflag for moving structure data to an archive file from a structure store and rflag for moving structure data from an archive file to a structure store. Your application can set either of these flags to: 1=MAINTAIN , 2=ABANDON , or 3=UPDATE

  • If the value is set to 1=MAINTAIN , then the graPHIGS API only transfers the structures that do not conflict.

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

  • If the value is set to 3=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 ( aflag) defaults to a value of 3=UPDATE and the retrieval conflict resolution flag ( rflag) defaults to a value of 2=ABANDON

    Parameters

    aflag -- returned by the graPHIGS API, fullword integer

    Archive conflict resolution (1=MAINTAIN, 2=ABANDON, 3=UPDATE )

    rflag -- returned by the graPHIGS API, fullword integer

    Retrieve conflict resolution (1=MAINTAIN, 2=ABANDON, 3=UPDATE )

    Error Codes

    127
    CONFLICT RESOLUTION FLAG IS INVALID

    Related Subroutines

    GPARAS
    Archive All Structures
    GPARSN
    Archive Structure Networks
    GPARST
    Archive Structures
    GPQCNR
    Inquire Conflict Resolution
    GPRVAS
    Retrieve All Structures
    GPRVSN
    Retrieve Structure Networks
    GPRVST
    Retrieve Structures

    RCP code

    201330965 (X'0C001115')

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