![[Return to Library]](BOOKSHELF.GIF)
![[Contents]](TOC.GIF)
![[Previous Chapter]](REW.GIF)
![[Next Section]](NEXT.GIF)
![[Next Chapter]](FF.GIF)
![[Index]](INDEX.GIF)
![[Help]](HELP.GIF)
This appendix describes the associated products and software subsets that are shipped in addition to the Digital UNIX base operating system.
The software subsets described in this appendix are located on the CD-ROM labeled Digital UNIX V4.0 Associated Products Volume 1. Table D-1 describes the product directories in the /ALPHA directory.
| Product Directories | |
| in /ALPHA | Product Description |
| CDE_Video | Common Desktop Environment (CDE) Instructional Video |
| COMPILERS | Development Enhancements for Alpha Systems - Software Development |
| DEC_Ada_RTL | DEC Ada Run-Time Support Library for Alpha Systems |
| DEC_C++_RTL | DEC C++ Run-Time Support Library for Alpha Systems (shared libraries) |
| DEC_Cobol_RTL | DEC COBOL Run-Time Support Library for Alpha Systems and DEC Decimal Run-Time Support Library |
| DEC_EVENT | DECevent Event Management Utility |
| DEC_Fortran_RTL | DEC Fortran Run-Time Support Library for Alpha Systems |
| DEC_Pascal_RTL | DEC Pascal Run-Time Support Library for Alpha Systems |
| DEC_Sort_RTL | Sort Run-Time Library |
| DECtalk_Runtime | DECtalk Software for Digital UNIX |
| GNUSRC | Free Software Foundation GNU Source for Digital UNIX |
| Multimedia_Services | Multimedia Services for Digital UNIX |
| Networker_SingleServer | NetWorker SingleServer Save and Restore for Alpha Systems |
| PanoramiX | Xserver Extensions Advanced Developer's Kit |
| Performance_Manager | Performance Manager for Digital UNIX |
| Porting_Assistant | Digital Porting Assistant |
| Worldwide | Worldwide Language Support. Appendix E contains worldwide software subset descriptions. |
Associated products are installed after the initial full installation by using the setld command. The installation can be invoked from CD-ROM or RIS. Refer to Chapter 8 for more information about the setld command.
Follow these steps if you are installing an associated product from the CD-ROM labeled Digital UNIX V4.0 Associated Products Volume 1:
#
/usr/sbin/setld -l /mnt/ALPHA/
product_directory
The previous example assumes the CD-ROM is mounted under /mnt. Replace product_directory with the name of the directory where the product is located. Table D-1 lists the directory names for each associated product.
The setld command displays a list of software subsets available to install. Choose the appropriate software subsets from the list.
Follow these steps if you are performing a RIS installation of an associated product:
#
/sbin/ping -c2
ris_server_name
Successful output of the /sbin/ping command is similar to the following:
# ping -c2 system9 PING system9 (16.59.l24.96): 56 data bytes 64 bytes from 16.59.l24.96: icmp_seq=0 ttl=255 time=1 ms 64 bytes from 16.59.l24.96: icmp_seq=1 ttl=255 time=0 ms
----system9 PING Statistics---- 2 packets transmitted, 2 packets received, 0% packet loss round-trip (ms) min/avg/max = 0/0/1 ms
In the previous example, system9 is the name of the RIS server.
#
/usr/sbin/setld -l
ris_server_name:
Replace ris_server_name: with the name of your RIS server appended with a colon (:). The setld command displays a list of software subsets available to install. Choose the appropriate software subsets from the list.
![[Previous Section]](PREV.GIF)
The apropos and whatis commands access reference page entries in the whatis database. The whatis database that is created in /usr/share/man when you initially install Digital UNIX reference pages includes entries only for those reference pages.
The whatis database provided as part of the operating system product is not automatically updated when associated product, layered product, third party, or site-specific reference pages are installed after the initial operating system installation. If the whatis database exists on your system, you should update the database by executing the catman -w command if you install product-specific reference pages. For information about using the catman -w command to rebuild the whatis database, see the catman(8) reference page.
The CDE_Video directory contains the following software subsets: CDEVIDEO100 and CDEVIDPLR100. Follow the instructions in Section D.1 to install this product.
The CDE Video Tour runs a series of video files that provides information about:
The following are required to install and run the CDE instructional video:
Information about installing and running the CDE instructional video tour is located on the Help Viewer window, Introducing the Desktop. This window displays automatically after a Digital UNIX operating system installation. Introducing the Desktop describes basic desktop skills and how to activate online help for the desktop as well as how to invoke the instructional video.
After an installation, you can invoke the Desktop Introduction from the CDE front panel by clicking on the arrow over the question mark (?) icon and then clicking on Desktop Introduction.
The COMPILERS directory contains the following software subsets: CMPDEVENH400 and CMPDEVALT400. Follow the instructions in Section D.1 to install this product.
The following describes the two software subsets in this directory:
The file mmap_32.c is a C source file that provides a jacket for the mmap() system call. This is provided to support the Truncated Address Support Option (TASO) in Digital UNIX Version 1.3. Refer to the TASO documentation for more information if your TASO code contains mmap()calls.
The features supported by this suite are the same as those documented for the default compiler suite in the Digital UNIX Version 4.0 release. However, the compiler included in this suite does not contain the features necessary to build kernel objects. Do not copy the compiler provided in this suite to the default compiler directory, /usr/lib/cmplrs/cc, or you lose the ability to rebuild kernels on your system. The cc.alt suite is intended to provide more recent versions of the compiler components than those in Digital UNIX. Because the cc.alt components will change more frequently than the base operating system components, any problems reported against cc.alt will be addressed in a later release of cc.alt.
The DEC_Ada_RTL directory contains the ADALIB331 software subset. Follow the instructions in Section D.1 to install this product.
The Ada Run-Time Library subset is included on the Digital UNIX CD-ROM to facilitate deployment of applications built using DEC Ada.
The following table describes the contents of the DEC Ada Run-Time Library kit:
| File Name | Description |
| libada.so | DEC Ada Run-Time Library, shared object |
| libada.a | DEC Ada Run-Time Library, archive library |
Inclusion of the DEC Ada Run-Time Library in the base system allows users to run applications that were linked with the DEC Ada (run-time) libraries without requiring the user to purchase DEC Ada.
The DEC_C++_RTL directory contains the following software subsets: CXLSHRDA400 and CXLLIBA400. Follow the instructions in Section D.1 to install this product.
The DEC C\+\+ Version 5.0 compiler kits no longer provide the Class Library archive libraries when installed on Digital UNIX Version 4.0.
The CXLSHRDA400 software subset contains the shared libraries required for the C++ Complex and Task Packages. The CXLLIBA400 software subset contains the corresponding archive libraries.
The mandatory base operating system software subset, OSFBASE400 contains the shared library for the remaining packages, including IOStream, as well as the run-time support. The optional base operating system subset, OSFLIBA400 contains the corresponding archive library.
If you run C\+\+ applications on your system, install the CXLSHRDA400 software subset. If you develop C\+\+ applications on your system, install both C\+\+ subsets, CXLSHRDA400 and CXLLIBA400 as well as the base operating system software subset OSFLIBA400.
There is no need to remove the CXXSHRDA subset that was included in Digital UNIX Version 3.2C, 3.2D-1, or 3.2D-2 before you upgrade to Digital UNIX Version 4.0. However, you must remove the old CXXSHRDA subset before you can install CXLSHRDA400.
The CXLLIBA400 subset will not install if your system has the DEC C\+\+ Version 1. n compiler installed. Before you install the CXLLIBA400 subset Digital recommends that you upgrade the DEC C++ compiler to Version 5.0 or later.
The DEC_Cobol_RTL directory contains the following software subsets: DCARTL230 and 02ABASE230. Follow the instructions in Section D.1 to install this product.
DEC COBOL Run-Time Support Library for Digital UNIX Alpha Systems is a software library that provides compiled code support for file processing, format processing, I/O processing and other capabilities to the DEC COBOL programming language implementation. The DEC Fortran for Digital UNIX Alpha Run-Time Support subsets must be installed at the same time as the DEC COBOL Run-Time Support subsets.
The software subsets contain:
Both subsets must be installed together. The following table lists the contents of the DCARTL230 subset:
| File Name | Description |
| libcob.a | DEC COBOL Run-time (archive) library |
| libcob.so | DEC COBOL Run-time (shared) library |
| libisam_stub.a | DEC COBOL ISAM stub (archive) library |
| cob_msg.cat | DEC COBOL Run-time library message catalog |
The following table lists the contents of the O2ABASE230 subset:
| File Name | Description |
| libots2.a | DEC Decimal Support Run-time (archive) Library |
| libots2.so | DEC Decimal Support Run-time (shared) Library |
The DEC_EVENT directory contains the DIABASE211 software subset. Follow the instructions in Section D.1 to install this product.
The DECevent utility is an event management utility for Digital UNIX operating systems that provides the interface between a system user and the system's event log files. This lets system users produce ASCII reports derived from system event entries. The format of the ASCII reports depends on the command entered on the command line or on the command entered from the graphical user interface (GUI). Command line commands are restricted to 255 characters. Event report information can be filtered by event types, date, time, and event entry numbers. Event report formats can be selected from full disclosure to very brief information messages. The -i (include) and -x (exclude) flags provide a wide range of selection criteria to narrow down the focus of event searches.
The DECevent utility also offers an interactive command shell interface, accessible with the command --int, that recognizes the same commands used at the command line. From the interactive command shell users can customize, change, or save system settings.
DECevent uses the system event log file /usr/adm/binary.errlog as the default input file for event reporting, unless another file is specified. To produce a translated report using the built-in defaults, type the following command at the command line:
#
dia
To produce a translated event report using the GUI, click on the translate/auto icon in the DECevent GUI menu bar.
Digital UNIX users need super user privileges to use the translation and reporting features of DECevent, unless the event log file privileges have been changed to let all users read the event log file.
The DEC_Fortran_RTL directory contains the DFARTL364 software subset. Follow the instructions in Section D.1 to install this product.
The DEC Fortran for Digital UNIX Alpha Run-Time Support is a software library that provides compiled code support for file processing, format processing, I/O processing and other capabilities to the DEC Fortran programming language implementation. The following table lists the contents of the DEC Fortran for Digital UNIX Alpha Run-Time Support kit:
| File Name | Description |
| libFutil.a | DEC Convert RTL |
| libUfor.a | DEC Fortran Unsupported RTL |
| libfor.a | DEC Fortran RTL |
| libFutil.so | DEC Convert RTL |
| libUfor.so | DEC Fortran Unsupported RTL |
| libfor.so | DEC Fortran RTL |
| for_msg.cat | DEC Fortran RTL Message Catalog |
The DEC_Pascal_RTL directory contains the DPORTL540 software subset. Follow the instructions in Section D.1 to install this product.
The DEC Pascal for Digital UNIX Alpha Run-Time Support is a software library that provides compiled code support for file processing, format processing, I/O processing and other capabilities to the DEC Pascal programming language implementation. The DEC Fortran for Digital UNIX Alpha Run-Time Support subsets must be installed at the same time as the DEC Pascal for Digital UNIX Alpha Run-Time Support Library subset.
| File Name | Description |
| libpas.a | DEC Pascal RTL |
| libpas.so | |
| libpas_msg.cat | DEC Pascal RTL message catalog |
The DECtalk_Runtime directory contains the following software subsets: DTKRT420, DTKRTDOC420, DTKRTRELNOT420, DTKDFCRT420, DTKRTCDE420, and DTKEMSRT420. Follow the instructions in Section D.1 to install this product.
DECtalk Software for Digital UNIX is a text-to-speech software based on Digital Equipment Corporation's industry-leading text-to-speech synthesis technology.
DECtalk Software lets applications convert standard ASCII text in American English into highly intelligible and natural sounding speech, playable through audio hardware on Alpha workstations.
DECtalk documentation and release notes are loaded into the /usr/opt/DTKRTDOC420 and /usr/opt/DTKRTRELNOT420 directories when the DTKRTDOC420 software subset is installed. The DECtalk applications reference pages are loaded into /usr/man/man3 and Bookreader files are loaded in the /usr/lib/X11/help directory.
The DECtalk run-time package is bundled with several sample applications:
Information on how to use emacspeak is provided in the DTKEMSRT420 save set under the docs directory.
DECface enhances DECtalk by providing an obvious and immediate visual feedback mechanism. In particular, multimedia projects involving direct user interaction can be enhanced to better attract and maintain the attention of viewers.
Specific information on how to invoke and use DECface can be found in the DTKDFCRT420 save set under the docs directory.
The GNUSRC directory contains the following software subsets from the GNU Free Software Foundation: FSFGAWKSRC400, FSFINDENTSRC400, FSFEMACSSRC400, FSFRCSSRC400 and FSFGZIPSRC400. Follow the instructions in Section D.1 to install this product.
The GNU awk Source subset, FSFGAWKSRC400, contains source files for the GNU awk (gawk) programming language. Gawk is the GNU Project's implementation of the awk programming language. Refer to the gawk(1) reference page for more information.
The GNU Emacs Source subset, FSFEMACSSRC400, contains the source files for the GNU Emacs editor. The GNU Emacs editor is a new version of Emacs, written by the author of the original (PDP-10) Emacs. The documentation for GNU Emacs is available on line and can be viewed using Info, a subsystem of the Emacs facility. Refer to the emacs(1) reference page for more information.
The GNU Revision Control System Source subset, FSFRCSSRC400, contains source files for the GNU Revision Control System (RCS). Refer to the rcs(1) reference page for more information.
The GNU ident Source subset, FSFINDENTSRC400, contains the source files for the ident utility which searches for all occurrences of a pattern in the named files or, if no file name is specified, the standard input. Refer to the ident(1) reference page for more information.
The GNU gzip source subset, FSFGZIPSRC400, contains the source files for the gzip utility which compresses or expands files. Refer to the gzip(1) reference page for more information.
The Networker_SingleServer directory contains the following software subsets: BRXSOAKIT320, BRXCKIT320, BRXMAN320, and BRXRNOTES320. Follow the instructions in Section D.1 to install this product.
NetWorker SingleServer Save and Restore, also known as NetWorker SingleServer, is a graphical utility that backs up and restores local files on a single local system to a local tape or loader. Unlike standard UNIX backup utilities such as tar, cpio, dump/restore, or vdumd/vrestore, NetWorker SingleServer provides easy to use user interfaces for saving and restoring data and for performing system administration tasks.
NetWorker SingleServer is a subset of Digital's POLYCENTER NetWorker Save and Restore product and is licensed free of charge with the Digital UNIX base operating system.
The OSF-BASE, UNIX-SERVER, or UNIX-WORKSTATION Product Authorization Key (PAK) gives you a license to install and use SingleServer; you do not need to load and register a special PAK.
Following is a description of the four NetWorker SingleServer software subsets:
After you install the NetWorker SingleServer subset BRXRNOTES320, postscript files containing the NetWorker documents are loaded into /usr/opt/BRX320/usr/doc.
During the installation, you are asked if you want to start the NetWorker daemons. If you enter no, the daemons will be started when the system is rebooted. To start the daemons manually without rebooting, refer to nsrd(8).
The DEC_Sort_RTL directory contains the SORLIB300 software subset. Follow the instructions in Section D.1 to install this product.
The Sort subset provides a run-time library of sort routines that provide applications programming interface compatibility with a subset of the OpenVMS sort/merge utility. This functionality is provided to assist in the migration to Digital UNIX of several OpenVMS products that depend on OpenVMS SORT. It also provides a high performance sort package that takes advantage of the Alpha architecture for better performance.
The following table lists the contents of the SORLIB300 subset.
| File Name | Description |
| libsort.so | Shareable object of Sort RTL routines |
| libsort.a | Library of Sort RTL routines |
| libsort.cat | Sort message catalog |
The PanoramiX directory contains the PRXADK100 software subset. Follow the instructions in Section D.1 to install this product.
This section discusses the Digital solution for a multiheaded single root window. The implementation removes graphics drawing screen size contraints and creates a screen equal to the combined width and height of all screens connected to the system.
The PanoramiX Extensions is provided in this advanced development kit (ADK). The following table lists the contents of the PanoramiX ADK:
| File Name | Description |
| libpanoramiX.so | PanoramiX extension shared library |
| libos.so | Modified version of core server library |
| libmi.os | Modified version of core server library |
| libdix.so | Modified version of core server library |
| libextshape.so | Modified version of shape extension library |
| PanoramiX | Modified version of Xdec |
| Xserver.conf | Modified version of server config file |
| README_PANORAMIX.TXT | Contains information about PanoramiX extension. Read this file before enabling the extensions. |
The Performance_Manager directory contains the following software subsets: PMGRBASE210, PMGRGUI210, PMGRUTIL210, and PMGRMAN210. Follow the instructions in Section D.1 to install this product.
Performance Manager Version 2.0 (PM V2) is a real time performance monitoring, analysis, and management application. A single-system version of PM V2 is included with Digital UNIX Version 4.0 . A separate license is available to enable the distributed Performance Manager.
While providing many of the features of previous versions of the Polycenter Performance Solution for Digital UNIX , PM V2 is a complete reimplementation with a new GUI, application-accessible metrics, user extensibility and performance analysis capability.
The following Performance Manager software subsets are located in the Performance_Manager directory:
Postscript and text versions of the Performance Manager Installation Guide and Release Notes are located under the DOCUMENTATION/PERFORMANCE_MANAGER directory on the CD-ROM labeled Digital UNIX V4.0 Documentation Volume 1.
Features of the Performance Manager are:
The Porting_Assistant directory contains the following software subsets: PRTBASE200 and PRTMAN200. Follow the instructions in Section D.1 to install this product.
The Digital Porting Assistant is a Motif-based tool to help you port your C, C++, and FORTRAN source code to Digital UNIX from other UNIX and proprietary platforms including OpenVMS. The Porting Assistant:
The Porting Assistant is licensed and provided to you with the Digital UNIX Developers' Toolkit but it requires separate installation.
For detailed information about the Porting Assistant, refer to its extensive online HyperHelp system. You can also refer to the port reference page for command options and details.
After installation, invoke the Porting Assistant from the common desktop environment (CDE) or from the command line:
If you install the Software Development Tools and Utilities for CDE (OSFSDECDE400), you can invoke the Porting Assistant from an icon on the desktop.
#
port
The Multimedia_Services directory contains the following software subsets: MMERELNOTES201, MMEMANRT201, MMERT201, MMECDE201, MMERTSMPLDAT201, MMEDRVAV201201, MMEDRVAV3X1201, MMEDRVMSB201, MMEDRVA3001201, and MMEDRVBBA201. Follow the instructions in Section D.1 to install this product.
Multimedia Services Version 2.0A for Digital UNIX brings audio and video capabilities to Digital workstations and provides a full programming library for use by developers of new applications. The developer kit is available on the Software Product Library CD-ROM and is not distributed with Digital UNIX.
Installing the reference pages for Multimedia Services (MMEMANRT201) automatically updates the whatis database.
Ready-to-use applications included in Multimedia Services are:
Multimedia Services supports standard Microsoft Resource Interchange File Format (RIFF) file I/O in AVI and WAVE file formats in the utilities. This allows sharing of many audio and some video files between PCs and Alpha systems.
Digital UNIX users can play back video and audio clips from the Common Desktop Environment (CDE), from MIME enabled mailers, and from the Netscape browser. Users may record audio messages to send and if their systems contain a supported video capture device, they may record full audio and video messages. Multimedia Services also enables such tools as presentation authoring and teleconferencing.
No additional video hardware is needed to play back video clips. If your system is configured with an audio card, you can play back full video and audio clips as well as record audio messages.
Multimedia Services consists of the following subsets:
The /DOCUMENTATION/Multimedia_Services directory on the CD-ROM labeled Digital UNIX V4.0 Documentation Volume 1 contains the following Multimedia Services documents:
The /DOCUMENTATION directory on the CD-ROM labeled Digital UNIX V4.0 Associated Products Volume 1 contains the following Multimedia Services documents: