TCP/IP for MVS, VM, OS/2 and DOS X Window System Guide Document Number GG24-3911-01 July 1994 International Technical Support Organization Raleigh Center Take Note! Before using this information and the product it supports, be sure to read the general information under “Special Notices” on page xv. Second Edition (July 1994) This edition applies to: • Version 2.2.1 of IBM TCP/IP for MVS, Program Number 5735-HAL for use with the MVS Operating System • Version 2.2 of IBM TCP/IP for VM, Program Number 5735-FAL for use with the VM Operating System • Version 1.2.5 of IBM AIXwindows Environment/6000, Program Number 5601-257 for use with AIX Version 3.2.5 for the RISC System/6000 • Version 2.0 of IBM TCP/IP for OS/2, Program Number 5622-086 for use with the OS/2 Operating System • Version 2.1.1 of IBM TCP/IP for DOS, Program Number 5621-219, and Version 3.3 of HCL-eXceed/DOS for use with the DOS Operating System. • Version 2.1.1 of IBM TCP/IP for DOS, Program Number 5621-219, and Version 3.3.3 of HCL-eXceed/W for use with the DOS Operating System and Microsoft Windows. Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address given below. An ITSO Technical Bulletin Evaluation Form for readers′ feedback appears facing Chapter 1. If this form has been removed, comments may be addressed to: IBM Corporation, International Technical Support Center Dept. 545, Building 657 P.O. Box 12195 Research Triangle Park, NC 27709 When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. Copyright International Business Machines Corporation 1992, 1994. All rights reserved. Note to U.S. Government Users — Documentation related to restricted rights — Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. Abstract The purpose of this document is to provide information pertinent to the implementation of the X Window Systems for TCP/IP under MVS, VM, AIX/6000, OS/2 and DOS. The document focuses on how to customize and use the X Window Systems provided by the following products: • IBM TCP/IP Version 2.2.1 for MVS • IBM TCP/IP Version 2.2 for VM • IBM AIXwindows Environment/6000 Version 1.2.5 • IBM TCP/IP Version 2.0 for OS/2 • HCL-eXceed/DOS Version 3.3 with TCP/IP Version 2.1.1 for DOS • HCL-eXceed/W Version 3.3.3 with TCP/IP Version 2.1.1 for DOS The intended audience for this document are customers and IBM system engineers who will evaluate and implement X Windows on one or more of the above platforms. It is assumed that the reader has a working knowledge of TCP/IP and each of the operating systems listed above. (195 pages) Copyright IBM Corp. 1992, 1994 iii iv X Window System Guide Contents Abstract . iii Special Notices . xv Preface . xvii Related Publications . xix Prerequisite Publications . xix Additional Publications . xix International Technical Support Center Publications ............... xx Acknowledgements . xxi Chapter 1. Introduction . 1 1.1 A Brief History ................................... 1 1.2 X Concepts . 2 1.2.1 Client/Server . 2 1.2.2 Client . 3 1.2.3 Server . 4 1.2.4 X Networking . 6 1.2.5 Fonts . 7 1.2.6 Colors . 9 1.2.7 Keyboard . 11 1.3 IBM X Window System Implementations .................... 11 1.3.1 MVS . 11 1.3.2 VM . 15 1.3.3 AIX/6000 . 18 1.3.4 OS/2 . 20 1.3.5 DOS . 24 Chapter 2. Installation . 25 2.1 ITSO Network Configuration ........................... 25 2.2 MVS . 25 2.2.1 Installation Verification for the MVS X Window System API ...... 26 2.2.2 Installing the MVS X Window System GDDM Interface ......... 28 2.3 VM . 31 2.3.1 Installation Verification for the VM X Window System API ....... 31 2.3.2 Installing the VM X Window System GDDM Interface .......... 33 2.4 AIX . 38 2.4.1 Basic Installation . 39 2.4.2 AIXwindows Environment/6000 Images .................. 41 2.5 OS/2 . 42 2.5.1 Setting Up OS/2 X Window System Server ................ 42 2.5.2 Installing PMX . 43 2.5.3 System Level . 44 2.5.4 Setting PMX to Start Automatically ..................... 44 2.5.5 Setting Environment Variables ....................... 45 2.5.6 Starting PMX . 46 2.6 Installing OS/2 X Window System Client and OS/2 OSF/Motif Kits ..... 46 2.6.1 Requirements to Use X Window System Client and the OSF/Motif Kit 47 2.6.2 Installing the X Window System Client Files ............... 47 Copyright IBM Corp. 1992, 1994 v 2.6.3 Installing the Programmer′s Toolkit .................... 47 2.6.4 Installing the OSF/Motif Kit Files ...................... 48 2.6.5 Installing from a Code Server ........................ 49 2.7 DOS . 50 2.7.1 Installation and Basic Configuration for HCL-eXceed/DOS ....... 50 2.7.2 Installation and Basic Configuration for HCL-eXceed/W ........ 53 Chapter 3. X Client Application Considerations .................. 59 3.1 Under MVS . 59 3.1.1 Compiling and Link-Editing under MVS .................. 60 3.1.2 MVS Application Resource File ....................... 69 3.1.3 Using GDDM Applications under MVS ................... 71 3.2 Under VM . 80 3.2.1 Compiling and Link-Editing Under VM ................... 80 3.2.2 VM Application Resource File ........................ 84 3.2.3 Using GDDM Applications under VM ................... 87 3.3 Under AIX/6000 . 97 3.3.1 Compiling and Linking under AIX/6000 .................. 97 3.3.2 Customizing Application Resources under AIX/6000 .......... 99 3.3.3 How to Start an AIX/6000 Client ..................... 101 3.4 Running OS/2 X Window Clients and OS/2 OSF/Motif Applications ... 103 3.4.1 Application Resource File ......................... 103 3.4.2 Running OS/2 X Window Clients and OSF/Motif Applications .... 105 3.4.3 Developing of X Window Client and OSF/Motif Applications ..... 111 3.4.4 Tips for Porting Applications from UNIX ................. 112 Chapter 4. Customizing the X Server ....................... 113 4.1 AIX/6000 X Server ................................ 113 4.1.1 AIXwindows Environment/6000 V1.2 ................... 113 4.1.2 Customizing Motif Window Manager ................... 116 4.1.3 Customizing Colors . 120 4.1.4 AIX/6000 X Fonts .............................. 122 4.1.5 Remapping the Keyboard Under AIX/6000 ............... 123 4.1.6 Controlling X Client Access to AIX/6000 ................. 125 4.1.7 Interoperability . 126 4.2 Customizing PMX . 126 4.2.1 Using the Configuration Notebook Program to Configure PMX ... 126 4.2.2 Keyboard Definition . 127 4.2.3 Window Control . 131 4.2.4 Controlling X Client Access to OS/2 ................... 132 4.2.5 Cursor Options ................................ 133 4.2.6 Customizing OS/2 Colors ......................... 134 4.2.7 OS/2 X Fonts ................................. 138 4.2.8 Using the PM Clipboard with PMX .................... 146 4.2.9 Other Options . 148 4.3 DOS . 149 4.3.1 Customizing HCL-eXceed/W for Windows Version 3.3.3 ....... 149 4.3.2 Customizing HCL-eXceed/DOS for DOS ................. 153 Chapter 5. Multivendor Interoperability . 157 5.1 Hewlett-Packard . 157 5.1.1 Hewlett-Packard as a Client ........................ 157 5.1.2 Hewlett-Packard as an X Server ..................... 159 Appendix A. MVS C/370 Catalogued Procedures ................ 163 vi X Window System Guide A.1 C/370 Compiler Catalogued Procedure EDCC ................ 163 A.2 C/370 Linkage Editor Catalogued Procedure EDCL ............ 165 Appendix B. Supplied Application Resource File Definitions for XCALC .. 167 Appendix C. Information on Zapping the VM GXDEMOx Programs ..... 177 Appendix D. Standard X Client Applications ................... 179 Appendix E. XEDIT Subcommands . 183 Glossary . 187 Index . 189 Contents vii viii X Window System Guide Figures 1. The Components of an X Window System . 3 2. An Example of the XLFD Font Description Convention . 8 3. MVS X Window System API . 13 4. VM X Window System API . 16 5. The Components of X . 19 6. X Window Application Layers . 23 7. Component of the Network Configuration at the ITSO Raleigh . 25 8. Display at an OS/2 X Server for XSAMP1 Sample X Client Program . 27 9. Display at an OS/2 X Server for XSAMP2 Sample X Client Program . 27 10. Display at an OS/2 X Server for XSAMP3 Sample X Client Program .. 27 11. Example of the Contents of userid.XWINDOWS.DISPLAY Data Set .... 27 12. Example of the STEPLIB CLIST for the X Window System GDDM Interface . 29 13. Display at an OS/2 X Server for the GXDEMO1 First Frame ........ 30 14. Example of the Output from the Q NSS NAME Command on VM ..... 35 15. Example of a Successful Run for INSTGDXD ................. 36 16. SMIT Installation Menu .............................. 40 17. Installing X Window Server ........................... 44 18. Syslevel from Test Installation ......................... 44 19. Automatic Startup from X Window System Server ............. 45 20. The PMX Control Window ............................ 46 21. Installing X Window System Client ....................... 48 22. Installing X Window System Client ....................... 49 23. System Maintenance Level from Test Installation .............. 49 24. Telnet Session to AIX to Start X Client Application ............. 52 25. Selected Installation Configuration ....................... 55 26. HCL-eXceed/W Window . 56 27. HCL-eXceed/W Configuration Window ..................... 56 28. Xstart ........................................ 57 29. Sample JCL to Compile XSAMP1 ....................... 61 30. Sample JCL to Link-Edit XSAMP1 ....................... 62 31. Sample JCL to Link-Edit XSAMP2 ....................... 63 32. Sample JCL to Link-Edit XSAMP3 ......................