CONTENTS Title Page Copyright Page Preface 1 VAXELN DECwindows Overview 1.1 Basic DECwindows Architecture 1.2 User-Environment Overview 1.3 VMS DECwindows Documentation 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 Keyboard Map Files 2.4 Security 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 for VAXstation 2000 and VAXstation 3100 Workstations 2.5.4 Describing Terminal Input Devices for VAXstation 2000 and VAXstation 3100 Workstations 2.5.5 Configuring the VAXELN DECwindows Server Image 2.6 Error Handling 3 VAXELN DECwindows Applications 3.1 Programming Environment Overview 3.1.1 Xlib 3.1.2 XUI Toolkit 3.1.2.1 User Interface Objects 3.1.2.2 X Toolkit Routines 3.1.2.3 Cut and Paste Routines 3.1.2.4 Application Development Tools 3.2 Programming VAXELN DECwindows Applications 3.2.1 Setting Up Application Defaults 3.2.2 Setting Up Application Help 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 Synchronizing Processes Within Client Jobs 3.2.5.4 Handling Events 3.2.5.5 Handling Errors 3.2.6 Using the XUI Toolkit 3.2.6.1 Symbol Definition Files 3.2.6.2 Using the XUI Toolkit in VAXELN DECwindows Applications 3.2.6.3 ADD INPUT Intrinsic Routine 3.2.6.4 Timeout Callback Routine Format 3.2.6.5 Using UIL and DRM 3.3 Compiling Source Files and Linking Images 3.4 Building VAXELN DECwindows Applications into VAXELN Systems 3.5 Activating DECwindows Applications at Runtime 4 VAXELN DECwindows User-Environment Components 4.1 Window Manager 4.1.1 Building the Window Manager into VAXELN DECwindows Systems 4.1.2 Activating the Window Manager at Run Time 4.2 Terminal Emulators 4.2.1 Modifying System Characteristics for the Terminal Emulators 4.2.2 Building the Console Emulator into VAXELN DECwindows Systems 4.2.2.1 Including the Console Driver in the System 4.2.2.2 Configuring the Console Device 4.2.2.3 Modifying DECwindows Console Emulator Characteristics 4.2.3 Building the VT3 xx Terminal Emulator into VAXELN DECwindows Systems 4.2.3.1 Configuring the Terminal Device 4.2.3.2 Modifying DECwindows VT3 xx Terminal Emulator Characteristics 5 Creating Realtime DECwindows Applications 5.1 Programming the Application 5.1.1 Coding the User Interface 5.1.2 Coding the Application 5.1.2.1 Coding the Module Declarations 5.1.2.2 Coding the Main Program and Associated Routines 5.1.2.3 Coding the Clock Process Block and Associated Routines 5.2 Building the Application 5.2.1 Generating the UID File 5.2.2 Setting Up the Runtime Library Resources 5.2.3 Compiling the Source File 5.2.4 Linking the Object Module 5.2.5 Building the System Image 5.3 Running the Application 5.3.1 Down-Line Loading the Sample Application with the Debugger 5.3.2 Down-Line 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 Including Definition Files in DECwindows Application Programs 3-4 Including Symbol Definition Files in VAXELN Pascal Programs 3-5 Associating Callback Routines with VAXELN Kernel Objects and Timeout Values 3-6 Using Xlib with the XUI Toolkit 3-7 Using the ADD INPUT Intrinsic Routine with VAXELN Objects 3-8 Compiling and Linking VAXELN Pascal Application Programs 3-9 Compiling and Linking C Application Programs 3-10 Compiling and Linking FORTRAN Application Programs 3-11 Compiling and Linking Ada Application Programs 3-12 Activating DECwindows Applications 4-1 Activating the Window Manager 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 Basic 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 Client Components 3-2 Application Code, Xlib, and Server 3-3 XUI Toolkit Components 3-4 Creating Widgets for a User Interface 3-5 VAXELN DECwindows Application Job 3-6 Using UIL and DRM for VAXELN DECwindows Applications 4-1 Window Hierarchy 4-2 Sample Configuration Using Console Emulator Windows 4-3 Terminal Emulator Window 4-4 DECwindows Console Characteristics Menu 4-5 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 Keyboard Map Files 2-2 GAA Device Configuration 2-3 GAB Device Configuration 2-4 Contents of a Sample Data File 3-1 Xlib Routine Categories 3-2 VAXELN DECwindows Default Names 3-3 VAXELN DECwindows Message Files 3-4 Xlib Runtime Library Exceptions 3-5 Symbol Definition Files 3-6 Typical DECwindows Application Program Description 4-1 Typical 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