          ________________________________________________________________

          DECnet/SNA VMS DDXF
          Version 1.4
                                                                   DIGITAL
          AV-KK19B-TE
          October 1988
          ________________________________________________________________


          Dear Customer:

          Your DECnet/SNA VMS DDXF Version 1.4 software and user docu-
          mentation, including installation instructions, are in this
          package. This is strictly a maintenance release.

          Check the bill of materials to see that all items listed are
          in your distribution kit. If any items are missing or damaged,
          contact your Digital representative.

          The DECnet/SNA VMS DDXF Version 1.4 documentation set includes
          the following manuals:

          o  DECnet/SNA VMS DDXF Installation and Problem Determination
             Guide

          o  DECnet/SNA VMS DDXF User's Guide

          o  DECnet/SNA VMS DDXF Reference Card

          Read the DECnet/SNA VMS DDXF Installation and Problem Determina-
          tion Guide before installing the software.

          Install the DECnet/SNA VMS DDXF software by invoking VMSINSTAL.
          Use the following command line:

               $@SYS$UPDATE:VMSINSTAL SNADDXF014 ddcu: [OPTIONS N]

          where ddcu represents the device name for the DDXF installation
          media.

          
          After the installation, you can read the release notes by typing
          or printing the file SYS$HELP:SNADDXF014.RELEASE_NOTES. 


          1989 by Digital Equipment Corporation o All rights reserved 
          o Printed in U.S.A.

 














             DECnet/SNA VMS DDXF
             Installation and Problem Determination Guide
             Order No. AA-EE69C-TE



             This document tells the user how to install DECnet/SNA
             VMS DDXF. It also tells the user how to solve problems
             that might arise in the day-to-day operation of DDXF.





               Revision/Update Information:  This is a revised manual.
               Operating System and Version: VMS Version 4.6 or later
               Software Version:             DECnet/SNA VMS DDXF V1.4 





             DIGITAL

 






                                                     October 1988




             The information in this document is subject to change
             without notice and should not be construed as a com-
             mitment by Digital Equipment Corporation. Digital
             Equipment Corporation assumes no responsibility for
             any errors that may appear in this document.

             The software described in this document is furnished
             under a license and may be used or copied only in ac-
             cordance with the terms of such license.

             No responsibility is assumed for the use or reliabil-
             ity of software on equipment that is not supplied by
             Digital Equipment Corporation or its affiliated com-
             panies.

               Copyright 1988 by Digital Equipment Corporation
                             All Rights Reserved
                              Printed in U.S.A.


             The postpaid READER'S COMMENTS form on the last page
             of this document requests the user's critical evalua-
             tion to assist in preparing future documentation.




             The following are trademarks of Digital Equipment
             Corporation:

             DEC             DIBOL         UNIBUS
             DEC/CMS         EduSystem     VAX
             DEC/MMS         IAS           VAXcluster
             DECnet          MASSBUS       VMS
             DECsystem-10    PDP           VT
             DECSYSTEM-20    PDT
             DECUS           RSTS
             DECwriter       RSX           DIGITAL



             This manual was produced by Networks and Communications
             Publications.

 










          _______________________________________________________
                                                          Preface




             DECnet/SNA VMS DISOSS Document Exchange Facility
             (DDXF) is a layered product that enables its users
             within a DECnet network or a VMS/SNA environment to
             participate in an IBM office-system network. The IBM
             office-system network is a vehicle for document li-
             brary and distribution services within an IBM Systems
             Network Architecture environment. Access to the
             IBM/SNA network is through one of the following trans-
             port products: DECnet/SNA Gateway-CT, DECnet/SNA
             Gateway-ST, DECnet/SNA Gateway V1.5, or VMS/SNA.

             The DECnet/SNA VMS DDXF Installation and Problem
             Determination Guide tells you how to install the DDXF
             software. It also tells you how to solve problems that
             might arise while using DDXF.


          Intended Audience

             This manual is for system managers responsible for
             planning and installing the DDXF software.








                                                                v

 


          Document Structure

             This document has the following sections:

              _  Chapter 1, Installing DECnet/SNA VMS DDXF, tells how to 
                 install the DDXF software by using the VMSINSTAL procedure.

              _  Chapter 2, Ensuring that DDXF Works Properly, describes how 
                 to verify that the communications link to IBM DISOSS is 
                 working properly.

              _  Chapter 3, Solving DDXF Problems, tells how to solve problems
                 that might occur during the day-to-day operation of DDXF. It 
                 supplements the problem determination guide for the product 
                 you are using to access the IBM environment.


          Associated Documents

              _  DECnet/SNA VMS DDXF User's Guide
              _  DECnet/SNA VMS DDXF Reference Card
              _  DECnet/SNA Gateway Problem Determination Guide
              _  DECnet/SNA Gateway-ST Problem Determination Guide
              _  DECnet/SNA Gateway-CT Problem Determination Guide
              _  VMS/SNA Problem Determination Guide
              _  DECnet/SNA Guide to IBM Parameters
              _  DECnet/SNA Gateway-CT Guide to IBM Parameters
              _  DECnet/SNA Gateway-ST Guide to IBM Parameters
              _  VMS Install Utility Manual









          vi

 






          Conventions

             This manual uses the following conventions:

             Conventions         Meaning

             UPPERCASE LETTERS   Represent constant values or sym-
                                 bols. Code these exactly as they
                                 are specified.

             lowercase italics   Represent variables for which you
                                 must supply a value.

             [  ]                Square brackets enclose optional
                                 values. Do not type the brackets
                                 in the line of code.

             (  )                Parentheses enclose group val-
                                 ues that must be specified for
                                 a parameter. These values must
                                 be typed in the line of code in
                                 the indicated order. Parentheses
                                 must be typed where they appear
                                 in a line of code.
     
             Special Type        Examples of system input and output are 
                                 printed in special type. System output is in
                                 black; user input is in red.

             <RET>               Unless otherwise specified, ev-
                                 ery command line is terminated by
                                 pressing <RET>.









                                                              vii

 







             <CTRL/x>            Control characters are shown as
                                 <CTRL/x>s, where x is an alpha-
                                 betic character. Press <CTRL/x>
                                 and the appropriate key simulta-
                                 neously.





































          viii

 















          _______________________________________________________
                                                         Contents




          Preface


          1   Installing the DECnet/SNA VMS DDXF Software

              1.1       Preparing to Install the DDXF Software . 1-1
              1.1.1      Prerequisite Software ................. 1-2
              1.1.2      On-Line Release Notes ................. 1-2

              1.1.3      Installation Procedure Requirements ... 1-3
              1.1.4      Checking System Parameter Values ...... 1-4
              1.1.5      Calculating the Values for GBLPAGES and
                         GBLSECTIONS ........................... 1-5
              1.1.6      Changing System Parameter Values with
                         AUTOGEN ............................... 1-6
              1.2       Installing Files on a VMS System ....... 1-7
              1.2.1      Using VMSINSTAL ....................... 1-8

              1.3       Installing DECnet/SNA VMS DDXF Software  1-9
              1.4       Files Created During Installation ...... 1-17
              1.5       Installing and Reinstalling DDXF ....... 1-18
              1.6       Using the DDXF Software in a VAXcluster  1-19
              1.7       Sample Installation with VMS V4.6....... 1-19
              1.8       Sample Installation with VMS V5.0....... 1-22





                                                              iii

 






          2   Ensuring that DDXF Works Properly



          3   Solving DECnet/SNA VMS DDXF Problems


          Index



          Tables

              1-1     Installation Requirements for the DECnet/SNA
                      VMS DDXF ................................. 1-3

              1-2     Files Created During Installation ........ 1-17


























          iv

 













                                                                1
          _______________________________________________________
                       nstalling the DECnet/SNA VMS DDXF Software




             This chapter describes how to install DECnet/SNA VMS
             DDXF software (DDXF). DDXF uses one of the following
             transport products to access the IBM office-system
             network: VMS/SNA, DECnet/SNA Gateway V1.5, DECnet/SNA
             Gateway-CT or DECnet/SNA Gateway-ST.

             Keep this document with your distribution kit. You
             might need to refer to it again if you receive any
             maintenance updates or need to reinstall the DDXF
             software for any reason.

             Installing the interface on the VMS system involves
             running the VMSINSTAL procedure with the DDXF distri-
             bution kit. The installation procedure is described
             step by step in this chapter. The dialogue is self-
             explanatory.

          1.1 Preparing to Install the DDXF Software

             Before you start an installation that involves writing
             to your system disk, Digital Equipment Corporation
             recommends that you make a backup copy of your system
             disk.






          Installing the DECnet/SNA VMS DDXF Software           1-1

 


             Your bill of materials (BOM) specifies the number and
             contents of your media. Check the contents of your kit
             against the list in the BOM. If your kit is damaged or
             parts are missing, call your Digital representative.

             For more information on mounting the distribution me-
             dia, see the VMS Install Utility Manual. That book
             also details several options to the installation pro-
             cedure; be sure to read it.

          1.1.1 Prerequisite Software

             V1.4 of DECnet/SNA VMS DDXF requires VMS V4.6 or later
             and either DECnet/SNA Gateway V1.5, DECnet/SNA Gateway-ST
             V1.0, DECnet/SNA Gateway-CT V1.0, or VMS/SNA V1.3.

             DDXF also requires Gateway Management installed on the
             VMS load host. The individual transport products re-
             quire the following versions of the Gateway Management
             product:

              _  DECnet/SNA Gateway (DECSA) requires Gateway Management
                 for DECSA V1.5

              _  DECnet/SNA Gateway-ST requires Gateway Management V2.0

              _  DECnet/SNA Gateway-CT requires Gateway Management V2.0

          1.1.2 On-Line Release Notes

             The DDXF installation kit provides on-line release
             notes. A prompt to display or print the release notes
             appears during the installation procedure if you in-
             voke VMSINSTAL with the OPTIONS N parameter. Later,
             you can read the release notes by typing or printing
             the file SYS$HELP:SNADDXFnnn.RELEASE_NOTES (for exam-
             ple, SYS$HELP:SNADDXF014.RELEASE_NOTES).






          1-2  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 






             nnn represents the major version number and all main-
             tenance updates in that version. The first and sec-
             ond digits represent the major version number, and the
             third digit represents the maintenance update version
             number.

          1.1.3 Installation Procedure Requirements

             Before you install the DDXF software, verify that the
             following installation requirements have been met:

             Table 1-1: Installation Requirements for the DECnet/SNA
                        VMS DDXF

             ____________________________________________________
             Requirements          Specifications
             ____________________________________________________

             Software              VAX/VMS V4.6 or later
                                   DECnet/SNA Gateway V1.5
                                   DECnet/SNA Gateway-CT V1.0
                                   DECnet/SNA Gateway-ST V1.0
                                   VMS/SNA software V1.3

                                   Gateway Management for DECSA
                                   V1.5 or Gateway Management V2.0

             Privileges            System manager level

             Disk space            3696 blocks minimum during installation
                                   1306 blocks minimum after installation

             Global sections       12

             Global pages          806

             Approximate instal-   6 to 30 minutes, depending on
             lation time           the type of medium used







          Installing the DECnet/SNA VMS DDXF Software           1-3

 






             Table 1-1 (Cont.): Installation Requirements for the
                                DECnet/SNA VMS DDXF

             ___________________________________________________

             Requirements          Specifications
             ___________________________________________________

             Associated document   VMS software installation
                                   guide for your processor
             ___________________________________________________

             For general background information on installing op-
             tional products on a VMS system, refer to the Guide to
             VMS Software Installation.

             If you are using VMS V5.0 on your system, make sure
             that you have registered and loaded the Product Authorization
             Key (PAK) before you begin the installation. Refer to
             the VMS License Management Utility Reference Manual
             for this information.

             The following sections show you how to check system
             parameter values, calculate values for the GBLPAGES
             and GBLSECTIONS system parameters, and change parame-
             ter values with the VMS AUTOGEN command procedure.

          1.1.4 Checking System Parameter Values

             To check the values of your system parameters, enter
             the following command at the DCL prompt to invoke the
             SYSGEN utility:

               $ RUN SYS$SYSTEM:SYSGEN
               SYSGEN>

             At the SYSGEN> prompt, enter the SHOW command to dis-
             play the value of each system parameter. The values
             displayed should equal or exceed the the value of each
             parameter listed in Table 1-1. The following command
             displays the value for the GLBSECTIONS system parame-
             ter:

               SYSGEN> SHOW GLBSECTIONS



          1-4  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 



             After you finish checking the parameters with the SHOW
             command, you can enter the EXIT command at the SYSGEN>
             prompt to return to DCL level.

          1.1.5 Calculating the Values for GBLPAGES and GBLSECTIONS

             To install and run DDXF, you must set the correct val-
             ues for the GBLPAGES and GBLSECTIONS system parame-
             ters.

             The values for GBLPAGES and GBLSECTIONS in Table 1-1
             indicate that you must have at least 806 unused pages
             or 12 unused sections available on your system for the
             installation to process successfully. To calculate
             how many unused global pages and global sections your
             system has, perform the following steps:

              1. Run the VMS Install Utility (INSTALL) using the
                 following DCL commands:

                  $ INSTALL == "$SYS$SYSTEM:INSTALL /COMMAND_MODE"
                  $ INSTALL LIST /GLOBAL /SUMMARY


                                        NOTE
                           For products installed using
                           only VMS V5.0 or later, do
                           not include the first line in
                           the above example. As of VMS
                           V5.0, INSTALL is an official
                           DCL command. Users no longer
                           need to define a logical for
                           INSTALL.

                The INSTALL utility displays a summary of global
                pages and global sections used by your system, as
                well as the current number of unused global pages.
                For example:

                          Summary of Local Memory Global Sections
              258 Global Sections Used,  22580/3420 Global Pages Used/Unused



          Installing the DECnet/SNA VMS DDXF Software           1-5

 






              2. Determine whether the number of unused pages (3420
                 in the example) is equal to or greater than the number 
                 specified in Table 1-1. If the number of unused pages 
                 is less than the number listed in the table increase 
                 the value for GBLPAGES.

              3. Note the amount shown for "Global Sections Used"
                 (258 in the example).

              4. Run the SYSGEN utility. Use the SHOW command to de-
                 termine the number of global sections allocated:

                  $ RUN SYS$SYSTEM:SYSGEN
                  SYSGEN> SHOW GBLSECTIONS

          Parameter Name   Current   Default   Minimum   Maximum Unit  Dynamic
          --------------   -------   -------   -------   ------- ----  -------
          GBLSECTIONS         512       250        20      4095  Sections

              5. Subtract the amount shown in the summary (258 in
                 the example) from the amount allocated. If the dif-
                 ference is less than the number required in Table
                 1-1, increase the value of the GBLSECTIONS parame-
                 ter.

             Section 1.1.6 describes the procedures for increas-
             ing these values as well as those of other system pa-
             rameters. Refer to the VMS documentation on system
             management and operations for more information.

          1.1.6 Changing System Parameter Values with AUTOGEN

             You use the AUTOGEN command procedure to change system
             parameters. AUTOGEN automatically adjusts values for
             parameters that are associated with the ones you reset
             manually. To change system parameters with AUTOGEN,
             you must edit the the following file:

               SYS$SYSTEM:MODPARAMS.DAT







          1-6  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 






             For example, to change the setting for the GBLSECTIONS
             system parameter, add this line to the file:

               GBLSECTIONS = 1024

             Or for incremental SYSGEN parameters:

               ADD_GBLPAGES = 2000

             Now, run the AUTOGEN procedure to recalculate your
             system parameters. Enter the following command at the
             DCL prompt:

               $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

             AUTOGEN performs an automatic system shutdown and
             reboots when it has finished. Rebooting your sys-
             tem makes the new parameter values active. Also on
             VMS V5.x systems you can add the [NO]FEEDBACK param-
             eter to the AUTOGEN command line. For more information
             about using AUTOGEN, see the instructions on modifying
             system parameters in the VMS documentation on System
             Management and Operations.

          1.2 Installing Files on a VMS System

             The procedure for installing files on a VMS system
             is automated. It requires little involvement beyond
             answering questions displayed while the procedure
             (VMSINSTAL) runs.

             Most questions require a simple yes (Y) or no (N) an-
             swer. The questions display default answers (where
             available) in the following way:

               [YES]:

             To answer a question with the default YES, press
             <RET>.




          Installing the DECnet/SNA VMS DDXF Software           1-7

 




             To install the distribution kit on your VMS host:

              _  Log in to the system manager's account. 

              _  Make sure that all users are logged out and all batch jobs 
                 are complete.

              _  Disable logins and DECnet.

              _  Make sure you have backed up the system disk.

              _  Check to be sure you have more than 3696 free blocks
                 on the system disk.

              _  Make sure you have 806 global pages free. (If you
                 do not have enough global pages, the installation
                 will fail immediately.)

          1.2.1 Using VMSINSTAL
 
             VMSINSTAL is a command procedure that installs VMS
             layered software products. The VMSINSTAL command line
             has the following format:

              $ @SYS$UPDATE:VMSINSTAL SNADDXFnnn ddcu: [OPTIONS N] <RET>

             nnn

                Represents the major version number and all mainte-
                nance updates in that version. The first and second
                digits represent the major version number, and the
                third digit represents the maintenance update ver-
                sion number. For the version number of your kit,
                refer to the label on the distribution kit or the
                BOM. If you do not supply the product name and ver-
                sion number, VMSINSTAL prompts you for them.

             ddcu:
                Represents a device name for the DDXF installa-
                tion media, where dd is the device code, c is the
                controller id, and u is the unit number. It is not
                necessary to use the console drive. If you do not
                supply the device name, VMSINSTAL prompts you for



          1-8  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 






                it. MTA0: is the device name used in examples in
                this document.

             OPTIONS N

                An optional parameter. Provide it if you want to
                be prompted to display or print the release notes.
                If you do not include the OPTIONS N parameter,
                VMSINSTAL does not prompt you to display or print
                the release notes.

             When you install a product using VMSINSTAL, you have
             two installation options. Either you can enter the
             VMSINSTAL command line specifying the product name,
             version number, device name, and release notes option,
             or you can enter the following command:
 
             $ @SYS$UPDATE:VMSINSTAL

             If you enter the preceding command, VMSINSTAL prompts
             you for the product name, version number, and device
             name during the installation. If you use this command,
             you do not have the option of displaying or printing
             the release notes.


          1.3 Installing DECnet/SNA VMS DDXF Software

             This section displays the script you see when you use
             VMSINSTAL to install DDXF software. In addition, this
             section contains explanatory text for each prompt.

             When you run VMSINSTAL, accept the default value by
             pressing the <RET> key. Unless it is otherwise stated,
             end every command line by pressing <RET>.

             If at any time during the installation, you need to
             terminate the procedure, press <CTRL/Y>. When you
             press <CTRL/Y>, the installation procedure deletes
             all files it has created up to that point and exits. If




          Installing the DECnet/SNA VMS DDXF Software           1-9

 


             you want to restart the installation procedure after
             pressing <CTRL/Y>, you must begin again from step 2.

             Enhancements to VMSINSTAL in future releases of the
             VMS operating system might result in additional prompts
             appearing during the course of the installation.
             Although such prompts might not be documented in this
             installation guide, the installation should proceed
             normally.

             Step 1: Log in to the system manager's account.

             Username: SYSTEM <RET>
             Password:         <RET>

             Step 2: Invoke VMSINSTAL.

             $ @SYS$UPDATE:VMSINSTAL SNADDXFnnn MTA0: OPTIONS N <RET>

             Replace nnn in the product name with the version num-
             ber of the software, for example, SNADDXF014.

                 VMS Software Product Installation Procedure V5.0

               It is dd-mmm-yyyy at hh:mm.
               Enter a question mark (?) at any time for help.

          * Are you satisfied with the backup of your system disk [YES]?<RET>

             Step 3: Product installation begins.
             
             VMSINSTAL prompts you to mount the distribution kit
             volume.

             Please mount the first volume of the set on ddcn:

               * Are you ready ?Y

             Type YES when you have mounted the first volume on the
             console drive.






          1-10  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 


               %MOUNT-I-MOUNTED, SNADDXF mounted on ddcn:

               The following products will be processed: SNADDXF Vn.n

                      Beginning installation of SNADDXF Vn.n at hh:mm

               %VMSINSTAL-I-RESTORE, Restoring product saveset A...

             n.n is automatically replaced with the version number
             of the DDXF software, for example, V1.4

             Step 4: Select a release notes option.

             The following prompts appear only if you specified
             OPTIONS N in step 2.

               Release Notes Options:
                   1. Display release notes
                   2. Print release notes
                   3. Both 1 and 2
               * Select option [3]: <RET>

             If you select option 1, VMSINSTAL displays the release
             notes immediately on your screen. You can terminate
             the display at any time by pressing <CTRL/C>.

             If you select option 2, VMSINSTAL prompts you for a
             queue name.

               * Queue name [SYS$PRINT]: <RET>

             Either type a queue name, or press <RET> to send the
             file to the default output print device.

             If you select option 3, VMSINSTAL prompts you for a
             queue name and displays the release notes.







          Installing the DECnet/SNA VMS DDXF Software          1-11

 






             After the release notes are displayed or printed, the
             following prompt and message appear:

               Do you want to continue the installation [NO]?: Y <RET>
               %VMSINSTAL-I-RELMOVED, The products release notes have been 
               successfully moved to SYS$HELP.

             If you want to continue the installation, type Y and
             press <RET>. If you type N and press <RET> or just
             press <RET>, VMSINSTAL stops the installation.

             Step 5: Register the product with the License Management Facility

             If you are using VMS V5.0, you must use the VMS License
             Management Facility (LMF) to register the product.
             The following text appears:

                            Product:       SNA-DDXF
                            Producer:      DEC
                            Version:       Vn.n
                            Release Date:  dd-mmm-yyyy
               
           * Does this product have an authorization key registered and loaded?

             Check to see if this is the same information contained
             in your Product Authorization Key (PAK). Type YES or
             NO in response to the question.

             If you do not register and load your authorization
             key, the product will not run. For more information
             on LMF, refer to the VMS License Management Utility
             Reference Manual.

             Step 6: Select installation options.

             * Do you want to run the IVP after the installation [YES]? <RET>

             The installation verification procedure (IVP) runs
             tests to check whether the installation procedure was





          1-12  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 






             successful. Press <RET> to run the IVP after the in-
             stallation. If you do not want to run the IVP, type N
             in response to the prompt.

        * Do you want to purge files replaced by this installation [YES]? <RET>

             The system disk might contain previous versions of the
             distribution files. The files are replaced during in-
             stallation with new files, but the old files are not
             automatically purged. Purging is recommended. In re-
             sponse to the purging prompt, press <RET> to purge the
             files, or type N to keep them.

                                     NOTE

                        Digital recommends that you do
                        not delete previous versions of
                        on-line release notes.

             Step 7: Read informational messages.

             When you use VMS V4.x, the installation procedure dis-
             plays the following informational messages:


               All questions have been asked, installation continuing ...
               %VMSINSTAL-I-SYSDIR, This product creates a system disk directory
               VMI$ROOT:[SYSTEST.SNADDXF].

               The IVP for this product, SNADDXF$IVP.COM, can be found in
               the SNADDXF subdirectory of SYS$TEST.
                         
               To install the DDXF images as shareable each time the
               system reboots, you must add the following line to your
               system startup procedure:

                 $ @SYS$MANAGER:SNADDXF$STARTUP

             When you use VMS V5.x, the installation procedure dis-
             plays the following informational messages:








          Installing the DECnet/SNA VMS DDXF Software          1-13

 






               All questions have been asked, installation continuing ...
               %VMSINSTAL-I-SYSDIR, This product creates a system disk directory
               VMI$ROOT:[SYSTEST.SNADDXF].

               The IVP for this product, SNADDXF$IVP.COM, can be found in
               the SNADDXF subdirectory of SYS$TEST.

               To install the DDXF images as shareable each time the
               system reboots, you must add the following line to your
               system startup procedure:

                 $ @SYS$STARTUP:SNADDXF$STARTUP

               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their
               target directories...

             Step 8: The IVP is run.

             The installation procedure now calls the IVP to verify
             that the DDXF software was successfully installed.
             The system displays the following messages:

                  DECnet/SNA VMS DDXF Installation Verification Procedure.

                                             NOTE
                  This procedure only verifies that the DDXF software has been
                  correctly installed on your VMS system. It does NOT
                  verify that all DECnet/SNA Gateway (or VMS/SNA), and IBM
                  parameters have been set up correctly. See the DECnet/SNA
                  VMS Gateway Management Guide and the Guide for IBM Parameters
                  for your interconnect product for information on these 
                  parameters.

                  The IVP will now run DDXF and attempt to sign on to DISOSS
                  specifying an invalid Gateway and access name. This verifies
                  that the DDXF shareable library and all error message files
                  have been correctly installed. The following messages will
                  be displayed if you have a Gateway:

                                     NOTE
                        Expect the following messages.
                        They are not installation error
                        messages; they are simply a way
                        to verify that the DDXF software
                        is installed correctly.




          1-14  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 


                  Starting session for DDXF IVP
                  %SNADOC-E-NOSIGN, failed to sign on to DISOSS
                  -SNADDXF-E-DIARESFAI, DIA/LU6.2 resources not available
                  -SNA-E-SNAASSFAI, failed to assigned an I/O channel to _SNA0:
                  -SYSTEM-W-NOSUCHDEV, no such device available


                  If you have a VMS/SNA product then expect the following
                  error message.

                       Starting session for DDXF IVP
                       %SNADOC-E-NOSIGN, failed to sign on to DISOSS
                       -SNADDXF-E-DIARESFAI, DIA/LU6.2 resources not available
                       -SNA-E-SNAASSFAI, failed to establish SNA session
                       -SYSTEM-W-NOSUCHDEV, access name does not exist

               Using foreign command SNADOC...
               $  SNADOC/gateway=""/access" "/user=ddxf ivp directory
               Starting session for DDXF IVP
               %SNADOC-E-NOSIGN, failed to sign on to DISOSS
               -SNADDXF-E-DIARESFAI, DIA/LU6.2 resources not available
               -SNA-E-SNAASSFAI, failed to assign an I/O channel to _SNA0:
               -SYSTEM-W-NOSUCHDEV, no such device available

             The display continues.

                 The IVP will now run DDXF to display the version of the
                 product installed.

               Using DCL verb TRANSFER/DDXF...
               $ TRANSFER/DDXF show version
                
               DECnet/SNA VMS SNADDXF V1.4_90
               Image file DUA0:[SYS0.SYSCOMMON.][SYSEXE]SNADOC.EXE

               DECnet/SNA VMS DDXF V1.4 Installation Verification completed
               successfully

             Step 9: End the Installation Procedure

                     DECnet/SNA VMS DDXF V1.4
 
                 Please be sure to edit system startup files, as described in
                 Appendix A of the DECnet/SNA VMS DDXF User's Guide.








          Installing the DECnet/SNA VMS DDXF Software          1-15

 


                  If you have installed DDXF previously and the version is
                  lower than V1.2, then you MUST convert your old VUP file
                  (sys$system:snadocvup.dat) to the new format.  For details
                  on conversion, see your DDXF on-line release notes.

                 Installation of SNADDXF V1.4 completed at hh:mm

             If you typed Y in response to the prompt that requests
             a file purge, previous versions of the files are now
             purged.

             If the installation procedure is successful, the exe-
             cutable files are moved to their target directory.

                                     NOTE
                        The release notes file installed
                        by VMSINSTAL has a different
                        name in each maintenance re-
                        lease.

                       VMSINSTAL procedure done at hh:mm

               $ LOGOUT <RET>
               SYSTEM     logged out at dd-mmm-yyyy hh:mm

             When the installation procedure is complete, you can
             continue to install more products or end the installa-
             tion procedure. To end the procedure, press <CTRL/Z>
             or the <RET> key.

             VMSINSTAL deletes or changes entries in the process
             symbol tables during the installation. Therefore, if
             you are going to continue using the system manager's
             account and want to restore those symbols, you should
             log out and log in again.









          1-16  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 


          1.4 Files Created During Installation

             During installation, VMSINSTAL creates the files in
             the location shown in Table 2-1.

          Table 1-2: Files Created During Installation

          _______________________________________________________
          File Name           Location          Description
          _______________________________________________________
          DDXF_MAILSHR.EXE    SYS$SHARE         VMS MAIL inter-
                                                face

          DDXF_MAILSHRP.EXE   SYS$SHARE         Protected VMS
                                                MAIL interface

          SNADOC.EXE          SYS$SYSTEM        User interface

          SNADOCHELP.HLB      SYS$HELP          Help library

          SNADOCMSG.EXE       SYS$MESSAGE       Message file

          SNADOCVUP.DAT       SYS$SYSTEM        Blank VUP file

          SNADOCVUP.EXE       SYS$SYSTEM        VUP utility

          SNADOCVUPHELP.HLB   SYS$HELP          VUP help library

          SNADDXF_MAIL_       SYS$MANAGER       Mail start-up
          START.COM                             file

          SNADDXF_MAIL_       SYS$MANAGER       Mail stop file
          STOP.COM

          SNADOC_PROFILE.PRF  SYS$EXAMPLES      Profile file tem-
                                                plate

          SNADDXF$STARTUP.COM SYS$MANAGER       Start-up command
                                                procedure for VMS
                                                V4.x





          Installing the DECnet/SNA VMS DDXF Software          1-17

 






          Table 1-2 (Cont.): Files Created During Installation


          _______________________________________________________
          File Name           Location          Description
          _______________________________________________________
          SNADDXF$STARTUP.COM SYS$STARTUP       Start-up command
                                                procedure for VMS
                                                V5.x

          SNADDXFMSG.EXE      SYS$MESSAGE       Message file

          SNADDXFSHR.EXE      SYS$SHARE         Library of DDXF
                                                routines

          SNADDXF014.RELEASE_ SYS$HELP          Release notes
          NOTES
          _______________________________________________________

             DDXF HELP is added to the system HELP. DDXF HELP ex-
             plains how to start DDXF and how to use DDXF with VMS
             MAIL to send mail to DISOSS users.

          1.5 Installing and Reinstalling DDXF

             To install DDXF by using VMSINSTAL, follow the steps
             preparatory to using VMSINSTAL in the Guide to VMS
             Software Installation. If you need to reinstall
             DDXF, follow the preparation information and, in par-
             ticular, make sure that there are no mail daemons.
             For information on DDXF mail daemons, refer to the
             DECnet/SNA VMS DDXF User's Guide.

                                     NOTE

                        After installing DDXF on your
                        system, refer to DECnet/SNA VMS
                        DDXF User's Guide for informa-
                        tion about managing DDXF.







          1-18  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 



          1.6 Using the DDXF Software in a VAXcluster

             After you have installed the DDXF software on one node
             of a VAXcluster, you can install it on the other nodes
             of the VAXcluster. Execute the SNADDXF$STARTUP.COM
             procedure on each node as follows:

               $@SYS$MANAGER:SNADDXF$STARTUP.COM

                                     NOTE

                        For nodes running VMS V5.0,
                        the command procedure is in the
                        SYS$STARTUP directory.

             If you are using VMS V5.0, you must activate a DDXF li-
             cense for each node in the VAXcluster that will exe-
             cute and run the DDXF software. You can activate the
             license in one of the following ways:

              _  Log in to each VAXcluster node, and enter the
                 LICENSE LOAD command.

              _  Invoke the VMS SYSMAN Utility to execute the LICENSE
                 LOAD command on the desired VAXcluster nodes. See
                 the VMS SYSMAN Utility Manual for details on defin-
                 ing your management environment, and executing
                 commands on other nodes.

             For more information on the LICENSE LOAD command, re-
             fer to the VMS License Management Utility Manual.


          1.7 Sample Installation with VMS V4.6
 
             This section contains a sample installation of the
             DDXF software. Note that this is only a sample. Unless
             otherwise stated, every command line ends with a
             <RET>.







          Installing the DECnet/SNA VMS DDXF Software          1-19

 






               $@SYS$UPDATE:VMSINSTAL SNADDXF014 MTA0: OPTIONS N
 
               VAX/VMS Software Product Installation Procedure V4.6

               It is 25-JUL-1988 at 10:55.
               Enter a question mark (?) at any time for help.
               * Are you satisfied with the backup of your system disk [YES]? Y

               Please mount the first volume of the set on MTA0:.
               * Are you ready? Yes

               %MOUNT-I-MOUNTED, SNADDXF mounted on MTA0
               The following products will be processed: SNADDXF V1.4

                Beginning installation of SNADDXF V1.4 at 10:56

               %VMSINSTAL-I-RESTORE, Restoring product saveset A ...

               Release Notes Options:
                1.   Display release notes
                2.   Print release notes
                3.   Both 1 and 2
               * Select option [3]: 2 <RET>
               * Queue name [SYS$PRINT]: <RET>
               * Do you want to continue the installation [N]? Y<RET>
               
      %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully
       moved to SYS$HELP.

            * Do you want to run the IVP after the installation [YES]? <RET>
            * Do you want to purge files replaced by this installation [YES]? <RET>
            
             All questions have been asked, installation continuing ...
      
              %VMSINSTAL-I-SYSDISK, This product creates system disk directory
               VMI$ROOT:[SYSTEST.SNADDXF].
     
                   The IVP for this product, SNADDXF$IVP.COM, can be found in
                   the SNADDXF subdirectory of SYS$TEST.

                   To install the DDXF images as shareable each time the
                   system reboots, you must add the following line to your
                   system startup procedure:
     
                  $ @SYS$MANAGER:SNADDXF$STARTUP

               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target
               directories...



          1-20  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 






                     DECnet/SNA VMS DDXF Installation Verification Procedure
      
                                            NOTE
                   This procedure only verifies that the DDXF software has been
                   correctly installed on your VAX/VMS system.  It does NOT
                   verify that all DECnet/SNA Gateway (or VMS/SNA ), and IBM
                   parameters have been set up correctly.  See the DECnet/SNA
                   VMS Gateway Management Guide and the Guide to IBM Parameters
                   for your interconnect product for information on these 
                   parameters.

                   The IVP will now run DDXF and attempt to sign on to DISOSS
                   specifying an invalid Gateway and Access Name. This verifies
                   that the DDXF shareable library and all error message files
                   have been correctly installed. The following messages will
                   be displayed if you have a Gateway.

                   Starting session for DDXF IVP
                   %SNADOC-E-NOSIGN, failed to sign on to DISOSS
                   -SNADDXF-E-DIARESFAI, DIA/LU6.2 resources not available
                   -SNA-E-SNAASSFAI, failed to assign an I/O channel to _SNA0:
                   -SYSTEM-W-NOSUCHDEV, no such device available

                   If you have a VMS/SNA product then expect the following
                   error message.

                   Starting session for DDXF IVP
                   %SNADOC-E-NOSIGN, failed to sign on to DISOSS
                   -SNADDXF-E-DIARESFAI, DIA/LU6.2 resources not available
                   -SNALU62-E-NOTEST, failed to establish SNA session
                   -SNA-E-NO-SUCACC, Access name does not exist

               Using foreign command SNADOC...
               $ SNADOC/gateway=" "/access=" "/user=ddxf ivp directory

               Starting session for DDXF IVP
               %SNADOC-E-NOSIGN, failed to sign on to DISOSS
               -SNADDXF-E-DIARESFAI, DIA/LU6.2 resources not available
               -SNA-E-SNAASSFAI, failed to assign an I/O channel to _SNA0:
               -SYSTEM-W-NOSUCHDEV, no such device available

                   The IVP will now run DDXF to display the version of the
                   installed product.

               Using DCL verb TRANSFER/DDXF...
               $ TRANSFER/DDXF show version
                DECnet/SNA VMS SNADDXF V1.4_90

                Image file DUA0:[SYS0.SYSCOMMON.][SYSEXE]SNADOC.EXE

               DECnet/SNA VMS DDXF V1.4 Installation Verification completed
               successfully



          Installing the DECnet/SNA VMS DDXF Software          1-21

 



                                    DECnet/SNA VMS DDXF V1.4

                   Please be sure to edit system startup files, as described in
                   Appendix A of the DECnet/SNA VMS DDXF User's Guide.

                   If you have installed DDXF previously and the version is
                   lower than V1.2 then you MUST convert your old VUP file
                   (sys$system:snadocvup.dat) to the new format. For detail on
                   conversion see your DDXF on-line release notes.

                Installation of SNADDXF V1.4 completed at 11:03
                VMSINSTAL procedure done at 11:04


          1.8 Sample Installation with VMS V5.0

             This section contains a sample installation of the
             DDXF software. Note that this is only a sample. The
             installation procedure might be modified slightly in
             future maintenance updates.

             Unless otherwise stated, every command line ends with
             a <RET>.

               $ @SYS$UPDATE:VMSINSTAL SNADDXF014 MTA0: OPTIONS N


                VAX/VMS Software Product Installation Procedure V5.0

               It is 25-JUL-1988 at 10:55.
               Enter a question mark (?) at any time for help.
               * Are you satisfied with the backup of your system disk [YES]? Y
               Please mount the first volume of the set on MTA0:.

               * Are you ready? Yes

               %MOUNT-I-MOUNTED, SNADDXF mounted on MTA0
               The following products will be processed: SNADDXF V1.4

                Beginning installation of SNADDXF V1.4 at 10:56
               %VMSINSTAL-I-RESTORE, Restoring product saveset A ...

               Release Notes Options:






          1-22  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 






                1.   Display release notes
                2.   Print release notes
                3.   Both 1 and 2
               * Select option [3]: 2 <RET>
               * Queue name [SYS$PRINT]: <RET>
               * Do you want to continue the installation [N]? Y<RET>

      %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully
       moved to SYS$HELP.

                       Product:      SNA-DDXF
                       Producer:     DEC
                       Version:      V1.4
                       Release Date: 01-AUG-1988
  
        
* Does this product have an authorization key registered and loaded [YES]? <RET>
* Do you want to purge files replaced by this installation [YES]? <RET>
* Do you want to run the IVP after the installation [YES]? <RET>

                   All questions have been asked, installation continuing ...
               %VMSINSTAL-I-SYSDIR, This product creates system disk directory
               VMI$ROOT:[SYSTEST.SNADDXF].

                   The IVP for this product, SNADDXF$IVP.COM, can be found in
                   the SNADDXF subdirectory of SYS$TEST.

                   To install the DDXF images as shareable each time the
                   system reboots, you must add the following line to your
                   system startup procedure:

                   $ @SYS$STARTUP:SNADDXF$STARTUP

               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target
               directories...
  
                   DECnet/SNA VMS DDXF Installation Verification Procedure.

                                             NOTE
                   This procedure only verifies that the DDXF software has been
                   correctly installed  on  your  VAX/VMS system.  It does NOT
                   verify  that  all DECnet/SNA  Gateway (or VMS/SNA ), and IBM
                   parameters have been set up  correctly.  See  the  DECnet/SNA
                   VMS Gateway Management Guide and the Guide to IBM Parameters
                   for your interconnect product for information on these 
                   parameters.





          Installing the DECnet/SNA VMS DDXF Software          1-23

 






                   The IVP will now run  DDXF and attempt to sign on to DISOSS
                   specifying an invalid Gateway and Access Name. This verifies
                   that the DDXF shareable library and all error message  files
                   have been correctly installed. 

                   The following messages with be displayed if you have a Gateway.
                   
                   Starting session for DDXF IVP
                   %SNADOC-E-NOSIGN, failed to sign on to DISOSS
                   -SNADDXF-E-DIARESFAI, DIA/LU6.2 resources not available
                   -SNA-E-SNAASSFAI, failed to assign an I/O channel to _SNA0:
                   -SYSTEM-W-NOSUCHDEV, no such device available

                   If you have a VMS/SNA product then expect the following
                   error message.

                   Starting session for DDXF IVP
                   %SNADOC-E-NOSIGN, failed to sign on to DISOSS
                   -SNADDXF-E-DIARESFAI, DIA/LU6.2 resources not available
                   -SNALU62-E-NOTEST, failed to establish SNA session
                   -SNA-E-NO-SUCACC, Access name does not exist

               Using foreign command SNADOC...
               $ SNADOC/gateway=" "/access=" "/user=ddxf ivp directory
               Starting session for DDXF IVP
               %SNADOC-E-NOSIGN, failed to sign on to DISOSS
               -SNADDXF-E-DIARESFAI, DIA/LU6.2 resources not available
               -SNA-E-SNAASSFAI, failed to assign an I/O channel to _SNA0:
               -SYSTEM-W-NOSUCHDEV, no such device available

                   The IVP will now run DDXF to display the version of the
                   installed product.

               Using DCL verb TRANSFER/DDXF...
               $ TRANSFER/DDXF show version
                DECnet/SNA VMS SNADDXF V1.4_90
                Image file DUA0:[SYS0.SYSCOMMON.][SYSEXE]SNADOC.EXE

               DECnet/SNA VMS DDXF V1.4 Installation Verification completed
               successfully
                                    DECnet/SNA VMS DDXF V1.4

                   Please be sure to edit system startup files, as described in
                   Appendix A of the DECnet/SNA VMS DDXF User's Guide.

                   If you have installed DDXF previously and the version is
                   lower than V1.2 then you MUST convert your  old VUP file
                   (sys$system:snadocvup.dat) to the new format. For detail on
                   conversion see your DDXF on-line release notes.

                Installation of SNADDXF V1.4 completed at 11:03



          1-24  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 






                VMSINSTAL procedure done at 11:04










































          Installing the DECnet/SNA VMS DDXF Software          1-25

 













                                                                2
          _______________________________________________________
                                 Ensuring that DDXF Works Properly




             The Installation Verification Procedure (IVP) checks
             that all the DDXF files are in the correct places.
             You should now check that the link to DISOSS actually
             works by performing the following steps.

              1. At the DCL prompt, start DDXF by entering the fol-
                lowing command:

                  $TRANSFER/DDXF

                The SNADOC prompt appears.
                  SNADOC>

              2. Use the SNADOC SEARCH command to create an index
                of documents in the IBM DISOSS library. Enter the
                following command to create an index of documents
                in the IBM DISOSS library.

                  SNADOC>SEARCH/ALL

                If you get an index of DISOSS documents, the commu-
                nications link between DDXF and DISOSS is working
                properly. If you do not get an index of documents,
                refer to the DECnet/SNA VMS DDXF User's Guide for a
                list of error messages and the suggested corrective
                action.



          Ensuring that DDXF Works Properly                    2-1

 













                                                                3
          _______________________________________________________
                              Solving DECnet/SNA VMS DDXF Problems




             This chapter discusses problems you might have using
             DECnet/SNA VMS DDXF. Subsequent pages contain solu-
             tions for each problem.

             Problem     Symptom
             Number

             1           You receive an IBM sense code following a
                         general error message from DDXF.

             2           You receive an error message indicating
                         that processing of FINAL-FORM text has
                         been aborted.

             3           When you FILE or SEND a document, DISOSS
                         accepts the smaller documents but rejects
                         the larger documents.












          Solving DECnet/SNA VMS DDXF Problems                 3-1

 






             DDXF Problem 1

             You receive an IBM sense code following a general er-
             ror message from DDXF. For example, you might receive
             one of the following sense codes: 0801 or 0805.

             Solution:
             The secondary DDXF error message indicates a problem
             in the remote IBM host. The IBM sense code provides
             details about the problem on the IBM side.

             Sense code 0801 indicates that a logical unit (LU) is
             not available and that DISOSS is not running. See your
             IBM system programmer.

             Sense code 0805 indicates that all available LUs are
             in use. Wait until an LU becomes free, or ask your sys-
             tem programmer to determine whether enough LUs are
             defined.

             On occasion, you might receive other IBM sense codes.
             You can look up their meanings in IBM's Systems Network
             Architecture Formats, Order No. GA27-3136.




















          3-2  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 






             DDXF Problem 2

             You receive the following error message indicating
             that processing of FINAL-FORM text has been aborted.
               SNADDXF-E-ABORTED, FINAL-FORM text processing aborted

             Solution:

             This message indicates an error in the document you
             are trying to retrieve. Check that you have specified
             a FINAL-FORM document. The profile term you specified
             might indicate a FINAL-FORM document, but you might
             actually be trying to retrieve an ASCII file.






























          Solving DECnet/SNA VMS DDXF Problems                 3-3

 






             DDXF Problem 3

             When you FILE or SEND documents, DISOSS accepts the
             smaller documents but rejects the larger ones. You
             receive the following IBM exception message:
               -SNADDXF-E-EXCODE, I/O error at DISOSS host

             Solution:

             This situation usually means that the DISOSS libraries
             have become segmented. You do not have enough contigu-
             ous room for large files. Ask your IBM system program-
             mer to examine the DISOSS library file system.






























          3-4  DECnet/SNA VMS DDXF Installation and Problem Determination Guide

 














          _______________________________________________________

                                                            Index



          H                            S

          Help                         Software requirements,
            installation procedure,        1-2
                1-10


          I
          Installation Verification
              Procedure (IVP), run-
              ning during installa-
              tion,  1-12
          Installing the DDXF
              software
            preinstallation tasks,
                1-1


          R
          Release notes
            accessing,  1-2
            file specification for,
                1-2







                                                          Index-1
