NAME

INQUIRE PHIGS FACILITIES− inquire the current list of PHIGS facilities defined in the PHIGS description table. 

SYNOPSIS

C Syntax

void
pinqphigsfacil ( length, start, error_ind, open_ws, open_ar, num_names, char_sets, norm_filt, inv_filt, total_length )
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pint∗open_ws;OUT max. num. simultaneously open ws
Pint∗open_ar;OUT max. num. simultaneously open archive files
Pint∗num_names;OUT number of available names for name sets
Pintlst∗char_sets;OUT list of character sets
Pint∗norm_filt;OUT maximum length of normal filter list for ISS
Pint∗inv_filt;OUT maximum length of inverted filter list for ISS
Pint∗total_length;OUT length of list in PHIGS

FORTRAN Syntax

SUBROUTINE pqphf ( NCS, ERRIND, SIMOPW, SIMOPA, NAMESN, OLCS, CS, NFLN, IFLN )
INTEGERNCScharacter set requested
INTEGERERRINDOUT error indicator
INTEGERSIMOPWOUT maximum number of simultaneously
open workstations
INTEGERSIMOPAOUT maximum number of simultaneously
open archive files
INTEGERNAMESNOUT maximum number of available names
for name sets
INTEGEROLCSOUT number of available character sets
INTEGERCSOUT NCSth available character set
INTEGERNFLNOUT maximum length of normal filter
list for ISS
INTEGERIFLNOUT maximum length of inverted filter
list for ISS

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE PHIGS FACILITIES to obtain a list of the available PHIGS facilities from the PHIGS description table. 

C Input Parameters

lengthThe number of list elements for which the application has allocated memory in the output parameter char_sets->integers.  0 may be specified, in order to have total_length return the total number of elements in the list of character sets. 

startThe starting position in the list at which the inquiry is to begin. 

C Output Parameters

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

open_ws
An integer pointer to where the system returns the maximum number of simultaneously open workstations supported. 

open_ar
An integer pointer to where the system returns the maximum number of simultaneously open archive files supported. 

char_sets
A pointer to a data structure in which the system returns a portion of the list of available character sets, starting with the start number item.  Pintlst is defined in phigs.h as follows:

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

Prior to calling this function, the integers field of the Pintlst structure must contain a pointer to an application supplied buffer. This buffer must be at least as large as the corresponding length parameter. 

norm_filt
An integer pointer to where the system returns the maximum length of the normal filter list for Incremental Spatial Search.

inv_filt
An integer pointer to where the system returns the maximum length of the inverted filter list for Incremental Spatial Search.

total_length

An integer pointer to where the system returns the total length of the of the list of available character sets.  This is the value required for length, if all the item on the workstation list are to be returned. 

FORTRAN Input Parameters

NCSThe number of the list element desired from the list of character sets. 

FORTRAN Output Parameters

SIMOPW
The maximum number of simultaneously open workstations supported. 

SIMOPA
The maximum number of simultaneously open archive files supported. 

OLCSThe number of available character sets. 

CSThe NCSth list element from the list of character sets. 

NFLNThe maximum length of the normal filter list for Incremental Spatial Search. 

IFLNThe maximum length of the inverted filter list for Incremental Spatial Search. 

ERRORS

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

SEE ALSO

PHIGS DESCRIPTION TABLE(7)

Sun Release 4.0  —  Last change: 5 July 1989