INQUIRE SET OF WORKSTATIONS TO WHICH POSTED(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE SET OF WORKSTATIONS TO WHICH POSTED − inquire list of workstations to which a structure is posted

SYNOPSIS

C Syntax

void
pinqsetwsposted ( struct_id, length, start, error_ind, ws, total_length )
Pintstruct_id;structure identifier
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pintlst∗ws;OUT list of workstations
Pint∗total_length;OUT length of list in PHIGS

FORTRAN Syntax

SUBROUTINE pqwkpo ( STRID, N, ERRIND, OL, WKID )
INTEGERSTRIDstructure identifier
INTEGERNset member requested
INTEGERERRINDOUT error indicator
INTEGEROLOUT number of workstations to which the
structure is posted
INTEGERWKIDOUT Nth member of set of workstations
to which the structure is posted

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE SET OF WORKSTATIONS TO WHICH POSTED to obtain a list of workstations to which a specified structure is posted.

C Input Parameters

struct_id
Identifier of the structure for which the list of workstations it is posted to will be returned.

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

startStarting position of inquiry into the list of workstations to which this structure is posted. The elements of the list of workstation identifiers, beginning with the item number specified by start, are copied sequentially into ws−>integers until ws−>integers is full or all the workstation 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.

wsA pointer to a Pintlst structure in which the system returns the list of workstations to which struct_id is posted. Pintlst is defined in phigs.h as follows:

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

The number component specifies the number of workstation identifiers in the list. The integers component is a pointer to a list, number long, of the workstation identifiers.

The application must allocate memory for length elements in the ws−>integers list.

total_length
A pointer to an integer in which the system returns the total number of workstations to which the specified structure is posted. This is the value required for length if the entire list is to be returned.

FORTRAN Input Parameters

STRID
Identifier of the structure whose ’workstations posted to’ list will be returned.

NElement of the list of workstations to which the structure STRID is posted to return; only one workstation identifier may be inquired per subroutine call. If a value of 0 is used here, no workstation identifier will be returned, but the total number of elements in the structure state list of workstations to which this structure is posted will be returned in OL.

FORTRAN Output Parameters

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

OLThe total number of elements in the structure state list of workstations to which this structure is posted.

WKIDThe Nth workstation identifier from the structure state list of workstations to which this structure is posted.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

201Ignoring function, the specified structure does not exist

Museum