z/OS Communications Server: IP Programmer's Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


X Window System toolkit

z/OS Communications Server: IP Programmer's Guide and Reference
SC27-3659-02

An X Window System Toolkit is a set of library functions layered on top of the X Window System Xlib functions that allows you to simplify the design of applications by providing an underlying set of common user interface functions. Included are mechanisms for defining and expanding interclient and intracomponent interaction independently, masking implementation details from both the application and component implementor.

An X Window System Toolkit consists of the following:
  • A set of programming mechanisms, called Intrinsics, that are used to build widgets.
  • An architectural model to help programmers design new widgets, with enough flexibility to accommodate different application interface layers.
  • A consistent interface, in the form of a coordinated set of widgets and composition policies, some of which are application domain-specific, while others are common across several application domains.

The fundamental data type of the X Window System Toolkit is the widget. A widget is allocated dynamically and contains state information. Every widget belongs to one widget class that is allocated statically and initialized. The widget class contains the operations allowed on widgets of that class.

An X Window System Toolkit manages the following functions:
  • Toolkit initialization
  • Widgets and widget geometry
  • Memory
  • Window, data set, and timer events
  • Input focus
  • Selections
  • Resources and resource conversion
  • Translation of events
  • Graphics contexts
  • Pixmaps
  • Errors and warnings

You must remap many of the X Widget and X Intrinsics routine names. This remapping is done in a header file called XT@REMAP.H. This file is automatically included by the INTRINSIC.H header file. In debugging your application, see the XT@REMAP.H file to find the remapped names of the X Toolkit routines.

Some of the X Window System header data sets have been renamed from their original distribution names, because of the data set naming conventions in the MVS™ environment. Such name changes are generally restricted to those header files used internally by the actual widget code, rather than the application header files, to minimize the number of changes required for an application to be ported to the MVS environment.

In porting applications to the MVS environment, you might have to make changes to header file names in Table 1.

Table 1. X Intrinsic header file names
MIT distribution name TCP/IP name
CompositeI.h ComposiI.h
CompositeP.h ComposiP.h
ConstrainP.h ConstraP.h
IntrinsicI.h IntriniI.h
IntrinsicP.h IntriniP.h
PassivGraI.h PassivGr.h
ProtocolsP.h ProtocoP.h
SelectionI.h SelectiI.h
WindowObjP.h WindowOP.h

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014