The recommended way of linking GKS is to use the GKS or GRAFLIB parameters to the CERNLIB command to provide automatic access to just the GKS library, or to both GKS and various higher level graphics packages which use GKS, notably the CERN Program Library packages GKSPACK (J551), HPLOT (Y251) and HIGZ (Q120). Further details on what follows may be obtained via the command FIND CERNLIB.
CERNLIB GKS
or
CERNLIB GKS3D
or
CERNLIB GRAFLIB (GTS2D [or (GTS3D]
The optional parameter '(GTS2D' or '(GTS3D' gives access to the 2D or 3D
GTS-GRAL libraries. In addition, the CERNLIB command
provides access to three versions of each library: OLD,
PRO (default), and NEW.
For example, to access the previous library version use:
'GRAFLIB!OLD (GTS2D'.
Application programs must use VS FORTRAN. The optional INCLUDE files for the GKS parameters are kept in the data set 'GKSINCL MACLIB' on the automatically accessed Q-Disk.
The basic commands and tools to use GKS are:
To use the GKS include files one must give the command:
GLOBAL MACLIB GKSINCLbefore compiling the program. Within the code, the files may be included by using the construct:
INCLUDE (ENUM) INCLUDE (GTSDEV)where the first file contains the ENUMeration types, and the second contains the GTS-GRAL DEVice types. No compiler options are necessary.
An alternative method to access the information in the include files would be via the PATCHY utility by using the KEEP sequences of GTSDEV and ENUM stored in the PATCH GKSINCL on the GKSPACK Pam file. To access this Pam file on IBM type GIME CERNPAMS.
Full information on GKS under VM can be found by using the command FIND GKS and for the higher level packages via FIND HPLOT, FIND GKSPACK, FIND NAGLIB, FIND HIGZ, and FIND PAW. The example programs listed in the Appendix of the GKS/GKS-3D Primer are available on the disk accessed via GIME GKS with the file names:
GKSEXn FORTRAN (where n = 1, 6)
The GKS and GSK-3D libraries released in October 1989 are compatible with
the IBM XA exploitation mode.