Abstract for GDDM-GKS Programming Guide and Reference

Preface

• Latest GDDM information
• GDDM publications
• Books from related libraries
• Book structure

Introduction to GKS

• The ROOM program
• Using ROOM under VM/CMS
• Using ROOM under TSO
• Running the ROOM program

Using GKS

• Concepts of GKS
• Workstations
• Graphical output
• Coordinate systems
• Segments
• Graphical input
• GKS metafiles
• GKS operating states
• GKS data structures
• GKS functions
• GKS function types
• Control functions
• Output and attribute functions
• Specifying attributes
• Polyline
• Polymarker
• Fill area
• Text
• Cell array
• Generalized Drawing Primitive
• Transformation functions
• Normalization transformations
• Workstation transformations
• Segment functions
• Segment attributes
• Segment transformations
• Input functions
• Input classes
• Input modes
• Prompt and echo types
• Metafile functions
• Utility functions
• Inquiry functions
• Error handling
• Designing an interactive graphics program
• Argument conventions
• The ROOM program
• Program objectives
• ROOM program outline
• Initializing GKS
• Opening and activating workstations
• Normalization and workstation transformations
• Primitives and segments
• Choice input
• Pick input
• Creating a new segment
• Locator input
• Segment transformations
• Valuator input
• Accumulating transformation matrixes
• Deleting a segment
• Deactivating and closing workstations
• Closing GKS

Introduction to GDDM-GKS

• Relation to GDDM Base
• Relation to the GKS standard
• Differences between GDDM-GKS and the ISO and ANS GKS standards
• FORTRAN binding
• Programming languages other than FORTRAN
• Non-GKS external names

Using GDDM-GKS

• Invocation of GDDM-GKS functions
• The nonreentrant interface
• The reentrant interface
• The system programmer interface
• FORTRAN language considerations
• VS FORTRAN
• FORTRAN IV
• Considerations for languages other than FORTRAN
• PL/I
• COBOL
• Assembler language
• APL
• IBM BASIC
• Mixing GKS functions and other GDDM functions
• Mixing with graphical GDDM functions
• Mixing with non-graphical GDDM functions
• Implicit FSINIT and FSTERM
• GDDM hierarchy
• Error handling
• Using GDDM-GKS in a windowing environment
• Using GDDM-GKS workstations
• Physical devices
• Workstation type 1
• Workstation types 6 through 13
• 3270-PC/G and /GX ranges, 3179-G, 3278, and 3279
• 5080
• Plotters
• Printers
• Workstation independent segment storage
• GKS metafiles
• GDF files
• How workstations are opened
• Error handling in GDDM-GKS
• Standard GDDM-GKS error handling
• Application-defined error handling
• Error file information
• Using GDDM-GKS under various subsystems
• MVS, including use under MVS/XA
• Programming languages
• Data sets and file processing
• Compiling programs
• Link-editing programs
• Executing programs
• VM/CMS
• Programming languages
• Data sets and file processing
• Compiling programs
• Loading programs
• Executing programs

GDDM-GKS functions

• Syntax conventions
• APL and RCP codes
• Function type and summary of function
• Parameter types
• Valid parameter values
• Data types required for parameters
• Related functions
• GDDM-GKS restrictions
• Errors and error messages
• GKS function numbers
• Alphabetical list of functions
• List of functions by function type
• Control functions
• Output functions
• Output attributes
• Workstation-independent primitive attributes
• Workstation attributes (representations)
• Transformation functions
• Normalization transformation
• Workstation transformation
• Segment functions
• Segment manipulation functions
• Segment attributes
• Input functions
• Initialization of input devices
• Setting the mode of input devices
• Request input functions
• Sample input functions
• Event input functions
• Metafile functions
• Utility functions
• Inquiry functions
• Inquiry function for operating state value
• Inquiry functions for GKS description table
• Inquiry functions for GKS state list
• Inquiry functions for workstation state list
• Inquiry functions for workstation description table
• Inquiry functions for segment state list
• Pixel inquiries
• Inquiry function for GKS error state list
• Error-handling functions
• The GKS functions
• GACTM
• GACWK
• GASGWK
• GCA
• GCLKS
• GCLRWK
• GCLSG
• GCLWK
• GCRSG
• GCSGWK
• GDAWK
• GDSG
• GDSGWK
• GECLKS
• GERHND
• GERLOG
• GESC
• GEVTM
• GFA
• GFLUSH
• GGDP
• GGTCH
• GGTITM
• GGTLC
• GGTPK
• GGTSK
• GGTST
• GGTSTS
• GGTVL
• GIITM
• GINCH
• GINLC
• GINPK
• GINSG
• GINSK
• GINST
• GINSTS
• GINVL
• GMSG
• GMSGS
• GOPKS
• GOPWK
• GPL
• GPM
• GPREC
• GPRECS
• GQACWK
• GQASF
• GQASWK
• GQCF
• GQCHB
• GQCHH
• GQCHS
• GQCHSP
• GQCHUP
• GQCHW
• GQCHXP
• GQCLIP
• GQCNTN
• GQCR
• GQDCH
• GQDDS
• GQDLC
• GQDPK
• GQDSGA
• GQDSK
• GQDSP
• GQDST
• GQDVL
• GQDWKA
• GQECI
• GQEFAI
• GQEGDP
• GQENTN
• GQEPAI
• GQEPLI
• GQEPMI
• GQETXI
• GQEWK
• GQFACI
• GQFAF
• GQFAI
• GQFAIS
• GQFAR
• GQFASI
• GQGDP
• GQIQOV
• GQLCS
• GQLI
• GQLN
• GQLVKS
• GQLWK
• GQLWSC
• GQMK
• GQMKSC
• GQMNTN
• GQNT
• GQOPS
• GQOPSG
• GQOPWK
• GQPA
• GQPAF
• GQPAR
• GQPARF
• GQPCR
• GQPFAR
• GQPKID
• GQPKS
• GQPLCI
• GQPLF
• GQPLI
• GQPLR
• GQPMCI
• GQPMF
• GQPMI
• GQPMR
• GQPPAR
• GQPPLR
• GQPPMR
• GQPTXR
• GQPX
• GQPXA
• GQPXAD
• GQSGA
• GQSGP
• GQSGUS
• GQSGWK
• GQSIM
• GQSKS
• GQSTS
• GQSTSS
• GQTXAL
• GQTXCI
• GQTXF
• GQTXFP
• GQTXI
• GQTXP
• GQTXR
• GQTXX
• GQTXXS
• GQVLS
• GQWKC
• GQWKCA
• GQWKCL
• GQWKDU
• GQWKM
• GQWKS
• GQWKT
• GRDITM
• GRENSG
• GRQCH
• GRQLC
• GRQPK
• GRQSK
• GRQST
• GRQSTS
• GRQVL
• GRSGWK
• GSASF
• GSCHH
• GSCHM
• GSCHSP
• GSCHUP
• GSCHXP
• GSCLIP
• GSCR
• GSDS
• GSDTEC
• GSELNT
• GSFACI
• GSFAI
• GSFAIS
• GSFAR
• GSFASI
• GSHLIT
• GSLCM
• GSLN
• GSLWSC
• GSMCH
• GSMK
• GSMKSC
• GSMLC
• GSMPK
• GSMSK
• GSMST
• GSMSTS
• GSMVL
• GSPA
• GSPAR
• GSPARF
• GSPKID
• GSPKM
• GSPLCI
• GSPLI
• GSPLR
• GSPMCI
• GSPMI
• GSPMR
• GSSGP
• GSSGT
• GSSKM
• GSSTM
• GSTXAL
• GSTXCI
• GSTXFP
• GSTXI
• GSTXP
• GSTXR
• GSVIS
• GSVLM
• GSVP
• GSVPIP
• GSWKVP
• GSWKWN
• GSWN
• GTX
• GTXS
• GUREC
• GURECS
• GUWK
• GWAIT
• GWITM

Appendix A. GKS data structures

• Operating state
• GKS description table
• GKS state list
• Workstation state list
• Relevant for all workstation categories
• Relevant for output, output/input, WISS, and metafile output workstations
• Relevant for output, output/input, and metafile output workstations
• Relevant for input and output/input workstations
• Workstation description tables
• Relevant for all workstation categories
• Relevant for input, output, and output/input workstations
• Relevant for output and output/input workstations
• Relevant for input and output/input workstations
• Segment state list
• GKS error state list

Appendix B. GDDM-GKS enumeration types

Appendix C. Metafile structure

• Metafile item types
• Metafile item structure
• Control items
• Items for output primitives
• Items for output primitive attributes
• Items for workstation attributes
• Items for transformations
• Items for segment manipulation
• Items for segment attributes
• User items

Appendix D. ROOM program source code

Appendix E. Example programs

Appendix F. GDDM-GKS RCP codes

• RCP codes ordered by function name
• RCP codes ordered by code value

Appendix G. GDDM-GKS APL codes

• APL codes ordered by function name
• APL codes ordered by code value

Glossary

Index