2    Features and Interfaces Scheduled for Retirement

This chapter provides information on Tru64 UNIX features that have been retired from the operating system or that are scheduled to be removed from, or changed in, future major functional releases. This information is provided so that users and developers can migrate away from these features in the near future.

2.1    Retired in This Release

The following sections provide information on features that have been retired in this release. These changes were announced in previous releases. For information on features retired in previous releases, see the New and Changed Features from Previous Releases on the Version 5.1 Software Documentation CD-ROM.

2.1.1    DECwindows Applications

The following DECwindows utilities and tools have been retired from Tru64 UNIX. These dx* tools and utilities, commonly known as DECwindows, have been replaced by the dt* tools in Common Desktop Environment (CDE) that were introduced in Version 4.0. The replacement applications are listed in Table 2-1. Not all of the dx* applications that have been retired have a replacement due to the limited use or capability of that specific tool or utility.

Table 2-1:  Retired DECwindows Applications

Retired Tools/Utilities Replacement Option(s)
dxmail dtmail
dxprint None
dxcalendar dtcm
dxcalc dtcalc, xcalc
dxclock Front Panel, xclock
dxpaint dticon/dtstyle, bitmap
dxnotepad dtpad
dxbook dthelpview, Netscape
dxcardfiler None
dxsession xdm, dtsession
dxvdoc ghostview
libids None

It is recommended that you migrate to the dt* tools and utilities or other options as soon as possible.

The CDA applications in Table 2-2 have also been retired.

Table 2-2:  Retired CDA Applications

caspar cdoc ctod
ddifanls ddifps ddiftext
dtifanls dtifddif dtoc
textddif vdoc libcapsar
libcda libcda_be libcda_fe
libddif libddif_be libddif_fe
libimg libdvs libids_nox

2.1.2    DEC C Compiler Default Changed from -std0 to -std

The default language mode for the Tru64 UNIX C compiler has changed from -std0 to -std.

You can revert to the previous default language mode by adding the -std0 flag to the cc command line, the /usr/ccs/lib/cmplrs/cc/comp.config file, or the $DECC_CC environment variable definition.

2.1.3    Sendmail Version 5.65

The sendmail Version 5.65 utility has been retired.

This version of the operating system includes sendmail Version 8.9.3. The sendmail Version 8.9.3 Server provides advanced features such as the following:

These features can be configured using the web-based Mail Configuration Utility provided by Compaq's Open Source Software Collection, included with your kit.

For more information on sendmail Version 8, see the reference pages and documentation provided with the operating system, as well as Sendmail by Bryan Costales and Eric Allman, published by O'Reilly & Associates, Inc.

2.1.4    MH/POP

The Post Office Protocol (POP) service provided as part of the Rand Mail Handler (MH) subset (OSFMH) has been retired from the operating system. The following components were associated with this service:

The replacement for this functionality was provided in Tru64 UNIXVersion 5.0. This new service is an implementation based on Qualcomm's public domain POP3 service, known as popper. Its components are as follows:

It is important that you migrate all your existing MH/POP users to this new service. If you do not, run-time errors will occur because the old service no longer exists. Use the existing mailcv(1) and popcv(8) utilities to migrate existing MH/POP information into the new service.

The new service is the default.

2.1.5    The cc.alt Compiler

Previous releases provided an Alternative C Compiler and associated development tools (known as the cc.alt compiler), which shipped in the CMPDEVALT subset on the Associated Products Volume 1 CD-ROM. The cc.alt compiler was intended to deliver run-time performance improvements, using more recent compiler components than the corresponding Tru64 UNIX base operating system tools.

The cc.alt compiler is no longer provided with your kit. However, if you want a more recent compiler, you can download the Developers' Toolkit Supplement C compiler from the following URL:

http://www.unix.digital.com/dtk

Unlike the cc.alt compiler, after you install the DTK Supplement compiler, you invoke it using the cc command; it is documented in the cc(1) reference page.

After you install the DTK Supplement compiler, you invoke the regular base operating system C compiler using the cc -nodtk command; it is documented in the cc-notdk(1) reference page.

The DTK Supplement compiler is a fully supported, free upgrade for all users with an active Developers' Toolkit license. From time to time, the DTK web site might also include Advanced Development Kits, which will provide even more recent compiler components.

2.1.6    System V Environment

Tru64 UNIX provides 80 percent of the System V Interface Definition (SVID) standard, as verified by the SVVS 3 and SVVS 4 test suites. As a result, Tru64 UNIX contains a substantial number of System V Release 4 (SVR4) features and delivers the highest composite SVR4 conformance of any implementation. SVR4 functionality will be further expanded in the base operating system when the System V Environment reengineering is complete, eliminating the need for the layered product. A migration plan for upgrading to the appropriate version of the Tru64 UNIX base operating system has been developed to assist customers who currently use the System V Environment layered product. The System V Environment (SVE) product is not available as a separately licensed layered product with the Tru64 UNIX family. Instead, many of its features are being reengineered and will be merged into the operating system in future releases.

2.1.7    Assembler binasm Interface

The assembler component that is invoked from the as and cc commands has been reimplemented in this release. The new assembler component does not support the binasm interface that was utilized by the older assembler.

The binasm interface defined the contents of the intermediate file used to pass information from the first pass (as0) to the second pass (as1) of the old assembler. It was possible to produce this binasm interface file and to pass it to as1 as the input file. This interface was meant to be used by other compilers or language processors.

The identified users of the binasm interface are no longer using it. Therefore, the retirement of this support should not affect existing Compaq customers.

Note that in this release of the operating system, the old assembler is still distributed, even though it is no longer the default assembler.

2.1.8    NL*/NC* libc Interfaces

The NL*/NC* libc interfaces, which are a set of obsolete and undocumented internationalization-related APIs, have been retired in this release. This set of OSF/1 proprietary libc APIs are superseded by the Worldwide Portability Interface (WPI) based on the XPG4 standard that was introduced in DIGITAL UNIX Version 2.0.

The following table provides a list of the APIs that have been removed from the system:

NCchrlen NCcollate NCcoluniq NCdec
NCdechr NCdecode NCdecstr NCenc
NCencode NCflatchr NCencstr NCisNLchar
NCisalnum NCisalpha NCiscntrl NCisdigit
NCisgraph NCislower NCisprint NCispunct
NCisspace NCisupper NCisxdigit NCstrlen
NCtolower NCtoupper    
NLasctime NLcatgets NLcatopen NLchrlen
NLctime NLflatstr NLfprintf NLgetamsg
NLisNLcp NLprintf NLsprintf NLstrchr
NLstrcmp NLstrcpy NLstrdlen NLstrlen
NLstrncpy NLstrtime NLvfprintf NLvsprintf
NLyesno _NLxcolu    

2.1.9    POSIX Threads CMA Interface

The CMA interface of POSIX Threads (formerly DECthreads) has been retired and is no longer supported in Tru64 UNIX. Compaq recommends that you port your CMA-based application to the IEEE Std 1003.1-1996, POSIX System Application Program Interface provided by POSIX Threads Library.

2.1.10    OSF/Motif Version 1.1.3

Motif 1.1.3, which previously installed under the /usr/shlib/_null directory, has been retired in this release. Motif 1.2.4 has been the default version of Motif since the Version 4.0 release.

2.2    Features and Interfaces Scheduled for Retirement in Future Releases

This section provides information on features and interfaces that will be retired in future releases. This information is provided so you can begin planning for the time when these features are retired.

2.2.1    POSIX 1003.4a (Draft 4) pthread Routines in the POSIX Threads Library

The POSIX 1003.4a, Draft 4 interface of POSIX Threads (formerly DECthreads) will be retired in a future release of Tru64 UNIX. Applications that were written using the POSIX 1003.4a, Draft 4 API should be migrated to the IEEE Std. 1003.1-1996, POSIX System Application Program Interface provided by POSIX Threads. The POSIX 1003.1c standard interface is the most portable, efficient, and powerful programming interface offered by POSIX Threads. A compatibility mode for the POSIX 1003.4a, Draft 4, API has been provided to ease migration. This compatibility mode will be removed in a future release.

2.2.2    POSIX Threads Metering

The metering features of the POSIX Threads Library will be retired in a future release of the operating system. These features are described in the Guide to the POSIX Threads Library. If you want to collect statistical and historical information on synchronization objects, use Visual Threads, which is a tool that you can use to analyze and debug multithreaded programs.

2.2.3    Asynchronous I/O Binary Compatibility

Data structures for asynchronous I/O, such as aio_read() and aio_write(), changed between Version 3.2 and Version 4.0 of the operating system. The kernel currently handles these differences so that applications built under Version 3.2 continue to run when executed on Version 4.0x.

In the next major release of the operating system, support for applications built under Version 3.2x using asynchronous I/O will be discontinued. You will need to recompile and relink these applications to run under Tru64 UNIX Version 4.0D or higher.

2.2.4    SCSI Device Names

Support for rz and tz SCSI device names will be retired in a future release. Any code that derives knowledge about a device from the ASCII name or minor number might be impacted.

All code that uses the current name space will be compatible until the retirement because a mechanism that ensures binary compatibility has been provided.

Note that the compatibility name space can be used to access devices in only the old, limited address space and the new names can be used to access devices in only the new extended address space.

2.2.5    XIE Version 3.0 X Client Extension

Tru64 UNIX Version 4.0G supports XIE Version 5.0. Support for XIE Version 3.0 server extensions was removed in Version 4.0 of the operating system. Client support will be removed in a future release.

2.2.6    The atmsetup Script

The atmsetup script introduced in Version 4.0D of the operating system has been superseded by a new application. The new application is part of the SysMan suite, and provides a full graphical user interface. The atmsetup command now invokes the new SysMan application.

You can access the atmsetup script by including the -old flag with the atmsetup command.

The atmsetup script will be retired in a future release of Tru64 UNIX.

For more information on how to use the new atmsetup application, see the atmsetup(8) reference page and the Asynchronous Transfer Mode guide.

2.2.7    The installupdate -i Option

The -i option to the /sbin/installupdate command will be retired in a future release of the operating system.

The -i option currently allows you to interactively select kernel components after the new software subsets have been installed. Starting with the next major release, this flag will be unnecessary because you will be able to interactively select optional kernel components at the beginning of the update installation process, prior to software installation. These kernel components will be built into the kernel automatically during the kernel build phase at the end of the update installation; therefore, you need not be present at that time.

2.2.8    The pixstats Program-Analysis Command

The pixstats program-analysis command will be retired in a future release of the operating system. The pixstats command will be replaced by the prof -pixstats command, which became available in Version 4.0D and which provides a more complete and correct implementation of the same capabilities and flags.

2.2.9    ATM IP Switching Will Be Retired

Tru64 UNIX provides limited support for IP switching over ATM, based on the Ipsilon Networks Inc. reference model (RFC 1953 and 1954). This support will be retired in a future release.

IP switching support is provided in this release for backward compatibility only. Do not use it to develop new applications. Other methods of carrying IP over ATM, including classical IP and LAN emulation, will continue to be supported.

2.2.10    The ogated Routing Daemon

The ogated daemon (the old version of the gated routing daemon) will be retired in a future release of Tru64 UNIX. If you use the ogated routing daemon, you should migrate to the gated routing daemon, which supports a superset of functionality in the ogated daemon.

2.2.11    DEC Ada RTL

DEC Ada (UPI - 0HM) and DEC Ada PDO (UPI - 0VS) will be retired in a future release of Tru64 UNIX.

2.2.12    The /usr/include/userpw.h Header File

The /usr/include/userpw.h header file will be retired in a future release. This file was inadvertently shipped with earlier versions of the operating system. It contains prototypes for nonexistent functions and unused structures. It does, however, contain two definitions that you might have mistakenly used; password length, PW_PASSLEN, and user name length, PW_NAMELEN. These values are not appropriate for Tru64 UNIX.

The correct definition for password length is SIAMXPASSWORD in the sia.h file, or PASS_MAX in the limits.h file. The correct definition for user name length is LOGIN_NAME_MAX in the limits.h file, or L_cuserid in the stdio.h file.

It is recommended that you not use this file because it contains incorrect values.

2.2.13    Internationalized Print Filters dl1152wrof and dl5100wrof

The DEC Laser 1152 and 5100 printers are no longer being produced. Therefore, the corresponding internationalized print filters, dl1152wrof, and dl5100wrof, will be retired in a future release. The filters' functionality can be replaced by the new wwpsof print filter.

In this release, the dl1152wrof and dl5100wrof print filters have been moved to the IOSWWOBSOLETE subset within the Worldwide Language Support (WLS) software. The printcap entries for these print filters will be removed from the /etc/lprsetup.dat print filter in the next release.

In a future release, these print filters will be taken out of the kit and the installation procedure will convert the old /etc/printcap entries, which use the old print filters, to use the new wwpsof print filter.

2.2.14    Replacement of hiprof, pixie, and third Interfaces

The atom-tool interfaces documented in the hiprof(5), pixie(5), and third(5) reference pages will be retired in a future release. For compatibility with earlier releases, the interfaces remain in this release; however, the reference pages have been removed.

The interfaces have been superseded by the new hiprof, pixie, and third commands. The new commands are documented in the hiprof(1), pixie(1), and third(1) reference pages.

2.2.15    Default fork Support in hiprof and pixie

In a future release, the hiprof and pixie profilers will no longer default to using the -fork option when libc is instrumented. If the program being profiled will fork, the -fork option should be specified on the hiprof or pixie command line. Explicitly using the -fork option lets the profilers employ a more reliable algorithm for handling the fork. See the hiprof(1) and pixie(1) reference pages for more information.

2.2.16    The feedback Command

The feedback command will be retired in a future release. The pixie command provides all the same features more consistently, more reliably, and more effectively. In particular, the pixie command's -update option helps the compiler achieve significantly better optimizations than the feedback command's -feedback option, though pixie continues to support the -feedback option. See the pixie(1) reference page.

2.2.17    Event Report Formatter (uerf)

The Event Report Formatter (uerf) will be retired in a future release. The uerf command is not certified to be Y2K compliant. Depending on your system, use either Compaq Analyze or DECevent.

2.2.18    Ladebug to Replace dbx As the Default Debugger

In a future release, Ladebug will replace dbx as the default debugger.

When this change is implemented, the Ladebug debugger will be invoked by the dbx command and the dbx debugger will be invoked with the dbx -old command.

Note that despite efforts to make the two debuggers compatible, differences exist in the syntax accepted and the output produced by the debuggers. You might have to edit scripts that use dbx when this change occurs.

2.2.19    AdvFS Subsystem Attributes

The following AdvFS subsystem attributes will be retired in a future release:

In this release, setting these attributes does not affect kernel operations. Instead, their functionality has been replaced by new dynamic kernel algorithms. These algorithms aim to optimize system performance. Additionally, information on these attributes has been removed from the documentation.

2.2.20    AdvFS Fragment Attributes

The AdvFS subsystem attributes AdvfsMinFragGrps and AdvfsMaxFragGrps will be removed in a future release. Information on these attributes has been removed from the documentation.

2.2.21    Tcl Version 7.6 and Tk Version 4.2

Tcl Version 7.6 and Tk Version 4.2 will be retired in a future release. This release contains Tcl/Tk Version 8.2.

Tcl Version 7.6 and Tk Version 4.2 have been moved to the optional subsets OSRETIREDTCL76510 and OSRETIREDTK42510. These subsets will install under the /usr/opt/obsolete directory and only contain the runtime environment. Header files and reference pages are no longer included.

2.2.22    The dxlsm Interface

The CDE/X11 graphical Logical Storage Management tool, dxlsm, will be retired in a future release. The dxlsm interface is superseded by the new LSM Storage Administrator, lsmsa, which was introduced in Version 5.0 of the operating system.

Both the dxlsm and the lsmsa interfaces are installed from the OSFLSMX11510 or higher subset.

Compaq recommends you begin using the lsmsa interface to manage your LSM configurations.

2.2.23    Netscape FastTrack Server

The Netscape FastTrack Web Server, including all Application Programmer Interfaces (APIs) for customizing and extending the server, will be retired in a future Tru64 UNIX release. It will be replaced by the Compaq Secure Web Server, a Secure Socket Layer (SSL) capable Web server based on Apache.

This release contains the Netscape FastTrack Server 3.01 on the Associated Products CD-ROM Volume 1.

2.2.24    C++ Runtime Libraries libtask and libcomplex

The libtask and libcomplex C++ Runtime libraries will be retired in a future release of the operating system. If you have code that uses the nonstandard complex class in the library, Compaq recommends you use the template complex class defined in the C++ Standard Library. If you have code that uses the libtask, Compaq recommends you use the POSIX Threads Library.

The libtask and libcomplex libraries will continue to be part of the compiler kit as archived libraries. If you cannot migrate to the recommended libraries, you can relink applications that depend on these libraries using the archived versions. If you have an application that linked against the shared versions and cannot relink, contact the Compaq C++ Compiler team at compaq_cxx@compaq.com.

2.3    Hardware Support Retirement Notices

To allow for future growth and enhancements to the operating system, it is necessary to retire support for some of the existing hardware. This section provides information on hardware support that has been retired in this release and hardware support that will be retired in future releases.

2.3.1    Hardware Support Retired in This Release

The following sections provide information on hardware support that has been retired in this release of the operating system.

2.3.1.1    KZESC and KZPSC Array Controllers

The KZESC and KZPSC storage array controllers have been retired.

The KZPAC storage array controller is still supported.

2.3.1.2    Systems

The following systems (all models) are not supported in this release:

2.3.1.3    TURBOchannel Adapters

Support for all TURBOchannel adapters for the DEC 3000, including the following, has been retired in this release of the operating system:

2.3.1.4    XMI Adapters

Support for all adapters for XMI, including the following, has been retired in this release of the operating system:

2.3.1.5    TGEC Network Adapter for the DEC 4000

Support for the TGEC network adapter for the DEC 4000 has been retired in this release of the operating system.

2.3.1.6    Legacy Storage Devices

Support for the following legacy storage devices has been retired in this release:

2.3.2    Hardware Support Scheduled to Be Retired in Future Releases

The following sections provide information on hardware support that will be retired in future releases.

2.3.2.1    Disk Devices

In a future release of the operating system, support for the following disk devices will be retired:

2.3.2.2    Array Controllers

Support for the following storage array controllers will be retired in a future release of the operating system:

2.3.2.3    Network Adapters

Support for the following network adapters will be retired in a future version of the operating system:

2.3.2.4    FDDI Adapter for Futurebus

In a future release of the operating system, support for the DEFAA FDDI adapter will be retired.