CONTENTS Title Page Copyright Page Preface 1 Overview of VAXELN DECwindows 1.1 Overview of VMS DECwindows Motif 1.2 DECwindows Architecture 1.3 Overview of the User Environment 1.4 VMS DECwindows Motif Documentation 1.5 Interoperability Between Versions 1.5.1 Before Converting XUI Files 1.5.2 After Converting XUI Files 1.5.3 Giving Information to Application Users 2 VAXELN DECwindows Server 2.1 VAXELN DECwindows Server Image Components 2.1.1 Transport 2.1.2 Server 2.1.3 Device Drivers 2.2 Fonts 2.3 Keymap Files 2.4 Security 2.4.1 Creating Security Access Files 2.4.2 Using Security Access Files 2.5 Building the VAXELN DECwindows Server Image into VAXELN Systems 2.5.1 Selecting a Target Processor 2.5.2 Modifying System Characteristics 2.5.3 Describing the Serial-Line Controller 2.5.4 Describing Terminal Input Devices 2.5.5 Configuring the VAXELN DECwindows Server Image 2.6 Error Handling 3 VAXELN DECwindows Applications 3.1 Programming Environment Overview 3.2 Programming VAXELN DECwindows Applications 3.2.1 Using ELN SET DEFAULT to Set Defaults 3.2.2 Using OPEN DISPLAY to Set Defaults 3.2.3 Using VAXELN DECwindows Message Files 3.2.4 Using VAX Style Descriptors in VAXELN Pascal Applications 3.2.5 Using Xlib 3.2.5.1 Establishing Client-Server Connections 3.2.5.2 Managing Requests to the Server 3.2.5.3 Specifying Xlib Output Buffer Size 3.2.5.4 Synchronizing Processes Within Client Jobs 3.2.5.5 Handling Events 3.2.5.6 Handling Errors 3.2.6 Using the X Toolkit 3.2.6.1 Synchronizing Processes Within an X Toolkit Program 3.2.6.2 Specifying Language Variants 3.2.6.3 X Toolkit Resource Files 3.2.6.4 VAXELN XtResolvePathname 3.2.6.5 X Toolkit Routines in VAXELN Jobs 3.2.6.6 ADD INPUT Source Specification 3.2.7 Using the Motif Toolkit 3.2.7.1 Opening Application UID Files 3.2.7.2 User Interface Objects 3.2.7.3 Cut and Paste Functions 3.2.7.4 Resolution Independence 3.2.7.5 Application Development Tools 3.2.8 Using the XUI Toolkit 3.2.8.1 Using XUI Language Variants 3.2.8.2 Setting Up XUI Application Help 3.2.8.3 Reducing Memory Usage 3.3 Compiling Source Files and Linking Images 3.4 Building VAXELN DECwindows Applications 3.5 Activating DECwindows Applications at Runtime 4 Components of the VAXELN DECwindows User Environment 4.1 Motif Window Manager 4.1.1 Communicating Between MWM and Clients 4.1.2 Building the Motif Window Manager into VAXELN DECwindows Systems 4.1.3 Customizing the Motif Window Manager 4.2 XUI Window Manager 4.2.1 Building the XUI Window Manager into VAXELN DECwindows Systems 4.2.2 Customizing the Window Manager 4.3 Terminal Emulators 4.3.1 Modifying System Characteristics for the Terminal Emulators 4.3.2 Building the Console Emulator into VAXELN DECwindows Systems 4.3.2.1 Including the Console Driver in the System 4.3.2.2 Configuring the Console Device 4.3.2.3 Modifying DECwindows Console Emulator Characteristics 4.3.3 Building the VT3 xx Terminal Emulator into VAXELN DECwindows Systems 4.3.3.1 Configuring the Terminal Device 4.3.3.2 Modifying DECwindows VT3 xx Terminal Emulator Characteristics 5 Creating Realtime DECwindows Applications 5.1 Describing the Application 5.2 Programming the Application 5.2.1 Coding the User Interface 5.2.2 Coding the Application 5.2.2.1 Coding the Module Declarations 5.2.2.2 Coding the Main Program and Associated Routines 5.2.2.3 Coding the Clock Process Block and Associated Routines 5.3 Building the Application 5.3.1 Generating the UID File 5.3.2 Setting Up the Runtime Library Resources 5.3.3 Compiling the Source File 5.3.4 Linking the Object Module 5.3.5 Building the System Image 5.4 Running the Application 5.4.1 Downline Loading the Sample Application with the Debugger 5.4.2 Downline Loading the Sample Application with the Network Control Program A DECwindows Differences Summary B C Module for the Stopwatch Sample Application EXAMPLES 2-1 Access Trusted File 2-2 Access Allowed File 3-1 Polling for Events 3-2 Waiting for Events 3-3 Associating Callback Routines with VAXELN Kernel Objects and Timeout Values 3-4 Using Xlib with the X Toolkit 3-5 Using the ADD INPUT Intrinsic Routine with VAXELN Objects 3-6 Compiling and Linking VAXELN Pascal Application Programs 3-7 Compiling and Linking C Application Programs 3-8 Compiling and Linking Ada Application Programs 3-9 Activating DECwindows Applications 5-1 Sample Application UIL File 5-2 Sample Application Module Declarations 5-3 Sample Application Main Program 5-4 Sample Application Callback Routines 5-5 Sample Application Time Format Initialization Routine 5-6 Sample Application Digital Time Display Initialization Routine 5-7 Sample Application Analog Time Display Initialization Routine 5-8 Sample Application Clock Process Block 5-9 Sample Application Display Time Routine 5-10 Sample Application Format Time Routine 5-11 Sample Application Display Digital Time Routine 5-12 Sample Application Display Analog Time Routine FIGURES 1-1 DECwindows Architecture 1-2 Local VAXELN Client Configuration 1-3 Sample Distributed DECwindows Configuration 1-4 Sample DECwindows Multiprocessing Configuration 2-1 VAXELN DECwindows Server Image Components 2-2 Server Components 2-3 DECwindows Server Characteristics Menu 3-1 VAXELN DECwindows Development Model 3-2 Application Code, Xlib, and Server 3-3 VAXELN DECwindows Application Job 3-4 Motif Toolkit Components 3-5 Creating Widgets for a User Interface 3-6 Using UIL and MRM for VAXELN DECwindows Applications 4-1 Sample Configuration Using Console Emulator Windows 4-2 Terminal Emulator Window 4-3 DECwindows Console Characteristics Menu 4-4 DECwindows Terminal Emulator Characteristics Menu 5-1 Sample Application Widget Hierarchy 5-2 Running the Sample Application TABLES 1-1 Sample DECwindows User Interface 2-1 Keymap Files 2-2 Graphics Device Configuration 2-3 Contents of a Sample Data File 3-1 Prefixes for DECwindows Routines 3-2 Calling Conventions for VAXELN Applications 3-3 VAXELN DECwindows Default Names 3-4 VAXELN DECwindows Message Files 3-5 Xlib Routine Categories 3-6 Xlib Runtime Library Exceptions 3-7 Resource Database Default Names 3-8 Symbol Definition Files 3-9 Array Substitution Values 3-10 Typical DECwindows Application Program Description 4-1 Motif Window Manager Default Names 4-2 Files for Customizing the MWM 4-3 Typical Motif Window Manager Program Description 4-4 XUI Window Manager Default Names 4-5 Typical XUI Window Manager Program Description 5-1 Stopwatch Application's Form and Function 5-2 Sample Application System Builder Menu Edits A-1 VAXELN DECwindows and VMS DECwindows Differences