HP 3000 Manuals HP 3000 Manuals
HP Motif/iXTM Enhancements
by Scott Cressler and Robin Florentine
Commercial Systems Division
The following information describes some of the new technical procedures
for using HP Motif/iX A.01.00.
BUILD COMMAND FILES
There now are four command files that are distributed with HP Motif/iX.
The command files are 00019000 XCCXL, XCCXLLK, XCCXLGO and XLINK and are
explained below. 00022000 To use them, the following command should be
executed in a logon UDC or interactively:
:SETVAR HPPATH HPPATH + ",BIN.HPX11"
This command instructs the MPE/iX Command Interpreter (CI) to look for
command files and programs in the group BIN.HPX11.
All of these command files have help available by executing the command
file with the first parameter equal to "?", for example:
:XCCXLGO ?
Usage: :XCCXLGO srcfile,listfile[;INFO="ccopts"]
where:
srcfile is the HP Motif/iX client source file to be compiled.
listfile is the name of the listing file to be produced,
defaults to $STDLIST.
ccopts are any compiler options (such as -Aa for ANSI compilation).
:
COMPILING THE CLIENT
A simple example of an HP Motif/iX client application is included with
the product. The following command cimpiles this application:
:XCCXL PIZZAC.EXAMPLE.HPX11,PIZZAO,PIZZAL
This command invokes the C/iX compiler to compile the source file
PIZZAC.EXAMPLE.HPX11 into a local object file PIZZAO. The listing of the
compile is in the local file PIZZAL. The XCCXL command file instructs the
compiler to look for HP Motif/iX header files in H.HPX11.
LINKING THE CLIENT
Now the compiler has produced an object file. This object file must be
linked to the HP Motif/iX relocatable libraries, LIBXM.LIB.HPX11,
LIBXT.LIB.HPX11, and LIBX11.LIB.HPX11, to use X and OSF/Motif functions.
These libraries contain all OSF/Motif, Xt Toolkit, and X functions. The
following command will link the PIZZA application:
:XLINK PIZZAO,PIZZA
This command links the object file PIZZAO with the three HP Motif/iX
relocatable libraries into the program file PIZZA. The object file is
also linked to the LIBCINIT, LIBCRAND and LIBCANSI system relocatable
libraries which contain standard C functions used by the HP Motif/iX
libraries.
ADDITIONAL COMMAND FILES 00089000 There are two other command files that
are analogous to C/iX commands. They are XCCXLLK and XCCXLGO. XCCXLLK
compiles the client and then link it to the appropriate libraries.
XCCXLGO performs those functions, but it links the program into $OLDPASS
and then runs it.
NOTE For the program to execute successfully using the XCCXLGO command
file, a CI variable called DISPLAY must have been set containing
the specification of the X display on which the program is to
display.
UIL AND MRM
In addition to the new command files, a new feature of the HP Motif/iX
product is the User Interface Language (UIL) compiler. The full
description of the compiler and all of the options can be found in the
^fsOSF/Motif^+tm^- Programmer's Guide (B1171-90034). The following
information relates specifically to running the compiler on MPE/iX.
The UIL compiler can be invoked programmatically or by command. The
following example shows how to invoke the compiler by command.
:RUN UIL.BIN.HPX11;INFO="-o objfile -v listfile -m -w -Ih.hpx11 sourcefile"
The user can also invoke the compiler by command using implied RUN. If
HPPATH, the search path environment variable, includes BIN.HPX11, as
shown in an earlier example, the following command could be given to
invoke the compiler.
UIL "-o objfile -v listfile -m -w -Ih.hpx11 sourcefile"
If no object file is specified in the "-o" parameter, the object file
defaults to AUID. The default include groups are H.HPX11 and H.SYS. The
UIL compiler can also be invoked programmatically. The instructions for
doing this can be found in the OSF/Motiftm Programmer's Guide
(B1171-90034). An HP Motif/iX client application that uses UIL and
makes calls to the Motif Resource Manager (MRM) must be linked to
LIBMRM.LIB.HPX11. The XLINK command can be used to perform this link as
follows:
:XLINK MYPROGO,MYPROG;RL=LIBMRM.LIB.HPX11
CERTIFICATION AND TRADEMARKS
Hewlett-Packard certifies that HP Motif/iX is OSF/Motiftm R1.1 Validated
as tested with OSF/Motif Validation Test Suite R1.0.1 with no waivers.
Hewlett-Packard certifies that HP Motif/iX is compliant with the AES/UE
Revision B from Open Software Foundation, Inc.
Open Software Foundation, OSF, OSF/Motif and Motif are trademarks of Open
Software Foundation, Inc.
X Window System is a trademark of the Massachusetts Institute of
Technology.