INQUIRE CONFLICTING STRUCTURES IN NETWORK(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE CONFLICTING STRUCTURES IN NETWORK − inquire conflicting structures in a network in the Central Structure Store and an archive file

SYNOPSIS

C Syntax

void
pinqconfstructinnet ( ar_id, struct_id, src, length, start, error_ind, ids, total_length )
Pintar_id;archive identifier
Pintstruct_id;structure identifier
Pstructnetsrcsrc;structure network source
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pintlst∗ids;OUT conflicting struct id list
Pint∗total_length;OUT length of list in PHIGS

FORTRAN Syntax

SUBROUTINE pqcstn ( AFID, STRID, SNSRC, N, ERRIND, OL, OSTRID )
INTEGERAFIDarchive file identifier
INTEGERSTRIDstructure identifier
INTEGERSNSRCstructure network source (PCSS, PARCHV)
INTEGERNelement of the structure identifier list
to return
INTEGERERRINDOUT error indicator
INTEGEROLOUT number of structure identifiers in list
INTEGEROSTRIDOUT Nth structure identifier in list

Required PHIGS Operating States

(PHOP, ∗, ∗, AROP)

DESCRIPTION

Purpose

Use INQUIRE CONFLICTING STRUCTURES IN NETWORK to obtain a list of the identifiers of all structures in a specified network that exist in both the Central Structure Store and the specified open archive file.

C Input Parameters

ar_idThe archive identifier specifying the open archive file to use.

struct_id
The identifier of the root structure of the network.

srcThe structure network source, defined in phigs.h as:

PCSSCentral Structure Store
PARCHIVEArchive

lengthThe number of integers items in the ids output parameter for which the application has allocated memory. length is the number of list elements (structure identifiers) that the system can return in ids−>integers. If a value of 0 is used here, no data will be returned in the ids−>integers list, but the total number of conflicting structures will be returned in total_length.

startStarting position in the list of identifiers of conflicting structures at which to begin the inquiry. The elements of the list of structure identifiers, beginning with the item number specified by start, are copied sequentially into ids−>integers until ids−>integers is full or all the structure identifiers have been copied.

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

idsA pointer to a Pintlst structure in which the list of identifiers of conflicting structures is returned. The Pintlst structure is defined in phigs.h as follows:

typedef struct {
Pintnumber;/∗ number of Pints in list ∗/
Pint∗integers;/∗ list of integers ∗/
} Pintlst;

The number component specifies the number of structure identifiers in the list. The integers component is a pointer to a list, number long, of the structure identifiers. The application must allocate memory for length elements in the ids−>integers list.

total_length
A pointer to an integer in which the total number of conflicting structures is returned. This is the value required for length if all structure identifiers are to be returned.

FORTRAN Input Parameters

AFIDThe archive identifier specifying the open archive file to use.

STRID
The identifier of the root structure of the network.

SNSRC
The structure network source, defined in phigs77.h as:

PCSSCentral Structure Store
PARCHVArchive

NElement of the list of identifiers of conflicting structures to return; only one identifier may be inquired per subroutine call. If a value of 0 is used here, no structure identifier will be returned, but the total number of conflicting structures will be returned in OL.

FORTRAN Output Parameters

ERRIND
The error number of any error detected by this function.

OLThe total number of conflicting structures.

OSTRID
The Nth structure identifier from the list of conflicting structures.

Execution

If the structure network source is the Central Structure Store, the identifiers of all structures in the network defined by the root structure identifier in the Central Structure Store are compared to the identifiers of all structures in the specified archive file, and those which are in both are returned as conflicting structures. If the structure network source is the archive file, the identifiers of all structures in the network defined by the root structure identifier in the specified archive file are compared to the identifiers of all structures in the Central Structure Store, and those which are in both are returned as conflicting structures.

ERRORS

007Ignoring function, function requires state (PHOP, ∗, ∗, AROP)

201Ignoring function, the specified structure does not exist

404Ignoring function, the specified archive file is not open

Museum