GDDM IBM System Customization and Administration Version 3 Release 2 SC33-0871-02 GDDM IBM System Customization and Administration Version 3 Release 2 SC33-0871-02 Note! Before using this information and the product it supports, be sure to read the general information under “Notices” on page xv. |Third Edition (December 2001) This edition applies to these IBM GDDM licensed programs: Program number Program name Version Release Modification | 5695-167 GDDM/MVS 3 2 0 | 5684-168 GDDM/VM 3 2 0 | 5686-057 GDDM/VSE 3 2 0 | GDDM/MVS as an element of OS/390 (program number 5645-001) and to all subsequent versions, releases, and modifications until otherwise indicated in new editions. Consult the latest edition of the applicable IBM system bibliography for current information on this product. Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the addresses given below. At the back of this publication is a page titled “Sending your comments to IBM”. If you want to make comments, but the methods described are not available to you, please address them to: IBM United Kingdom Laboratories, Information Development, Mail Point 095, Hursley Park, Winchester, Hampshire, England, SO21 2JN. When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. This publication contains sample programs. Permission is hereby granted to copy and store the sample programs into a data processing machine and to use the stored copies for internal study and instruction only. No permission is granted to use the sample programs for any other purpose. Copyright International Business Machines Corporation 1980, 2001.All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. contents Contents Notices . xv Programming interface information ........................... xv Trademarks and service marks ............................ xvii Preface . xix Who this book is for ................................... xix What you need to know ................................ xix How to use this book .................................. xix Summary of changes ................................. xxi Latest GDDM information .............................. xxiii GDDM publications . xxiii Books from related libraries .............................. xxiv Part 1. GDDM output . 1 Chapter 1. An introduction to GDDM output families .............. 3 Family-1 output . 3 Family-2 printing . 3 Family-2 printing in the VM environment ...................... 4 Family-2 printing in the CICS environment ..................... 4 Family-2 printing in the TSO environment ..................... 5 Family-2 printing in the IMS environment ...................... 5 The family-2 header page ............................... 5 Family-2 plotting . 6 Error reporting by the GDDM print utility ...................... 6 Family-3 printing . 7 Family-4 printing . 7 Chapter 2. The GDDM/VM Print Utility, ADMOPUV ................ 9 Invoking ADMOPUV explicitly .............................. 9 Invoking ADMOPUV automatically .......................... 10 Sending output to an RSCS destination ....................... 10 Transmitting print files to a disconnected virtual machine using ADMQPOST . 11 Directing VM family-2 output to family-4 devices .................. 14 Chapter 3. The GDDM/MVS Print Utilities, ADMOPUT and ADMOPUJ ... 15 The TSO Print Utility, ADMOPUT ........................... 15 Setting up the GDDM Master Print Queue .................... 16 How to invoke ADMOPUT ............................. 18 Running multiple instances of ADMOPUT .................... 20 Stopping ADMOPUT . 21 | Using the Print Queue Manager (PQM) ...................... 21 How to cancel a job submitted to ADMOPUT .................. 22 Printing alphanumeric files ............................. 23 Messages . 24 The TSO Print Utility, ADMOPUJ, with JES/328X ................. 24 Installing JES/328X . 24 Copyright IBM Corp. 1980, 1996 iii contents Some examples of print requests directed via JES/328X ............ 25 | Changing the program that processes your spooled print output ....... 27 | Selecting different paper types for your spooled print output .......... 27 Printing alphanumeric files via JES/328X ..................... 28 The interface between GDDM and JES ...................... 28 jesgddm.The interface between JES/328X and GDDM ............ 29 Chapter 4. The GDDM/VSE Batch Print Utility, ADMUPRTC ......... 31 Printing documents under VSE/Batch ........................ 31 Customizing the printing process for documents under VSE/Batch ...... 32 Printing page segments under VSE/Batch ...................... 33 Tailoring the batch job that ADMUPRTC initiates .................. 34 Tracing . 38 Editing the ADMUPRTC panels .......................... 38 Chapter 5. Printing and viewing composite documents ........... 39 How to invoke ADM4CDUx .............................. 39 Values passed to ADM4CDUx ........................... 40 Invoking ADM4CDUx — example for 4224 printer ................ 41 Invoking ADM4CDUx — example for 38xx AFPDS printer ........... 43 Displaying and printing double-byte character data ................. 44 Printers that support composite documents ..................... 45 Color masters from CDPDS documents ....................... 46 Inline resources in AFPDS and CDPDS documents ................ 46 CDPU error reporting .................................. 46 Chapter 6. GDDM objects and other files .................... 47 Where GDDM objects are stored ........................... 49 Changing the default destination for GDDM objects ............... 49 Using private VSAM data sets ........................... 50 | GDDM-supplied CLISTs and JCL ........................... 50 Moving GDDM objects to another system or subsystem .............. 50 Converting GDDM objects and other files ...................... 53 Chapter 7. The Image Print Utility, ADMUIMPx ................. 57 Part 2. GDDM devices . 59 Chapter 8. Preparing devices for use with GDDM ............... 61 Preparing printers for use with GDDM ........................ 61 Defining 3270-data-stream printers and IPDS printers ............. 62 The 3268-2C printer ................................. 63 The 3287 printer ................................... 64 The 4224 IPDS printer ................................ 65 The 4234-11 IPDS printer .............................. 67 The 3812-2 IPDS printer .............................. 67 The 3816 IPDS printer ................................ 68 The 4028 IPDS printer ................................ 69 System printers . 70 pclkdis.GDDM-PCLK displays, printers and plotters ................ 70 os2ldsp.GDDM-OS/2 Link displays, printers, and plotters ............. 72 3270 terminals . 73 3278-2, 3278-3, and 3278-4 display stations ................... 74 iv GDDM System Customization and Administration contents 3279-3B, 3279-S3B, 3279-S3G, and 3279-03X color display stations .... 75 Distributed-function terminals (3179-G, 3192-G, 3472-G, 3472-M) ........ 75 Auxiliary devices attached to DFT terminals ................... 77 3193 display station and attached scanner ..................... 77 Customizing the 3193 for use with GDDM-IVU ................. 79 3270-PC/G and 3270-PC/GX workstations ..................... 80 3274 configuration . 81 ASCII graphics displays ................................ 81 A sample UDT for the Tektronix 4208 ....................... 83 A sample UDT for the DEC 340 .......................... 84 ASCII-graphics-input translation . 85 Saving plotter output in graphics language (IBM-GL) files ............. 86 Producing long plots .................................. 87 Using non-IBM plotters ................................. 89 Chapter 9. Reviewing the telecommunication network ............ 91 Checking a VTAM network ............................... 91 Queriable terminals and printers .......................... 91 Instructions for checking a VTAM network .................... 91 The PSERVIC operand of the MODEENT macro ................ 95 Default logmodes . 97 Part 3. GDDM default values ...................................... 99 Chapter 10. Creating your own device tokens ................. 101 The ADMM3270 macro ................................. 101 Operands of the ADMM3270 macro ........................ 103 Keywords of the ADMM3270 macro (all 3270 devices) ............. 106 Keywords of the ADMM3270 macro (IPDS devices only) ............ 112 An example of the ADMM3270 macro ...................... 115 The ADMMSYSP macro ................................ 116 The ADMMIMAG macro ................................ 117 Example of the ADMMIMAG macro ........................ 118 The ADMMAFP macro ................................. 118 Example of the ADMMAFP macro ......................... 120 | Creating your own PostScript device tokens with the ADMMPSCR macro ... 120 Chapter 11. GDDM font-emulation and conversion tables .......... 123 GDDM font-emulation table, ADM4FONT ...................... 123 Changing the ADM4FONT table .......................... 123 GDDM AFPDS-to-IPDS conversion table, ADMDKFNT .............. 125 Changing the ADMDKFNT table .......................... 125 GDDM code-page-identifier conversion table, ADM4CPID ............. 127 Changing the ADM4CPID table .......................... 127 GDDM font-global-identifier conversion table, ADM4FGID ............