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

GPEPPG - Generalized Set Element Pointer at Pick Identifier

GPEPPG (pickid, flag)

Purpose

Use GPEPPG to set the element pointer to the specified pick identifier element within the open structure.

Starting at the position following the current element pointer, the graPHIGS API searches for the first occurrence of the specified label. If the end of the structure is reached, then the result depends on the value of the pick identifier search flag (flag) parameter:

  • If the value of the flag is 2=WRAP , then the search continues starting at element 1 until the current element pointer is encountered. If the specified pickid is not found, then the graPHIGS API issues an error and no action is performed.

  • If the value of the flag is 1=NOWRAP , then the graPHIGS API issues an error and no action is performed.

    • Parameters

    pickid -- specified by user, fullword integer

    Pick identifier.

    flag -- specified by user, fullword integer

    Pick identifier search flag (1=NOWRAP, 2=WRAP )

    Error Codes

    4
    FUNCTION REQUIRES STATE STOP
    136
    VALUE OF SEARCH FLAG IS INVALID
    566
    PICK IDENTIFIER DOES NOT EXIST IN THE OPEN STRUCTURE

    Related Subroutines

    GPPKID
    Set Pick Identifier

    RCP code

    201332231 (X'0C001607')

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