HP OpenVMS Systems Documentation

HP DECwindows Motif for OpenVMS
New Features

V1.3

The client-side extension library (DECW$XEXTLIBSHR) has been updated to support multithreading and new header files for the following extensions available as part of the upgrade to X11R6.6:

• Application Group (XC-APPGROUP)
• Colormap Utilization Policy (TOG-CUP)
• Extended Visual Information (EVI)
• Low-Bandwidth X (LBX)
• Security (SECURITY)
• Synchronization (SYNC)
• X Double Buffer (DBE)
• XINERAMA (formerly PanoramiX)
• X Print (Xp)

All extensions in the library (new and existing) have been made thread-safe (as described in Section 4.1.1). In addition, the minor version of the library has been updated from 2,2 to 2,3 to prevent images linked against the updated DECW$XEXTLIBSHR from loading the incorrect version of the library.

Also, function names longer than 31 characters have been replaced by macro definitions compatible with the current version of the OpenVMS Linker.

See Section 4.7.1 for an overview of each of these extensions. For instructions on how to link to this library, see Section 4.6.9.

4.6.4 Support for LCNs

V1.3

Xlib now provides an alternate means of obtaining connection numbers for connections to DECwindows Motif Version 1.3 or higher servers. The logical connection number (LCN) interface was specifically designed to support the communication needs of X11R6 systems and is intended as a replacement for the EFN mechanism.

The following functions and macros are designed for use with the new LCN interface:

• XAddConnectionWatch function (registers watch procedure)
• XInternalConnectionNumbers function
• XConnectionNumber function
• ConnectionNumber macro

These Xlib functions and macros are described in the Xlib - C Language X Interface, X Consortium Standard, X Version 11, Release 6.4 specification available from X.Org.

Note for compatibility with DECwindows Motif for OpenVMS Version 1.2--6 and earlier clients, the existing event flag mechanism remains unchanged, and the XtAppAddInput function accepts both EFNs and LCNs. However, HP recommends that new applications, in particular ones that use multithreading, use LCNs. When Xlib has multithreading enabled, EFNs are not available. If a multithreaded application uses EFNs without multithreading enabled in Xlib, the EFN should be restricted to a single thread--the same thread used for all X calls.

For more information about the LCN interface and its available routines, see Section 4.8.2.

4.6.5 Updated X11 Environment Variable Parsing

V1.3

Xlib now accepts the equivalent X11 Release 6 (X11R6) POSIX-compliant forms of the following environment variables:

On connection to the X display server, Xlib checks the variable name. If the OpenVMS variable is not defined, Xlib checks for the X11R6 equivalent before returning a status value.

4.6.6 Additional Non-C Language Bindings Available with X11R6.6

Non-C language bindings (such as Fortran and Pascal) for the following Xlib functions have been added to DECwindows Motif Version 1.3. These bindings are in addition to those documented in the DECwindows Motif for OpenVMS Guide to Non-C Bindings.

• X$CLOSE_OM
• X$CONTEXTUAL_DRAWING
• X$CONVERT_CASE
• X$DESTROY_OC
• X$DIRECTIONAL_DEPENDENT_DRAWING
• X$DISPLAY_OF_OM
• X$EXTENDED_MAX_REQUEST_SIZE
• X$INIT_IMAGE
• X$INIT_THREADS
• X$INTERNAL_CONNECTION_NUMBERS
• X$LOCALE_OF_OM
• X$LOCK_DISPLAY
• X$OPEN_OM
• X$PROCESS_INTERNAL_CONNECTION
• X$REGISTER_IM_INSTANTIATE_CB
• X$SET_AUTHORIZATION
• X$UNLOCK_DISPLAY
• X$UNREGISTER_IM_INSTANTIATE_CB

OpenVMS Format

status_return = X$CLOSE_OM

(om)

Argument Information

OpenVMS Format

status_return = X$CONTEXTUAL_DRAWING

(font_set)

Argument Information

OpenVMS Format

X$CONVERT_CASE

(sym, lower, upper)

Argument Information

OpenVMS Format

X$DESTROY_OC

(oc)

Argument Information

OpenVMS Format

status_return = X$DIRECTIONAL_DEPENDENT_DRAWING

(font_set)

Argument Information

OpenVMS Format

display_return = X$DISPLAY_OF_OM

(om)

Argument Information

OpenVMS Format

req_size_return = X$EXTENDED_MAX_REQUEST_SIZE

(display)

Argument Information

OpenVMS Format

status_return = X$INIT_IMAGE

(ximage)

Argument Information

OpenVMS Format

status_return = X$INIT_THREADS

Argument Information

OpenVMS Format

status_return = X$INTERNAL_CONNECTION_NUMBERS

(display, fdptr, nptr)

Argument Information

OpenVMS Format

return_value = X$LOCALE_OF_OM

(om, return_string)

Argument Information

OpenVMS Format

X$LOCK_DISPLAY

(display)

Argument Information

OpenVMS Format

om_return = X$OPEN_OM

(display, db, str1, str2)

Argument Information

OpenVMS Format

X$PROCESS_INTERNAL_CONNECTION

(display, fdptr)

Argument Information

OpenVMS Format

return_value = X$REGISTER_IM_INSTANTIATE_CB

(display, database, name_str, class_str, callback, client_data)

Argument Information

OpenVMS Format

X$SET_AUTHORIZATION

(name, data)

Argument Information

OpenVMS Format

X$UNLOCK_DISPLAY

(display)

Argument Information

OpenVMS Format

return_value = X$UNREGISTER_IM_INSTANTIATE_CB

(display, database, name_str, class_str, callback, client_data)

Argument Information