=;The OpenVMS Frequently Asked Questions (FAQ)D

The OpenVMS Frequently Asked Questions (FAQ)



 r \ ^  
PreviousContentsIndex



DVersions of HP C such as V6.0 include the capability to extract the Ccontents of the standard header libraries into directories such as FSYS$SYSROOT:[DECC$LIB...], and provide various logical names that can Cbe defined to control library searches. With HP C versions such as GV6.0, the default operations of the compiler match the expectations of ?most OpenVMS programmers, without requiring any definitions of Esite-specific library-related logical names. (And logical names left Dfrom older DEC C versions can sometimes cause the compiler troubles locating header files.)

HHP C V5.6 and later include a backport library, a mechanism by which HP AC running on older OpenVMS releases can gain access to newer RTL Hroutines added to the RTL in later OpenVMS releases---the language RTLs 5ship with OpenVMS itself, and not with the compilers.

EExample C code is available in SYS$EXAMPLES:, in DECW$EXAMPLES (when Gthe DECwindows examples are installed), in TCPIP$SERVICES (or on older Freleases, UCX$EXAMPLES) when HP TCP/IP Services is installed), on the *Freeware CD-ROMs, and at web sites such as



HFor additional information on the OpenVMS Ask The Wizard (ATW) area and Bfor a pointer to the available ATW Wizard.zip archive, please see 0Section 3.8.<

10.22.1 Other common C issues



BThe localtime() function and various other functions maintain the Hnumber of years since 1900 in the "struct tm" structure member tm_year. GThis field will contain a value of 100 in the year 2000, 101 for 2001, Aetc., and the yearly incrementation of this field is expected to continue.

GThe C epoch typically uses a longword (known as time_t) to contain the Gnumber of seconds since midnight on 1-Jan-1970. At the current rate of Dconsumption of seconds, this longword is expected to overflow (when Ginterpreted as a signed longword) circa 03:14:07 on 19-Jan-2038 (GMT), Eas this time is circa 0x7FFFFFFF seconds since the C base date. (The >most common solution is to ensure that time_t is an unsigned.)

EIf C does not correctly handle the display of the local system time, Fthen check the UTC configuration on OpenVMS---the most common symptom Fof this is a skew of one hour (or whatever the local daylight savings Htime change might be). This skew can be caused by incorrect handling of Dthe "is_dst" setting in the application program, or by an incorrect <OpenVMS UTC configuration on the local system. (See section 1Section 4.3.)

FFloating point is prohibited in OpenVMS Alpha inner-mode (privileged) Gcode, and in any process or other execution context that does not have Bfloating point enabled. C programmers developing and working with DOpenVMS Alpha high-IPL kernel-mode code such as device drivers will Hwant to become familiar with the floating point processing available in 3the environment, and with the C compiler qualifier F/INSTRUCTION_SET=[NO]FLOATING_POINT. Device drivers and other similar )kernel-mode C code must be compiled with @/INSTRUCTION_SET=FLOATING_POINT and /EXTERN_MODEL=STRICT_REFDEF.

FAdditionally, the SYS$LIBRARY:SYS$LIB_C.TLB/LIBRARY parameter will be Hneeded to be appended to the module specification or declared via the C Fcompiler's include library logical name mechanism when the C compiler Gis resolving kernel-mode data structures and definitions. This library Acontains OpenVMS kernel-mode and other system declaractions, and Eparticularly a mixture of undocumented definitions and declarations, Band particularly definitions and declarations that are subject to >change (and that can accordingly lead to requirements for the #recompilation of application code).

GIn addition to the user-mode C Run-Time Library (RTL) mentioned in the lOpenVMS C RTL documentation and referenced over in Section 3.9, there Fis a second and parallel kernel-mode RTL accessable to device drivers Hand other kernel code on OpenVMS Alpha and OpenVMS I64. The most common Ftime this second C library is noticed is when C code is (erroneously) Glinked with /SYSEXE/SYSLIB, and duplicate symbol errors typically then Aarise. As code running in supervisor-, executive- or kernel-mode Hcontext cannot call out a user-mode RTL or other user-mode library, you Gwill want to respecify the command as LINK /SYSEXE/NOSYSLIB. This will Beliminate the duplicate symbol errors, since only the kernel-mode Hlibrary will be referenced, and it will also avoid calling out into the user-mode libraries.

GWhen sharing variables with other languages, here is some example HP C code...

 

"
      ...        #pragma extern_model save )      #pragma extern_model strict_refdef "      extern int   VMS$GL_FLAVOR; #      #pragma extern_model restore 
      ... 




1and here is some associated example Bliss code...

 

"
      ...       EXTERNAL          VMS$GL_FLAVOR,       .... 


?

10.22.2 Other common C++ issues



EHP C++ (a separate compiler from HP C) provides both symbol mangling Band symbol decoration. Some of the details of working with longer Fsymbol names and the resulting symbol name mangling in mixed language Henvironments are listed in the shareable image cookbook, and in the C++ Adocumentation. Symbol name decoration permits the overloading of Hfunctions (by adding characters to the external symbol for the function Ato indicate the function return type and the argument data types Hinvolved), and mixed-language external references can and often do need Dto disable this decoration via the extern "C" declaration mechanism:

 

"
      extern "C" 
        { )        extern int ExternSymbol(void *); .        extern int OtherExternSymbol(void *); 
        } 




aAlso see Section 14.7 for information on /ARCHITECTURE and /OPTIMIZE=TUNE.

iSee Section 10.15 for information on the C system and the lib$spawn call in CAPTIVE environments.

EConstructs such as the order of incrementation or decrementation and Athe order of argument processing within an argument list are all Dimplementation-defined. This means that C coding constructs such as:

 

"
    i = i++;     a[i] = i++;     foo( i, i++, --i); 




Eare undefined and can have (adverse) implications when porting the C Ccode to another C compiler or to another platform. In general, any Hcombination of ++, --, =, +=, -=, *=, etc operators that will cause the Fsame value to be modified multiple times (between what the ANSI/ISO C 8standard calls "sequence points") produce undefined and implementation-specific results.

FWithin C, the following are the "sequence points": the ";" at the end Dof a C statment, the ||, &&, ?:, and comma operators, and a Fcall to a function. Note specifically that = is NOT a sequence point, Gand that the individual arguments contained within a function argument Hlist can be processed from right to left, from left to right, or at any random whim.

AHP C for OpenVMS VAX (formerly DEC C) and VAX C do differ in the related processing.

DSo you are looking for OpenVMS-specific definitions (include files)?

FUCBDEF.H, PCBDEF.H and other OpenVMS-specific definitions---these are Dconsidered part of OpenVMS and not part of the C compiler kit---are /available on all recent OpenVMS Alpha releases.

2To reference the version-dependent symbol library Dsys$share:sys$lib_c.tlb, use a command similar to the following for compilation:

 

"
'$ CC sourcea+SYS$LIBRARY:SYS$LIB_C/LIB 




?You can also define DECC$TEXT_LIBRARY to reference the library.

=You will want to review the Programming Concepts manual, and -specifically take a quick look at Chapter 21.

CAnd some general background: the STARLET definitions (and thus the Hsys$starlet_c.tlb library) contain the symbols and the definitions that Fare independent of the OpenVMS version. The LIB definitions (and thus Hsys$lib_c) contain symbols and definitions that can be dependent on the FOpenVMS version. You won't need to rebuild your code after an OpenVMS Gupgrade if you have included definitions from STARLET. The same cannot Gbe said for some of the definitions in LIB---you might need to rebuild Byour code. (The UCB structure can and has changed from release to release, for instance.)

FRecent versions of C automatically search sys$starlet_c.tlb. Explicit +specification of sys$lib_c.tlb is required.

FAlso see the Ask The Wizard website topics (2486), (3803), and (1661):



HFor additional information on the OpenVMS Ask The Wizard (ATW) area and Bfor a pointer to the available ATW Wizard.zip archive, please see 0Section 3.8.

iSee Section 9.5 for information on the C off_t limitations, resolved Cin OpenVMS V7.3-1 and later and in ECO kits available for specific <OpenVMS releases. The use of a longword for off_t restricts Happlications using native C I/O to file sizes of two gigabytes or less, Dor these applications must use native RMS or XQP calls for specific operations.j

10.23 Status of Programming Tools on OpenVMS VAX?



HDECthreads V7.3 and the HP C compiler (also known as Compaq C and DEC C)@V6.4 are presently expected to be the last updates and the last Creleases of these development packages for use on OpenVMS VAX. The Erun-time support for both DECthreads (CMA$RTL) and for C (DECC$CRTL) will continue to beHmaintained, and will continue to be available on OpenVMS VAX. The VAX C GV3.2 compiler is the final VAX C compiler release for OpenVMS VAX, and Hthe VAX C Run-Time Library (VAXCRTL) will also continue to be available.

GNew development and new features and product enhancements continue for Cthe OpenVMS Alpha and the OpenVMS IA-64 DECthreads and C compilers.s

10.24 Choosing a Version Number for Application Code?



GOne of the common rules-of-thumb used for choosing a displayed version Hnumber string for a new version of a layered product or an application, Fits implications, and its expected effects on client applications and users, follows:



BFor additional version-numbering materials and for information on <assigning module generation numbers, please see the OpenVMS G(POLYCENTER) Software Product Installation Utility---variously refered Dto by acronyms including PCSI and SPIA---reference manual available %within the OpenVMS documentation set.

?Of course, all of this is obviously subject to interpretation, Hparticularly around the distinction between large and small changes and Hsuch. The scale of the application is also a factor, as larger and more Gcomplex applications will tend toward smaller increments and will tend Ato see the maintenance number incremented, while new releases of Dsmaller applications will tend to see the minor version incremented somewhat more frequently.

HThe goal of all this is to provide a guide to relative scale of changes Eand the associated effort involved in an upgrade for the user and/or for the application programmer.e

10.25 Selecting a Process Dump Directory?



CYou can customize the device and directory for the process dump by Fdefining the logical names SYS$PROCDMP and SYS$PROTECTED_PROCDMP. The Eformer is for non-privileged dumps, while the latter is the location Awhere privileged image dumps are written, and preferably an area 0protected against untrusted access. For example:

 

"
#$ define SYS$PROCDMP SYS$ERRORLOG: 3$ define /exec SYS$PROTECTED_PROCDMP SYS$ERRORLOG: 




CThe abouve presumes that the SYS$ERRORLOG logical name points to a valid location.

EThere is presently no means to change the name of the generated dump ;file from IMAGENAME.DMP to something else. Accordingly, you@will want to use different target directories for this purpose, >particularly if there is more than one application or process "potentially writing process dumps.^

10.26 Access to Itanium Assembler?



FIf you are interested in accessing the native Intel Itanium assembler =within the OpenVMS I64 GNV environment---and since the iasi64G assembler is a Unix program and GNV is a Unix environment for OpenVMS G I64---you can simply copy iasi64.ext into your gnu:[bin] directory in 5 place of "as.", and of "AS.EXE".

GAlternately and probably also better, you can write an "as." Cscript to invoke the iasi64.exe image from its particular prefered location on the local system.

1A typical "as." script looks like this:

 

"
path/iasi64.exe $1 $2 $3 $4 $5 





>

Chapter 11
DECwindows


A

If you are searching for something here, please (consider using the text-format FAQ.

z

11.1 How do I let someone else display something on my workstation?



FOn a workstation, you will want to use the "Customize" menu Eof the session manager utility and select "Security". When Dthe pop-up box appears, you can select the host node, username, and Gtranport that will allow you to launch an application that targets the workstation display.

DIf this does not provide you with access to the display, You need a checklist of sorts:

m

11.2 How do I create a display on another workstation?



HTo create a display from an OpenVMS host to a remote X Windows display, &use one of the following DCL commands:

 

"
A$ SET DISPLAY /CREATE /TRANSPORT=net_transport /NODE=remote_node 7$ SET DISPLAY /CREATE /TRANSPORT=LAT /NODE=remote_node :$ SET DISPLAY /CREATE /TRANSPORT=DECnet /NODE=remote_node 9$ SET DISPLAY /CREATE /TRANSPORT=TCPIP /NODE=remote_node 




BNote that LAT is typically used only for the VXT series X Windows Fterminals, but it can also be used from OpenVMS to OpenVMS systems on Gvarious OpenVMS releases, such as on OpenVMS Alpha V6.1 and later. For ddetails on configuring the TCP/IP transport, see Section 11.14.

?If you are interested in X Windows terminals and have an older FVAXstation system around, please see the EWS package on Freeware V5.0.z

11.3 How can I get the information from SHOW DISPLAY into a symbol?



AUse the undocumented SHOW DISPLAY/SYMBOL, and then reference the Dsymbols DECW$DISPLAY_NODE, DECW$DISPLAY_SCREEN, DECW$DISPLAY_SERVER and/or DECW$DISPLAY_TRANSPORT.

EAn example of calling the underlying (and also undocumented) sys$qio &programming interface for the WSDRIVER(WSAn:) is available at:

 

"
1- http://www.hp.com/go/openvms/freeware/  


FLook in the Freeware V4.0 directory /srh_examples/DECUS_UNDOC_CLINIC/.d

11.4 How do I get a log of a DECterm session?



HIf you are working from a DECwindows DECterm terminal emulator, you can Guse the AutoPrint feature. Choose the "Printer..." menu item Gfrom the "Options" menu, set the printing destination to the Hname of the file you want, and set "Auto Print Mode". You are now free to continue.

GIt should be noted that all of the characters and escape sequences are Gcaptured, but if you display the resulting log file on a DECterm, then 3you will see exactly what was originally displayed.

GYou can also use the "Print Screen" screen capture available Hin the DECwindows session manager menus, if you simply wish to snapshot .a particular portion of the X Windows display.

If you are using the FreewareBVTstar terminal emulator package, you will find a similar logging $mechanism is available in the menus.a

11.5 Why is DECwindows Motif not starting?



GFirst check to see if there is a graphics device, usually a G* device. H(eg: On a DEC 2000 model 300, use the command SHOW DEVICE GQ) If you do not find a graphics device:



)If there is a G* graphics device present:






 r Y \ ^  
PreviousNextContentsIndex