NAME

INQUIRE DYNAMICS OF STRUCTURES − inquire the dynamics of structures for a workstation type

SYNOPSIS

C Syntax

void
pinqdynstruct ( type, error_ind, dynamics )
Pwstypetype;workstation type
Pint∗error_ind;OUT error indicator
Pmodstruct∗dynamics;OUT structure dynamics

FORTRAN Syntax

SUBROUTINE pqdstr ( WTYPE, ERRIND, STRCON, POST, UNPOST, DELETE, REFMOD )
INTEGERWTYPEworkstation type
INTEGERERRINDOUT error indicator
INTEGERSTRCONOUT structure content
INTEGERPOSTOUT posting a structure
INTEGERUNPOSTOUT unposting a structure
INTEGERDELETEOUT deleting a structure
INTEGERREFMODOUT reference modification

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE DYNAMICS OF STRUCTURES to determine the dynamics of changes to structure contents and posting for a specified workstation type. 

The possible dynamic modification accepted values are the same in C or FORTRAN: PIRGModification leads to an Implicit Regeneration.  PIMMModification is performed Immediately, without an implicit regeneration.  PCBSModification Can Be Simulated before an implicit regeneration is permitted. 

C Input Parameters

type
The workstation type whose capabilities are inquired.

C Output Parameters

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

dynamics
A pointer to a structure in which the system returns the dynamic modification accepted values for various structure manipulations.  Pmodstruct is defined in phigs.h as follows:

typedef struct {
Pmodtypecontent;/∗ structure content ∗/
Pmodtypepriority;/∗ structure priority ∗/
Pmodtypepost;/∗ post structure ∗/
Pmodtypeunpost;/∗ unpost structure ∗/
Pmodtypedelete;/∗ delete structure ∗/
Pmodtypereference;/∗ structure reference ∗/
} Pmodstruct;

The Pmodtype enumeration holds the dynamic modification accepted value, one of the values PIRG, PIMM, or PCBS. 

FORTRAN Input Parameters

WTYPE
The workstation type of the workstation whose capabilities are inquired.

FORTRAN Output Parameters

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

STRCON
STRCON is the dynamic modification accepted value for structure content changes or structure editing. 

POSTPOST is the dynamic modification accepted value for structure posting. 

UNPOST
UNPOST is the dynamic modification accepted value for structure unposting. 

DELETE
DELETE is the dynamic modification accepted value for structure deletion. 

REFMOD
REFMOD is the dynamic modification accepted value for structure reference modifications.  This value applies to calls to CHANGE STRUCTURE IDENTIFIER, CHANGE STRUCTURE REFERENCES, and CHANGE STRUCTURE IDENTIFIER AND REFERENCES. 

ERRORS

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

051Ignoring function, this information is not yet available for this workstation type; open a workstation of this type and use the specific workstation type

052Ignoring function, workstation type not recognized by the implementation

059Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

062Ignoring function, this information is not available for this MO workstation type

SEE ALSO

PHIGS WORKSTATION DESCRIPTION TABLE(7)

Sun Release 4.0  —  Last change: 13 July 1989