DSNlink Version 2.2 for OpenVMS Product Release: February 1998 Updated This Readme: 14-May-1999 Dear Customer, This letter contains a brief description of DSNlink Version 2.2 for OpenVMS. It also explains how to find and download the save sets. The following are the topics in this letter. 1 About DSNlink Version 2.2 for OpenVMS 2 How to Download the Kit 2.1 Download the Kit from the World Wide Web 2.2 Download the Kit Via Anonymous FTP 3 After You Download the Kit 1 About DSNlink Version 2.2 for OpenVMS DSNlink is a service tool that allows Compaq customers to re- ceive product support electronically from their Customer Support Center. Customers can submit service requests, copy files, and search technical support databases for articles and engineering change orders. Compaq specialists respond to service requests electronically and, if granted permission, can also log in to a customer's system to diagnose and correct problems remotely. You can install DSNlink Version 2.2 for OpenVMS on Alpha or VAX systems running OpenVMS Version 6.2 or higher. 1.1 What's New in DSNlink Version 2.2 The previous version of DSNlink on OpenVMS was Version 1.2. These are the major new features of DSNlink Version 2.2: o A DECwindows Motif graphical user interface uses menus and forms to access the DSNlink applications, utilities, and online help. o A new DSNlink communications transport replaces the DSNlink Network used in DSNlink Version 1.2. The new transport pro- vides interactive client/server communications over TCP/IP, DECnet, and X.25 protocols, and ISDN and PSTN modem lines. o You can use a single access number with DSNlink Versions 2.2 and 1.2. The previous restriction requiring separate access numbers has been lifted. o You can use multiple access numbers on any DSNlink node. 1 o The Service Request application allows you to submit and aug- ment service requests. Compaq sends replies to your service requests to your OpenVMS mail account. You can augment the service request by replying to the mail message or by using the Service Request application's augment feature. You can also use the Service Request application to get lists of your open and closed service requests, supported products, and routing codes. Routing codes are names for the specialized groups that handle service requests. In DSNlink Version 1.2, mail addresses included the routing code. For example, ADA is the routing code in the mail address DSN%ADA. In DSNlink Version 2.2, you do not include the DSN% in the routing code. o In DSNlink Version 1.2, responses to service requests in- cluded all the work units associated with the service re- quest. In DSNlink Version 2.2, a response includes only the current work unit. All existing work units can be retrieved and saved using the Service Request application's Review feature. o DSNlink Version 1.2 differentiated between DANs (DSNlink application nodes) and DCNs (DSNlink communication nodes). The differentiation no longer exists. Communications can now be initiated from any node where DSNlink is installed. o New system management utilities allow you to restrict who uses DSNlink applications, test and troubleshoot the network, maintain your authentication keys, and modify and verify the DSNlink configuration. o By default, applications connect to the Compaq host interac- tively. Optionally, you can use command procedures to submit and augment service requests and to copy files in batch mode. o The online help for the DECwindows interface is displayed by the Mosaic browser. The help for the command line interface is displayed by the Lynx browser. Both browsers are included in the kit. Other documents you may want to print before installing DSNlink are in a documentation save set (see Section 3.0). There is no hardcopy documentation. 2 How to Download the Kit The DSNlink for OpenVMS Version 2.2 kit can be downloaded from the DSNlink home page on the World Wide Web or by anonymous FTP. The next sections provide details. Make sure your system has enough free disk space for the files. The uncompressed kit sizes are approximately: 23,500 blocks for the Alpha kit 20,500 blocks for the VAX kit 2 3 Download the Kit from the World Wide Web 1. Go to the DSNlink page at the following URL: http://www.support.compaq.com/dsnlink/ The DSNlink page appears. 2. Click on Download Kits. A page appears with links to the released kits for download- ing. 3. Click on DSNlink Version 2.2 for OpenVMS. Current information about DSNlink appears, which is followed by a table with the DSNlink save sets for VAX and Alpha systems. 4. Using your browser's conventions, download the files for the system on which you will install DSNlink. If you have an Alpha system, download these save sets: DSNLINK022.A_DCX_AXPEXE DSNLINK022.B_DCX_AXPEXE DSNLINK022.D_DCX_AXPEXE DSNLINK022.S_DCX_AXPEXE If you have a VAX system, download these save sets: DSNLINK022.A_DCX_VAXEXE DSNLINK022.B_DCX_VAXEXE DSNLINK022.C_DCX_VAXEXE DSNLINK022.S_DCX_VAXEXE 5. Go to Section 3.0 for information about what you do after downloading the kit. 3.1 Download the Files Using Anonymous FTP To download the DSNlink kit using FTP: 1. Enter this command: $ ftp ftp.support.compaq.com 2. At the Name prompt enter anonymous, for example: Name (ftp.support.compaq.com:jones): anonymous 3. At the Password prompt enter your electronic mail address, for example: 331 Guest login ok, send ident as password. Password: jojo.jones@mail.address 4. Set the default to one of the following directories: o To get the kit for an Alpha system: FTP> cd /public/DSNlink/ovms-alpha o To get the kit for a VAX system: FTP> cd /public/DSNlink/ovms-vax 3 Be sure to use the capitalization shown in the commands and examples. 5. Download these compressed save sets with the binary and get commands as follows: o For the Alpha kit: FTP> binary 200 Type set to I. FTP> get DSNLINK022.A_DCX_AXPEXE 200 PORT command successful. 150 Opening data connection for DSNLINK022.A_DCX_AXPEXE (16.63.0.111,2222) (249457 bytes). 226 Transfer complete. local: DISK$USER1:[JONES]DSNLINK022.A_DCX_AXPEXE;1 remote: DSNLINK022.A_DCX_AXPEXE 249457 bytes received in 00:00:02.90 seconds (84.00 Kbytes/s) FTP> get DSNLINK022.B_DCX_AXPEXE . . FTP> get DSNLINK022.D_DCX_AXPEXE . . FTP> get DSNLINK022.S_DCX_AXPEXE . . o For the VAX kit: FTP> binary 200 Type set to I. FTP> get DSNLINK022.A_DCX_VAXEXE 200 PORT command successful. 150 Opening data connection for DSNLINK022.A_DCX_VAXEXE (16.63.0.126,3138) (233100 bytes). 226 Transfer complete. local: DISK$USER1:[JONES]DSNLINK022.A_DCX_VAXEXE;1 remote: DSNLINK022.A_DCX_VAXEXE 233100 bytes received in 00:00:03.17 seconds (71.80 Kbytes/s) FTP> get DSNLINK022.B_DCX_VAXEXE . . FTP> get DSNLINK022.C_DCX_VAXEXE . . FTP> get DSNLINK022.S_DCX_VAXEXE . . 6. After you download the last save set, enter the quit command to exit FTP. 7. If you downloaded the files to a system running an operating system other than OpenVMS, move the files to the OpenVMS system where you want to install DSNlink. 4 4 After You Download the Kit Before you install DSNlink: 1. Make sure you have the following: - Your access number - An authentication key or authorization code Note that authentication keys and authorization codes are not identical. If you are installing DSNlink Version 2.2 for the first time on a system with DSNlink Version 1.2, the DSNlink Version 2.2 installation procedure creates your authentication key from your authorization code. - The location of your Customer Support Center. If you do not have these items or have questions, call your Customer Support Center for assistance. 2. Uncompress each save set with the RUN command. For example: $ RUN DSNLINK022.A_DCX_VAXEXE The following messages appear: FTSV DCX auto-extractible compressed file for OpenVMS (VAX) FTSV V3.0 -- FTSV$DCX_VAX_AUTO_EXTRACT Copyright (c) Digital Equipment Corp. 1993 Options: [output_file_specification [input_file_specification]] The decompressor needs to know the filename to use for the decompressed file. If you don't specify any, it will use the original name of the file before it was compressed, and create it in the current directory. If you specify a directory name, the file will be created in that directory. Decompress into (file specification): (press Return) Opening and checking compressed file... Decompressing (press Ctrl-T to watch the evolution)... Creating decompressed file... Original file specification: DSNLINK022.A;1 Decompressed file specification: DSNLINK022.A;1 3. Restore the documentation save set, DSNLINK022.S. It con- tains the DSNlink Installation Guide, Release Notes, Quick Reference Card, and Service Tool Description. To see the file names in the save set, use this command: $ BACKUP/LIST DSNLINK022.S/SAVE 4. To restore the files from the save set to a directory, enter this command: $ BACKUP/SELECT=*.*/LOG DSNLINK022.S/SAVE ddcu:[dir] Substitute your system's device name and directory for ddcu:[dir]. This is an example of the result: 5 %BACKUP-S-CREATED, created ddcu:[dir]DSNLINK022_INSTALLATION_GUIDE.PS;1 %BACKUP-S-CREATED, created ddcu:[dir]DSNLINK022_INSTALLATION_GUIDE.TXT;1 %BACKUP-S-CREATED, created ddcu:[dir]DSNLINK022_PRODUCT_DESCRIPTION.PS;1 %BACKUP-S-CREATED, created ddcu:[dir]DSNLINK022_PRODUCT_DESCRIPTION.TXT;1 %BACKUP-S-CREATED, created ddcu:[dir]DSNLINK022_REFERENCE_CARD_8X11.PS;1 %BACKUP-S-CREATED, created ddcu:[dir]DSNLINK022_REFERENCE_CARD_A4.PS;1 %BACKUP-S-CREATED, created ddcu:[dir]DSNLINK022_RELEASE_NOTES.PS;1 %BACKUP-S-CREATED, created ddcu:[dir]DSNLINK022_RELEASE_NOTES.TXT;1 5. Print or display the DSNlink Version 2.2 Installation Guide. Its file name is: DSNLINK022_INSTALLATION_GUIDE.PS or DSNLINK022_INSTALLATION_GUIDE.TXT 6. Optionally, print the other documents: the DSNlink Version 2.2 Product Description, Reference Card (for A4 and 8.5 by 11-inch paper) and Release Notes. The file names are listed in step 4 above. See the DSNlink Version 2.2 for OpenVMS Installation Guide for details about installing DSNlink. -------------------------------------------------------------- Thank you for using DSNlink! For further assistance, please call your Customer Support Center. DSNlink Program Office Compaq Customer Support Center (c) Digital Equipment Corporation 1998, 1999. All rights re- served. 6