AIX Operating System
                                                            IBM AIX X-Windows
                                                                 User's Guide

                                                 Document Number SC23-2017-02
   EDITION Edition Notice
   Third Edition (March 1991)

   This edition applies to Version 2.1 of IBM AIX/RT X-Windows and Versions 1.1 and 1.2 of IBM AIX PS/2 X-Windows.

PREFACE      About This Book
PREFACE.1    Who Should Read This Book
PREFACE.2    How to Use This Book
   PREFACE.2.1  Highlighting
   PREFACE.2.2  Quick Reference Boxes
   PREFACE.2.3  For Japanese Locale Users
PREFACE.3    Related Publications

PREFACE About This Book
   This book shows you how to use the IBM AIX X-Windows licensed program.  It provides guide information about starting, running, installing, and customizing the X-Windows program and reference information on X-Windows commands and error messages.

PREFACE.1 Who Should Read This Book
   This book is intended for anyone using the IBM X-Windows program.  Before you can use this program, you must have the latest level of the AIX Operating System installed.  You must also have the level of the IBM AIX X-Windows licensed program appropriate for the type of hardware you are using.

PREFACE.2 How to Use This Book
   If the X-Windows program is not installed, first read Appendix A, "Installing AIX X-Windows," which gives you step-by-step instructions for installing this program.  This appendix also contains information about installing the X-Windows example programs.  Then read Chapter 1, "Getting Started with X-Windows," which shows you how to start and stop the X-Windows program and use such window management functions as opening, closing, moving, and resizing windows.  Should you want to customize the X-Windows program to suit your own needs or set your system up so that you can log in automatically to X-Windows, read Chapter 3, "Customizing X-Windows."

   The X-Windows commands are presented in alphabetic order in Chapter 2, "X-Windows Commands."  Before each command discussion is a syntax diagram which shows you how to enter the command correctly on the command line. This chapter also contains information to help you understand and read the syntax diagrams used in this book.  Appendix B, "X-Windows Error Messages" lists in numeric order the error messages you may receive while using the X-Windows program.  For each error message, a cause and corrective action is provided.

PREFACE.2.1 Highlighting
   This book uses different type styles to identify certain kinds of information.  General information is printed in the standard type style (the type style used for this sentence).  Other type styles alert the reader to special information.

New Terms             Each time a new term is introduced, its first
                      occurrence is printed in this type style (for
                      example, "the AIX Operating System file system").
                      These terms are defined in the glossary.

System parts          The names for keys, commands, files, file names,
                      and other parts of the system are printed in this
                      type style (for example, "the aixterm command").

Variable information  The names for information that you must provide
                      are printed in this type style (for example,
                      "type yourname").

Command Examples      Examples of commands in this book are shown in
                      black in this type style (for example, aixterm
                      -fg blue).

Info you are to type  Information that you should type or that appears
                      on your display screen is printed in blue in this
                      type style (for example, select move).
 

PREFACE.2.2 Quick Reference Boxes

   Each task in Chapter 1 begins with boxed instructions.  The instructions give you the basic information you need to perform the task.  The boxed instructions are similar to these:

+--- To Use A Quick Reference Box --------------------------------------+
¦                                                                       ¦
¦   Skip over the quick reference instructions the first time you read ¦
¦    a section.                                                         ¦
¦                                                                       ¦
¦   Use the quick reference instructions as a fast path through the    ¦
¦    book.                                                              ¦
¦                                                                       ¦
¦   Refer to the boxed instructions for a quick review.                ¦ ¦                                                                       ¦
+-----------------------------------------------------------------------+

   In some cases, detailed information follows the boxed instructions.  The detailed information supplements the boxed instructions and may include descriptions, examples, and illustrations.

PREFACE.2.3 For Japanese Locale Users
   The X-Windows software is the prime enabling software for multibyte character set (MBCS).  Like all standard programs in the AIX system, all commands, subcommands, and option flags must be put in ASCII.  The user must have the keyboard in ASCII entry mode for any instructions made to the X-Windows software.  After X-Windows is operating, the user can switch the keyboard to any of the Japanese text entry modes.  For specific information on MBCS, see AIX Guide to Multibyte Character Set (MBCS) Support and "Programming for an MBCS Environment" in AIX Operating System Programming Tools and Interfaces.

PREFACE.3 Related Publications

   For additional information, you may want to refer to the following AIX Operating System publications:

   AIX Commands Reference, SC23-2292 (Vol. 1) and SC23-2184 (Vol. 2),
    lists and describes the AIX/370 and AIX PS/2 Operating System
    commands.

   AIX Guide to Multibyte Character Set (MBCS) Support, GC23-2333,
    explains the basic concepts of AIX multibyte character set support and
    refers to other AIX books that contain more detailed information.

   AIX Messages Reference, SC23-2294, lists messages displayed by the AIX
    Operating System and explains how to respond to them.

   AIX Programming Tools and Interfaces, SC23-2304, describes the
    programming environment of the AIX Operating System and includes
    information about operating system tools that are used to develop,
    compile, and debug programs.

   AIX TCP/IP User's Guide, SC23-2309, describes the features of TCP/IP
    and shows how to install and customize the program.  It includes
    reference information on TCP/IP commands that are used to transfer
    files, manage the network, and log into remote systems.

   AIX Technical Reference, SC23-2300 (Vol. 1) and SC23-2301 (Vol. 2),
    describes the system calls and subroutines a programmer uses to write
    application programs.  This book also provides information about the
    AIX Operating System file system, special files, miscellaneous files,
    and the writing of device drivers.

   AIX X-Windows Programmer's Reference, SC23-2118, describes the
    X-Windows licensed program and provides information on X-Windows
    library functions, FORTRAN subroutines, protocols, and extensions.

   AIX PS/2 Keyboard Description and Character Reference, SC23-2037,
    describes the characters and keyboards supported by the AIX PS/2
    Operating System.  This book also provides information on keyboard
    position codes, keyboard states, control code points, code-sequence
    processing, and non-spacing character sequences.

   AIX PS/2 Usability Services User's Guide, SC23-2038, shows how to
    create and print text files, work with directories, start application
    programs, and do other basic tasks with Usability Services.

   Installing and Customizing the AIX PS/2 Operating System, SC23-2290,
    provides step-by-step instructions for installing the AIX PS/2
    Operating System and related programs.  This book also shows how to
    customize the operating system to suit the user's specific needs and
    work environment.

   Managing the AIX Operating System, SC23-2293, describes such
    system-management tasks as adding and deleting user IDs, creating and
    mounting file systems, backing up the system, repairing file system
    damage, and setting up an electronic mail system and other networking
    facilities.

   Using the AIX Operating System, SC23-2291, shows the beginning user
    how to use AIX Operating System commands to do such basic tasks as log
    in and out of the system, display and print files, and set and change
    passwords.  It includes information for intermediate to advanced users
    about how to use communication and networking facilities and write
    shell procedures.