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
pinq_conf_structs_net ( ar_id, struct_id, src, length, start, error_ind, ids, total_length )
Pintar_id;archive identifier
Pintstruct_id;structure identifier
Pstruct_net_sourcesrc; structure network source
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pint_list∗ids;OUT conflicting struct id list
Pint∗total_length;OUT length of list in PHIGS

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:

PNET_CSS Central Structure Store
PNET_AR  Archive

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 Pint_list structure in which the list of identifiers of conflicting structures is returned.  The Pint_list structure is defined in phigs.h as follows:

typedef struct {
Pintnum_ints;/∗ number of Pints in list ∗/
Pint∗ints;/∗ list of integers ∗/
} Pint_list;

The num_ints component specifies the number of structure identifiers in the list. The ints component is a pointer to a list, num_ints 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. 

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

SEE ALSO

INQUIRE ALL CONFLICTING STRUCTURES (3P)

September 02, 1992