Abstract for GDDM System Customization and Administration

Preface

Summary of changes

Latest GDDM information

• GDDM publications
• Books from related libraries

GDDM output

• An introduction to GDDM output families
• Family-1 output
• Family-2 printing
• Family-2 printing in the VM environment
• Family-2 printing in the CICS environment
• Family-2 printing in the TSO environment
• Family-2 printing in the IMS environment
• The family-2 header page
• Family-2 plotting
• Error reporting by the GDDM print utility
• Family-3 printing
• Family-4 printing
• The GDDM/VM Print Utility, ADMOPUV
• Invoking ADMOPUV explicitly
• Invoking ADMOPUV automatically
• Sending output to an RSCS destination
• Transmitting print files to a disconnected virtual machine using ADMQPOST
• Directing VM family-2 output to family-4 devices
• The GDDM/MVS Print Utilities, ADMOPUT and ADMOPUJ
• The TSO Print Utility, ADMOPUT
• Setting up the GDDM Master Print Queue
• How to invoke ADMOPUT
• Activating printers used by ADMOPUT
• Running multiple instances of ADMOPUT
• Stopping ADMOPUT
• Using the Print Queue Manager (PQM)
• How to cancel a job submitted to ADMOPUT
• Printing alphanumeric files
• Messages
• The TSO Print Utility, ADMOPUJ, with JES/328X
• Installing JES/328X
• Some examples of print requests directed via JES/328X
• Changing the program that processes your spooled print output
• Selecting different paper types for your spooled print output
• Printing alphanumeric files via JES/328X
• The interface between GDDM and JES
• jesgddm.The interface between JES/328X and GDDM
• The GDDM/VSE Batch Print Utility, ADMUPRTC
• Printing documents under VSE/Batch
• Customizing the printing process for documents under VSE/Batch
• Printing page segments under VSE/Batch
• Tailoring the batch job that ADMUPRTC initiates
• Tracing
• Editing the ADMUPRTC panels
• Printing and viewing composite documents
• How to invoke ADM4CDUx
• Values passed to ADM4CDUx
• Invoking ADM4CDUx -- example for 4224 printer
• Invoking ADM4CDUx -- example for 38xx AFPDS printer
• Displaying and printing double-byte character data
• Printers that support composite documents
• Color masters from CDPDS documents
• Inline resources in AFPDS and CDPDS documents
• CDPU error reporting
• GDDM objects and other files
• Where GDDM objects are stored
• Changing the default destination for GDDM objects
• Using private VSAM data sets
• GDDM-supplied CLISTs and JCL
• Moving GDDM objects to another system or subsystem
• Converting GDDM objects and other files
• The Image Print Utility, ADMUIMPx

GDDM devices

• Preparing devices for use with GDDM
• Preparing printers for use with GDDM
• Defining 3270-data-stream printers and IPDS printers
• The 3268-2C printer
• The 3287 printer
• The 4224 IPDS printer
• The 4234-11 IPDS printer
• The 3812-2 IPDS printer
• The 3816 IPDS printer
• The 4028 IPDS printer
• System printers
• pclkdis.GDDM-PCLK displays, printers and plotters
• os2ldsp.GDDM-OS/2 Link displays, printers, and plotters
• 3270 terminals
• 3278-2, 3278-3, and 3278-4 display stations
• 3279-3B, 3279-S3B, 3279-S3G, and 3279-03X color display stations
• Distributed-function terminals (3179-G, 3192-G, 3472-G, 3472-M)
• Auxiliary devices attached to DFT terminals
• 3193 display station and attached scanner
• Customizing the 3193 for use with GDDM-IVU
• 3270-PC/G and 3270-PC/GX workstations
• ASCII graphics displays
• A sample UDT for the Tektronix 4208
• A sample UDT for the DEC 340
• ASCII-graphics-input translation
• Structure of module ADMDGAIT
• How to use the ASCII-graphics-input translation table
• Saving plotter output in graphics language (IBM-GL) files
• Producing long plots
• Using non-IBM plotters
• Reviewing the telecommunication network
• Queriable terminals and printers
• Instructions for checking a VTAM network
• The PSERVIC operand of the MODEENT macro
• Default logmodes

GDDM default values

• Creating your own device tokens
• The ADMM3270 macro
• Operands of the ADMM3270 macro
• Keywords of the ADMM3270 macro (all 3270 devices)
• Keywords of the ADMM3270 macro (IPDS devices only)
• An example of the ADMM3270 macro
• The ADMMSYSP macro
• The ADMMIMAG macro
• The ADMMAFP macro
• Creating your own PostScript device tokens with the ADMMPSCR macro
• GDDM font-emulation and conversion tables
• GDDM font-emulation table, ADM4FONT
• Changing the ADM4FONT table
• GDDM AFPDS-to-IPDS conversion table, ADMDKFNT
• Changing the ADMDKFNT table
• GDDM code-page-identifier conversion table, ADM4CPID
• Changing the ADM4CPID table
• GDDM font-global-identifier conversion table, ADM4FGID
• Changing the ADM4FGID table
• GDDM DBCS code-page and font-conversion table, ADM4CFID
• Adding new DBCS fonts
• The GDDM default symbol sets
• Editing symbol sets
• Where symbol sets are held
• Replacing or editing the default symbol sets
• Replacing the default national language vector symbol set for CECP processing
• Replacing the default national language vector symbol set for non-CECP processing
• Instructions for editing and replacing a default symbol set
• Defining additional pattern sets for GDDM-PGF ICU users
• Translation of user-defined shading patterns
• The ADMDGTRN default module
• Table ADM00001
• Table ADM00002
• Table ADM00003
• Editing the contents of module ADMDGTRN
• Color-separation master tables
• The ADMMCOLT macro
• The ADMDJCOL module
• Customizing user defaults for PostScript printing
• Specifying the color mapping using the ADMMCLTB UDS
• Specifying symbol-set and font mapping using the ADMMTYPF UDS
• Mapping GDDM symbol sets to PostScript fonts
• Mapping IBM presentation-text fonts onto PostScript typefaces
• Specifying nicknames for PostScript output
• Coding nicknames for PostScript on VM/CMS
• Coding nicknames for PostScript on TSO
• GDDM's code-page support
• Extended Binary Coded Decimal Interchange Code (EBCDIC)
• Country extended code pages (CECPs)
• Other code pages supported by GDDM
• Code pages supported by GDDM
• How CECPs work
• Code-page conversion
• Application code page
• Installation code page
• Device code page
• Object code page
• What you should do about code-page conversion
• CECP support for users of extended character set RPQs
• Adding code-page tags to GDDM objects
• CGM code pages
• Enabling translation between Japanese code pages 290 (extended) and 1027
• Reconfiguring devices to enable translation
• Overwriting the device's code-page and character-set information
• The alphanumeric-defaults module, ADMDATRN
• Altering the alphanumeric defaults module
• Altering ADMDATRN to support the Arabic character set
• The structure of the alphanumeric defaults module
• Basic control information
• Translation tables in ADMDATRN
• Translation-type descriptor block
• Translation tables
• Setting up a new translation table
• Device-dependent translation tables
• CECP lookup table
• Code-page-to-code-page translation tables
• National-language-to-CECP lookup table
• CECP uppercase translation table
• ASCII code-page tables
• Direct code-page translation
• GDDM user-default specifications
• Ways of specifying user-default specifications
• Formats of user-default specifications
• Coding UDSs for an external defaults module
• Creating an external defaults module
• An example external defaults module
• Coding UDSs for an external defaults file
• Accessing an external defaults file
• Coding a UDS for an ESSUDS call
• Coding a UDS for an SPINIT or ESEUDS call
• Nickname user-default specifications
• The format of the nickname UDS
• Which nickname is implemented?
• Directing family-2 output to family-4 devices
• Some example nickname UDSs
• Updating GDDM default modules
• Updating GDDM default modules in the VM environment
• Updating GDDM default modules in the MVS environment
• Updating GDDM default modules in the VSE environment

GDDM performance and tuning

• Resource and capacity planning
• Virtual storage required by GDDM
• Reducing the amount of virtual storage needed by GDDM
• Workstation storage requirements for GDDM-PCLK
• Workstation storage requirements for GDDM-OS/2 Link
• DASD space required by GDDM
• DASD space required for user-created GDDM objects
• Understanding GDDM performance
• What governs GDDM resource usage
• How GDDM draws pictures
• What happens in a GDDM program
• GDDM hardware - how it works
• Order-driven devices
• Programmable devices
• Nonprogrammable devices
• Image devices
• Character devices
• Page printers
• Tuning and customizing by subsystem
• Hints and tips on efficient usage for all subsystems
• CICS tuning--background information
• Loading
• Packaging
• Controlling the data stream
• id=contgdm.Controlling GDDM in the processor
• CICS tuning--things you can do
• IMS tuning--background information
• Output of GDDM data streams
• Cross-domain considerations
• Use of nonrecoverable transactions
• Message Processing Region (MPR) priority
• Message queue and Communications I/O Pool sizes
• The Interactive Chart Utility and symbol editors under IMS
• IMS tuning--things you can do
• TSO tuning--background information
• Controlling the data stream
• Swapping
• TSO performance groups
• TSO tuning--things you can do
• VM tuning--background information
• Shared segment
• Time-outs for 3179-G, 3270-PC/G and /GX, 4224, and 5550 devices
• Repackaging for performance
• Background to repackaging
• How to repackage
• Provisos about packaging
• Repackaging the GDDM executable code on its own
• Levels of packaging stubs
• The contents of packaging stubs
• Which stubs to use
• Repackaging executable code with a utility or application program
• Special requirements for utilities
• Special requirements for application programs
• Eliminating dynamic loading completely
• Repackaging an application or utility with a special defaults module
• Repackaging for multiple subsystems
• Special requirements for various systems and subsystems
• Instructions for repackaging
• Examples of repackaging
• Repackaging executable code under IMS
• Repackaging ICU with executable code under TSO
• Repackaging GDDM/VSE with the initially loaded modules
• Repackaging executable code for subsystems under MVS
• Repackaging application program with executable code under VM

GDDM workstation support

• Working with GDDM-OS/2 Link
• Making GDDM-OS/2 Link available
• Installing GDDM-OS/2 Link
• National language support
• Installing GDDM-OS/2 Link for the first time
• Recovering from installation errors
• Testing GDDM-OS/2 Link
• Running GDDM-OS/2 Link
• Controling host-graphics support for each emulator session
• Choosing an alternative locator cursor for interactive graphics applications
• Removing GDDM-OS/2 Link
• Working with GDDM-PCLK
• Setting up terminal emulators for GDDM-PCLK
• IBM PC3270 Emulation Program, Entry Level, Versions 1.1, 1.2, and 2.0
• IBM Personal Communications/3270
• IBM 3270 Workstation Program Version 1.1
• IBM 3270 Workstation Program Version 1.2
• IBM 3270 Emulation Program (Version 3.05)
• Making GDDM-PCLK available
• Installing GDDM-PCLK
• Installing GDDM-PCLK for the first time
• Distributing GDDM-PCLK to your users
• National language support
• Stage 1: Receiving the GDDM-PCLK installation file
• Stage 2: Running the GDDM-PCLK installation file
• Stage 3: Running GDDM-PCLK with a GDDM application to complete the installation
• Testing GDDM-PCLK
• Starting GDDM-PCLK
• Restarting GDDM-PCLK
• Setting up GDDM-PCLK for your PC (option 4)
• Setting up: part 1
• Setting up: part 2
• Setting up: part 3
• Finishing setup
• Using GDDM-PCLK
• GDDM-PCLK in merged mode
• Running GDDM-PCLK in merged mode
• GDDM-PCLK-supplied control keys in merged mode
• Single-screen workstation
• Dual-screen workstation
• GDDM-PCLK-supplied control keys in merged mode
• Restarting GDDM-PCLK
• Exiting GDDM-PCLK
• Code pages on GDDM-PCLK
• Setting up GDDM-PCLK for your workstation (option 4)
• Creating PIF files
• Assigning keys in GDDM-PCLK
• Running GDDM-PCLK on a network
• Common problems with GDDM-PCLK
• The graphics cannot be displayed
• How to recover
• The graphics look wrong
• Black rectangle on the screen
• How to recover
• Graphics corrupted or colors incorrect
• How to recover
• The disk becomes full during automatic data transfer
• How to recover
• Printing and plotting with GDDM-PCLK
• Immediate and deferred plotting
• Immediate and deferred printing
• Printing or plotting files stored on a disk

Appendix A. External defaults

• External defaults: summary list
• External defaults: full descriptions

Appendix B. Processing options

• Processing options: summary list
• Processing options: full descriptions
• AUNLOCK (always-unlock-keyboard mode)
• BMSCOORD (coordination mode)
• CDPFTYPE
• CMSATTN (CMS attention handling)
• CMSINTRP (CMS PA1/PA2 protocol)
• COLORMAS (color-master table identifier)
• CPSPOOL (CMS CP SPOOL parameters)
• CPTAG (CMS CP TAG parameters)
• CTLFAST (User Control fast-path mode)
• CTLKEY (User Control key)
• CTLMODE (User Control)
• CTLPRINT (User Control print)
• CTLSAVE (User Control save)
• DEVCPG (device code-page)
• DEVCSET (set the device character set)
• FASTUPD (fast update mode)
• FRCETYPE (Output type definition)
• GINKEY (graphics input key)
• GRAYLINE (PostScript grayline attribute)
• HRIDOCNM (document name)
• HRIFORMT
• HRIPSIZE (output paper size)
• HRISPILL (spill file usage)
• HRISWATH (number of swathes)
• IMGINIT (image field initialization)
• INRESRCE (inline resources)
• INVKOPUV (automatic invocation of VM print utility)
• IPDSBIN (IPDS paper feed bin)
• IPDSCPI (IPDS characters per inch)
• IPDSIMSW (IPDS Image swathing)
• IPDSLPI (IPDS lines per inch)
• IPDSQUAL (IPDS printer quality)
• IPDSROT (IPDS Page rotation)
• IPDSTRUN (IPDS data-stream truncation)
• LCLMODE (local interactive graphics mode)
• LOADDSYM (load default symbol sets)
• OFDSTYPE (output file data-stream type)
• OFFORMAT (output file format)
• ORIGINID (origin identification)
• OUTONLY (output-only mode)
• PATTRAN (translating user-defined shading patterns)
• PCLK (GDDM-PCLK)
• PCLKEVIS (encoded data fields on personal computers)
• PLTAREA (plotting area)
• PLTDELAY (plot roll medium delay)
• PLTFORMF (plotter page feed)
• PLTPAPSZ (plotter paper size)
• PLTPENP (plotter pen pressure)
• PLTPENV (plotter pen velocity)
• PLTPENW (plotter pen width)
• PLTROTAT (plotter picture orientation)
• POSTPROC (Postprocessing of family-4 and GL output)
• PRINTCTL (print control options)
• PRINTDST (TSO family-2 and family-4 print-file destination)
• PRTPSIZE
• PRTROT
• PSCHAR (PostScript character storage)
• PSCNVCTL (CICS pseudoconversational control)
• SEGSTORE (retained or unretained mode)
• SPECDEV (special device)
• STAGE2ID (deferred device name-list for print utility)
• TOFILE (plot file output)
• TSOINTRP (TSO CLEAR/PA1 protocol)
• TSORESHW (TSO reshow protocol)
• WINDOW (window mode)

Appendix C. Device tokens supplied by GDDM

• Tokens for queriable terminals, plotters, and printers (family 1 or 2)
• Locally attached 3179 Models G1 and G2, 3192-G, and 3472-G displays
• Locally attached 3270-PC displays
• Locally attached 3270-PC/G workstations
• Locally attached 3270-PC/GX workstations
• Locally attached 3279 displays
• Remotely attached 3279 displays
• Plotters attached to 3179 Models G1 and G2, 3192-G, and 3472-G displays
• Special plotter tokens for non-IBM plotters
• Plotters attached to 3270-PC/G and /GX workstations
• Plotters attached to 5550-family workstations
• Locally attached 3262, 3268, and 3287 printers
• Remotely attached 3287 printers
• 3812 Model 2 IPDS printers with 3270 attachment feature
• 3816 IPDS printer with 3270 attachment feature
• Image display
• Image display with attached scanner
• 3112, 3116, 3912, and 3916 IPDS printers
• 4028 IPDS printers
• 4224 printers
• 4230 printers
• 4234 printers
• Tokens for Kanji devices and 3290 displays (family 1)
• Japanese displays and printers
• Japanese 5550-family workstations (nongraphics)
• Japanese 5550-family workstations (graphics)
• 3290 displays with APL, 16 partitions, whole screen and variable cell sizes
• Tokens for nonqueriable terminals and printers (family 1 or 2)
• 3277 display terminals
• 3278 display terminals
• Nonqueriable printers
• Tokens for ASCII devices (family 1)
• Tokens for GDDM-PCLK displays, printers, and plotters
• GDDM-PCLK workstation configurations
• GDDM-PCLK workstation configurations with a locally attached printer
• GDDM-PCLK workstation configurations with a locally attached plotter
• Tokens for system printers (family 3)
• System printers
• 1403 printers
• 3800 printers
• Tokens for cell-based AFPDS page printers (family 4)
• 3800 printer at 240 ppi: IM
• 3812 and 3816 printers at 240 ppi: GOCA, IOCA
• 3812 and 3816 printers supported by VM3812
• 3820, 3827, and 3828 printers at 240 ppi: IM
• 3825 printer at 240 ppi: GOCA, IOCA
• 3835 printer at 240 ppi: GOCA, IOCA
• 3112, 3116, 3912, 3916, 4028 printer at 300 ppi: GOCA, IOCA
• 4224, 4230 and 4234 printers at 144 ppi: GOCA, IM
• Tokens for PostScript printers (family 4)
• Generic level-1 monochrome printer
• Generic level-2 monochrome printer
• Generic level-1 color printer
• Generic level-2 color printer
• 4029 monochrome printer
• 4079 color printer
• Tokens for page printers (family 4)
• 3800, 3812, 3816, or 3820 printer
• 3112, 3116, 3912, 3916, 4028 printers
• 4250 printer
• Canonical (unformatted) bit image output

Appendix D. Name-lists

• Reserved names "*" and blanks
• Family-1 name-list
• CICS name-list
• VSE/Batch name-list
• IMS name-list
• TSO name-list
• MVS/Batch name-list
• VM name-list

Appendix E. APL and GDDM/MVS or GDDM/VM

Appendix F. The GDDM Object Import/Export utility (IMS)

Appendix G. Conversion table for GDDM and PostScript typefaces

Appendix H. Macros that are general-use programming interfaces

Glossary

Index