NAME

INQUIRE SYSTEM STATE VALUE − inquire state value of PHIGS

SYNOPSIS

C Syntax

void
pinq_sys_st ( sys_state )
Psys_st∗sys_state;OUT the system state

Required PHIGS Operating States

(∗, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE SYSTEM STATE VALUE to determine the current state of the PHIGS system. The state value may be either PHIGS open (PHOP) or PHIGS closed (PHCL). 

PHIGS must be opened with the OPEN PHIGS subroutine before any operations can be performed with the PHIGS subroutines.  This function may be used to verify that OPEN PHIGS was successful before performing additional PHIGS operations. 

C Output Parameters

sys_state
A pointer to a Psys_st enumerated variable in which the current state of the PHIGS system is returned.  Values for Psys_st are defined in phigs.h as follows:

typdef enum {
PSYS_ST_PHCL, /∗ PHIGS closed ∗/
PSYS_ST_PHOP /∗ PHIGS open ∗/
} Psys_st;

ERRORS

None

SEE ALSO

OPEN PHIGS (3P)
CLOSE PHIGS (3P)
EMERGENCY CLOSE PHIGS (3P)
INQUIRE ARCHIVE STATE VALUE (3P)
INQUIRE STRUCTURE STATE VALUE (3P)
INQUIRE WORKSTATION STATE VALUE (3P)

September 02, 1992