INQUIRE SET OF OPEN WORKSTATIONS(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE SET OF OPEN WORKSTATIONS − inquire the current set of open workstations

SYNOPSIS

C Syntax

void
pinqsetopenws ( length, start, error_ind, ws, total_length )
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pintlst∗ws;OUT list of ws ids
Pint∗total_length;OUT length of list in PHIGS

FORTRAN Syntax

SUBROUTINE pqopwk ( N, ERRIND, OL, WKID )
INTEGERNset member requested
INTEGERERRINDOUT error indicator
INTEGEROLOUT number of open workstations
INTEGERWKIDOUT Nth member of set of open workstations

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE SET OF OPEN WORKSTATIONS to obtain a list of the currently open workstations.

C Input Parameters

lengthNumber of items for which the application has allocated memory in the output parameter indices. 0 may be specified, in order to get the total length of the list.

startStarting position in the list at which to begin the inquiry.

C Output Parameters

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

total_length
A pointer to an integer in which to return the total length of the list. This is the value required for length if all the items in the list are to be returned.

wsA pointer to a Pintlst in which the system returns the portion of the list of currently open workstations starting at the entry specified with start. Pintlst is defined in phigs.h as follows:

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

} Pintlst; The pointer ws->integers must be initialized to an array, length long, of Pint elements.

FORTRAN Input Parameters

NPosition in the list of the item requested. The Nth entry in the list of open workstations will be returned in WKID.

FORTRAN Output Parameters

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

OLThe total number of currently open workstations.

WKIDThe workstation identifier of the Nth entry in the list of open workstations.

ERRORS

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

2201C: Start index out of range

Museum