TM G D D Installation and System Management for VM ---- ------------ --_-------- - - ---.- Front Cover Pattern: Electronic Sunflower The pattern on the front cover was produced by a GDDM program. The program to produce this pattern, and many variations of the pattern, is published in: • GDDM Application Programming Guide • GDDM Base Programming Reference SC33·0323·2 File No. S370/4300/VM·34 G D D Installation and System Management for VM GDDM/VM, 5664·200 Version 2 Release 2 GDDM Interactive Map Definition, 5668·801 Version 2 Release 1 GDDM·PGF, 5668·812 Version 2 Release 1 GDDM/VMXA,5684·007 Version 2 Release 2 GDDM·IVU, 5668·723 Release 1 GDDM.GKS, 5668-802 Release 1 GDDM·REXX, 5664·336 Release 1 Licensed Programs ---- -------- ---- -----_____---- - --- t_ Third Edition (January 1988) This edition applies to the following IBM GDDM+-series licensed programs: Program name program number program level GDDM/VM (Graphical Data Display Manager) 5664-200 Version 2 Release 2 Modification 0 GDDM/VMXA 5684-007 Version 2 Release 2 Modification 0 GDDM-PGF (Presentation Graphics Facility) 5668-812 Version 2 Release 1 Modification 0 GDDM Interactive Map Defmition (GDDM-IMD) 5668-801 Version 2 Release 1 Modification 0 GDDM-IVU (Image View Utility) 5668-723 Release 1 GDDM-GKS (Graphical Kernel System) 5668-802 Release 1 GDDM-REXX 5664-336 Release 1 Changes and additions to the text and illustrations are indicated by revision bars (vertical lines) to the left of the change. A summary of changes is given on page xvii. Information about IBM publications and how to submit comments is given on page vii. References in this publication to IBM products, programs, or services do not imply that IBM intends to make these available in all countries in which IBM operates. Any reference to an IBM licensed program in this publication is not intended to state or imply that only IBM's licensed program may be used. Any functionally equivalent program may be used instead. No part of this GDDM Installation and System Management manual may be reproduced in any form or by any means, including storing in a data processing system, without permission in writing from IBM. Permission is hereby granted to licensees of GDDM/VM Version 2 Release 2 Modification 0, or GDDM/VMXA Version 2 Release 2 Modification 0, but to no other person, to copy and store the sample programs included in this manual into a data processing system and to modify and use the stored programs in accordance with their Agreement for Licensed Program. No permission is granted to use the sample programs in any other circumstances. THE PUBLICATION OF THE INFORMATION CONTAINED HEREIN IS NOT INTENDED TO AND DOES NOT CONVEY ANY RIGHTS OR LICENSES, EXPRESS OR IMPLIED, UNDER ANY IBM PATENTS, COPYRIGHTS, TRADEMARKS, MASK WORKS OR ANY OTHER INTELLECTUAL PROPERTY RIGHTS 01lIER THAN THE LIMITED PERMISSION GIVEN ABOVE. + GDDM is a trademark of International Business Machines Corporation. © Copyright International Business Machines Corporation 1980, 1981, 1983, 1984, 1986, 1987, 1988 All rights reserved. preface Preface What this book Is about This book provides the infonnation needed to install and manage the following licensed programs: • GDDM"/VM, program number 5664-200 • GDDM/VMXA, program number 5684-007 • GDDM-PGF, program number 5668-812 • GDDM Interactive Map Definition (GDDM-IMD), program number 5668-801 • GDDM Image View Utility (GDDM-IVU), program number 5668-723 • GDDM-GKS, program number 5668-802 • GDDM-REXX, program number 5664-336. GDDM-GKS is an implementation of the Graphical Keme1 System. GDDM-REXX is a productivity tool that lets GDDM be used from EXECs written for the VM/SP or VM/XA SP System Product Interpreter. Who this book Is for This book is for system programmers experienced in installing IBM licensed programs. What you need to know This book assumes that you have experience in using CMS EXECs. How to use this book This book is divided into three parts, corresponding to before installation, installation, and after installation, followed by a number of appendixes. It should be used sequentiallj to install GDDM. After installation it can be used for reference. Terminology Throughout this book, unless otherwise specifically detailed, all references to VM can be taken to include VM/XA; details are given in Chapter 1. Throughout this book the term GDDM is used to apply to the licensed programs listed on page 3, together with the National Language (NL) no-charge special features of GDDM/yM, GDDM/VMXA, GDDM-PGF, GDDM-IVtJ, and GDDM-GKS, and the PCLKF feature of GDDM/VM or GDDM/VMXA. " GDDM is a trademark of International Business Machines Corporation Preface iii books The GDDM library Introduction GDDM General Information and brochures GBOF-0058 GDDM General Information GC33-0319 GDDM If you make business presentations ... (brochure) GC33-0455 GDDM If you're an engineer ... (brochure) GC33-0456 GDDM Release Guide GC33-0320 General GDDM Image View Utility SC33-0479 GDDM-REXX Guide SC33-0478 GDDM Interactive Map Definition SC33-0338 GDDM-PCLK Guide User's Guides GDDM Guide for Users SC33-0327 GDDM-PGF Interactive Chart Utility SC33-0328 GDDM Image Symbol Editor SC33-0329 GDDM-PGF Vector Symbol Editor SC33-0330 GDDM-PCLK Reference Summary (booklet) SX33-6067 GDDM-CSPF User's Guide SC33-0552 GDDM Typefaces and Shading Patterns SC33-0554 Programming GDDM Application Programming Guide (two volumes) SC33-0337 GDDM Base Programming Reference (two volumes) SC33-0332 GDDM Base Programming Reference Summary (booklet) SX33-6053 GDDM-PGF Programming Reference SC33-0333 GDDM-PGF Programming Reference Summary (booklet) SX33-6054 GDDM-GKS Programming Guide and Reference SC33-0334 Systems GDDM Installation and System Management for MVS SC33-032l GDDM Installation and System Managementfor VM SC33-0323 +- this book GDDM Installation and System Managementfor VSE SC33-0322 GDDM Performance Guide SC33-0324 GDDM-CSPF Installation Guide SC33-0SS3 Diagnosis GDDM Messages SC33-0325 GDDM Diagnosis and Problem Determination Guide SC33-0326 iv GDDM Installation and System Management for VM books Books from related libraries In addition to the GDDM library, you may need to refer to some of the following manuals: VM/SP VMjSP Installation Guide, SC24-5237 VMjSP Planning Guide and Reference, SC19-6201 VMjSP Operator's Guide. SC19-6202 VMjSP CP Command Referencefor General Users. GC19-6212 VMjSP System Programmer's Guide. SC19-6203 VMjSP CMS Command and Macro Reference, SC19-6209 VMjSP System Messages and Codes, SC19-6204 VMjSP System Product Interpreter Reference. SC24-5239 VM/XA SP VM/XA SP Planning. GC23-0378 VMjXA SP Installation and Service. SC23-0364 VMjXA SP Administration, SC23-0353 VMjXA SP CP Command Reference, SC23-0358 VMjXA SP CMS Command Reference, SC23-0354 VMjXA SP System Product Interpreter Reference, SC23-0374 API. VS APL for CMS: Terminal User's Guide, SH20-9067 APL2 Installation and Customization under CMS, SH20-9221 VM/VCNA VM/VCNA General Information, GC27-0501 VM/VCNA Installation, Operation and Terminal Use, SC27-0502 Networking Network Program Products Samples: VM SNA. SC30-3309 GDDM/ graPHIGS Installing GDDM/graPHIGS, SC33-SlOl Licensed Program Specifications, GH23-0001 Introducing graPHIGS, SC33-S100 Understanding graPHIGS, SC33-S102 Writing Applications with graPl/lGS, SC33-S103 Programmer's Reference/or graPHIGS. SC33-S104 Messages and Error Codes for graPHIGS, SC33-SlOS Programmer's Pocket Reference for graPHIGS, SC33-8107 Problem Diagnosis for graPHIGS, SC33-S10S I)rint Services Facility System Programmer's Guide for VM, S544-3511 Composed Document Installation and Operations, SC33-6135 Printing Facility IPDS Intelligent Printer Data Stream Reference, S544-3417 3117 Scanner IBM 3117 Scanner and IBM 3117 PC Adapter Guide to Operations, GA18-2477 IBM 3117 Scanner and Extension Unit Guide to Operations, GA1S-2478 IBM 3117 Scanner Hardware Maintenance and Service, SY18-21S9 IBM 3117 Scanner Technical Reference, SC18-21OS Preface V books 3118 Scanner Scanner Guide to Operations, GAIS-2475 High Speed Adapter Guide to Operations, GA18-2476 IBM 3118 Scanner Hardware Maintenance and Service, 8Y18-2158 High Speed Adapter Hardware Maintenance and Service, 8YIS-2167 Scanner Technical Reference, 8ClS-2104 High Speed Adapter Technical Reference, 8C1S-2117 3179-G, 3192-G 3179-G and 3192-G Color Graphics Display Station Description, GA18-2589 3193 Display station Description, GA lS-2364 Setup Instruction, GA18-2366 Operator's GUide, GA1S-2365 Problem Solving Quick Check Guide, GAIS-2443 Problem Solving Guide, GAI8-2444 3270-family devices 3270 Information Display System Configurator, GA27-2849 3270 Information Display System Data Stream Programmeris Reference, GA23-0059 8775 Display Terminal: Component Description, GA33-3044 3270-PC/G and Introducing the IBM 3270 Personal ComputerlG and IGX Ranges of Work Stations, 3270-PC/GX work GA33-3I57 stations 3270-PCIG Personal ComputerlG and IGX Ranges of Work Stations,' Planning Guide, GA33-3I58 3270-PC/G Guide to Operations, GA33-3140 3270-PC/GX Guide to Operations, GA33-3139 Graphics Control Program User's Guide and Reference, 8C33-0207 (for IBM 3270-PC/G and PC/GX) Graphics Control Program Version 3.2 User's Guide, 8C33-0368 (for IBM 3270-PC AT/G and PC ATIGX) Graphics Control Program Version 3.2 User's Reference, 8C33-0372 (for IBM 3270-PC AT/G and PC AT/GX) 3274 3274 Control Unit Description and Programmer's Guide, GA23-0061 3274 Control Unit Planning, Setup and Customization Guide, GA23-2827 3812 ))rinter IPDS Handbook, 8544-3102 IPDS NDS Attachment Feature