[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]
The graPHIGS Programming Interface : Subroutine Reference
GPOPWS - Open Workstation
| GPOPWS
(wsid,
connid,
wstype) |
Purpose
Use
GPOPWS to open the specified workstation on
a nucleus with the identifier set to a value of one.
If a structure store is currently selected (structure
state is Structure Close (STCL) or Structure Open (STOP)), the graPHIGS API calls
the Associated Structure
Store with Workstation
(GPASSW)
subroutine
to associate the currently selected
structure store with the specified workstation.
This implicit association, along with the implicit
processing during Open graPHIGS
(GPOPPH),
,
allows the graPHIGS API to create
the correct processing environment for applications
unchanged from Version 1.
GPOPWS uses a nucleus identifier set to
a value of one to create the specified workstation.
If the nucleus identifier of value one does not
exist, then the graPHIGS API issues error
202
If you wish to use a nucleus identifier other than
value one, then you
must use the Create Workstation
(GPCRWS) subroutine.
If a connection identifier longer than eight characters is
required, then you must either issue the Create Workstation
(GPCRWS) subroutine
or you must define
a nickname in the Application Defaults Interface Block
(ADIB) or the External Defaults File
(EDF)
This subroutine is functionally equivalent to the Create
Workstation
(GPCRWS) subroutine
with a
nucleus identifier set to a value of one,
with the exception that
GPOPWS performs the implicit Associate Structure
Store with Workstation
(GPASSW)
processing.
Parameters
wsid -- specified by user, fullword integer
Workstation identifier.
connid -- specified by user,
8-byte character string
Connection identifier indicates the physical device to
be opened.
wstype -- specified by user,
8-byte character string
One of the graPHIGS API supported workstation types.
Error Codes
- 21
- CONNECTION IDENTIFIER IS INVALID
- 23
- SPECIFIED WORKSTATION TYPE DOES NOT EXIST
- 24
- SPECIFIED WORKSTATION IDENTIFIER ALREADY IS IN USE
- 26
- SPECIFIED WORKSTATION CANNOT BE OPENED
- 202
- SPECIFIED NUCLEUS DOES NOT EXIST
- 217
- RESOURCE CREATION REQUEST EXCEEDS NUCLEUS TABLE CAPACITY
- 514
- INAPPROPRIATE DEVICE FOR WORKSTATION TYPE
- 581
- PROCOPT SPECIFIES INVALID VIEW TABLE SIZE FOR WORKSTATION
- 583
- PROCOPT SPECIFIES INVALID NUMBER OF INPUT DEVICES FOR WORKSTATION
- 585
- PROCOPT SPECIFIES INVALID KEYBOARD FOR WORKSTATION
- 586
- PROCOPT SPECIFIES INVALID DISPLAY MODEL NUMBER FOR WORKSTATION
- 587
- PROCOPT SPECIFIES INVALID ECHO METHOD FOR WORKSTATION
- 588
- PROCOPT SPECIFIES INVALID FRAME BUFFER VALUE FOR WORKSTATION
- 596
- PROCOPT SPECIFIES INVALID NUMBER OF POLYLINE TABLE ENTRIES
- 597
- PROCOPT SPECIFIES INVALID NUMBER OF POLYMARKER TABLE ENTRIES
- 598
- PROCOPT SPECIFIES INVALID NUMBER OF TEXT TABLE ENTRIES
- 599
- PROCOPT SPECIFIES INVALID NUMBER OF EDGE TABLE ENTRIES
- 600
- PROCOPT SPECIFIES INVALID NUMBER OF DEPTH CUE TABLE ENTRIES
- 601
- PROCOPT SPECIFIES INVALID NUMBER OF LIGHT SOURCE TABLE ENTRIES
- 602
- PROCOPT SPECIFIES INVALID NUMBER OF INTERIOR TABLE ENTRIES
- 648
- PROCOPT SPECIFIES AN INVALID DISPLAY WIDTH AND/OR HEIGHT
- 649
- PROCOPT SPECIFIES AN INVALID IMAGE OUTPUT FORMAT
- 650
- PROCOPT SPECIFIES AN INVALID HLHSR COORDINATE SYSTEM
Related Subroutines
- GPATR
- Attach Resource
- GPCLWS
- Close Workstation
- GPCRWS
- Create Workstation
- GPDTR
- Detach Resource
- GPQRCT
- Inquire Realized Connection Type
- GPQWCT
- Inquire Workstation Connection and Type
- GPQWTN
- Inquire List of Available Workstation Types on Nucleus
RCP code
201327361
(X'0C000301')
[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]