graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPDSNA - Delete Structure Networks from Archive

GPDSNA (arid, number, lstrid)

Purpose

Use GPDSNA to delete one or more structure networks from the specified open archive file.

Note: The graPHIGS API does not check if other structures in the archive file reference the deleted structures. 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 root structure identifier entries in the list (>=1)

lstrid -- specified by user, array of fullword integers

List of root 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
GPDSAR: Delete Structures from Archive
GPEXST: Execute Structure

RCP code

201331971 (X'0C001503')