graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

OPEN PHIGS (PHCL, WSCL, STCL, ARCL)

Purpose

Use Open PHIGS to open and initialize the graPHIGS API. Open PHIGS makes all the graPHIGS API subroutines available. Call Open PHIGS before invoking most other graPHIGS API subroutines.

This subroutine function initializes the graPHIGS API state list (PSL). Open PHIGS sets the system state to graPHIGS Open (PHOP), sets the workstation stae value to Workstation Closed (WSCL), sets the structure state value to Structure Closed (STCL), and sets the archive state value to Archive Closed (ARCL).

The External Defaults File (EDF) allows the application to modify the graPHIGS API system and workstation defaults. See The graPHIGS Programming Interface: Technical Reference, "Defaults and Nicknames," for contents and formats of the External Defaults File (EDF).

When your application issues this Open PHIGS subroutine, the graPHIGS API implicitly connects to a private nucleus, unless the EDF explicitly controls the connection to a specified nucleus. For your application to use the 6090 workstation, you must indicate it by using the DEFNUC default in the External Defaults File (EDF).

With Open PHIGS you cannot suppress nucleus creation via the External Defaults File (EDF).

The error file parameter determines the target for logged error messages.

To determine if the Open PHIGS subroutine was successful, use the Inquire System State Value subroutine.

See The graPHIGS Programming Interface: Technical Reference, "Defaults and Nicknames," for contents and formats of the External Defaults File (EDF).

Language Bindings

C

popen_phigs (err_file, mem_units);

Input Parameters

const char  *err_file

Name of the error file. This parameter determines the target for logged error messages. Handling of error messages varies depending on the error file character string and the environment (where 0<character string <=80). This parameter looks like a Unix AIX* file descriptor which consists of a [path]/filename[extension]. Path is the route of directories through the file system on an AIX system. Path is optional and ignored for MVS and VM. An example of a fullfile descriptor:

/phigs/errors/appl1

where:

path = /phigs which says go from the root directory to directory phigs
filename
extension = .appl1

The following rules apply to the name depending on which system the shell is running in:

AIX

If you did not specify the path, then the graPHIGS API uses the default directory at the time of the execution of the subroutine.

MVS, MVS/XA

filename - You must supply a filename. If you specify the extension, then as the filename you must specify the member name within a partition data set. If you do not specify the extension, then as the filename you must specify the DD-name of the partition data set.
extension - The extension is optional. If you specify the extension, then you must specify it as the DD-name of the partition data set including the member filename.

VM/CMS

filename - You must specify the filename.
extension - The extension is optional. If you specify the extension, then it is the filetype. If you do not specify the extension, then the graPHIGS API uses a filetype of AFMPELOG .
The graPHIGS API uses a filemode of A1.
The graPHIGS API makes the filename.extension upper case.

size_t mem_units

size_t units of memory available for buffer space. The graPHIGS API ignores this parameter.

FORTRAN

popph (errfil, bufa)

Input Parameters

integer errfil

Name of the error file. This parameter determines the target for logged error messages. (0=console, 1=afmerror) . Handling of error messages varies depending on the error file and the environment.

If the error file identifier has a value of 0:

AIX: Messages are sent to 'stderr '
MVS: Messages are logged to the console.
VM: Messages are logged to the console.

If the error file identifier has a value of 0:

AIX: Filename afmerror .
MVS: AFMERROR is the DDNAME of the dataset.
VM: Filename AFMERROR and filetype AFMPELOG .

integer bufa

Amount of units of memory available for buffer area. The graPHIGS API ignores this parameter.

Errors

1: FUNCTION REQUIRES STATE (PHCL, WSCL, STCL, ARCL)
450: SPECIFIED ERROR FILE IS INVALID

Related Subroutines

Close PHIGS

Inquire System State Value