graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPDSAR - Delete Structures from Archive

GPDSAR (arid, number, lstrid)

Purpose

Use GPDSAR to delete one or more structures from the specified open archive file.

Note: The graPHIGS API does not check if other structures in the archive file reference the deleted structure. Therefore, the graPHIGS API does not delete the execute structure-type elements in other archived structures that reference the deleted structures.

Parameters

arid -- specified by user, fullword integer

Archive file identifier.

number -- specified by user, fullword integer

Number of structure identifier entries in the list (>=1)

lstrid -- specified by user, array of fullword integers

List of structure identifiers.

Error Codes

7: FUNCTION REQUIRES STATE AROP
134: NUMBER OF ENTRIES IN LIST < ONE
220: SPECIFIED ARCHIVE FILE DOES NOT EXIST
1113: FILE IS READ ONLY

Related Subroutines

GPCEXS: Conditional Execute Structure
GPDASA: Delete All Structure from Archive
GPDSNA: Delete Structure Networks from Archive
GPEXST: Execute Structure

RCP code

201332738 (X'0C001802')