
    
    AA-JQ52C-TN
    
    
                                   June 1988
    
    This guide provides the information necessary to install the VAX 
    DECscan VMS and ELN BITBUS Drivers.
    
    REVISION/UPDATE		  This is a revision
    INFORMATION:		  to AA-JQ52B-TN.
    
    
    
    


VAX DECscan VMS and ELN
BITBUS Drivers
Software Installation Manual



Preface


PURPOSE OF THIS MANUAL

This manual describes how to install the DECscan VMS and ELN BITBUS drivers 
software.


INTENDED AUDIENCE

This manual is intended for use by the system manager or any individual 
responsible for installing and maintaining the DECscan  BITBUS drivers 
software.


HOW TO USE THIS MANUAL
 
This manual contains six chapters and three appendices:

    oo	 Chapter 1 contains general information on the DECscan BITBUS drivers 
         software.

    oo	 Chapter 2 describes the preparation for installation requirements.

    oo	 Chapter 3 contains the installation procedure.

    oo	 Chapter 4 describes the post installation requirements.

    oo	 Chapter 5 describes the installation verification procedure.

    oo	 Chapter 6 describes the error messages and how to recover from them.

    oo	 Appendix A contains a sample VMS DECscan BITBUS drivers  software 
         installation procedure.

    oo	 Appendix B contains a sample VAXELN DECscan BITBUS drivers  software 
         installation procedure. 

    oo	 Appendix C contains a list of the files created during the 
         installation of the DECscan BITBUS drivers software.




RELATED DOCUMENTS

In this manual, you will find it helpful to refer to the following related 
manuals. They can help you use and understand the IBQ01 BITBUS Controller.

IBQ01 BITBUS Controller Hardware Installation Manual (EK-IBQ01-IN)

IBQ01 BITBUS Controller User's Guide (EK-IBQ01-UG)

IBQ01 BITBUS Controller Technical Manual (EK-IBQ01-TM)

Distributed Control Modules Handbook  (Intel 230973-001)

VAX/VMS System Services Reference Manual (AA-Z501B-TE)

IEEE BITBUS Specification (IEEE P1118)

IBQ01 BITBUS Driver Release Notes

IBQ01 BITBUS Controller Software Product Description

VAX/VMS System Management Operations Guide

VAX/VMS Software Installation Guide

VAX/VMS Optional Software Cross Reference Table


CONVENTIONS

This section describes the special symbols used in this manual.

...	     Horizontal or vertical ellipses in text mean that the information 
             not directly related to the description has been omitted.

[yes]	     The information inside the square bracket contains the default 
             answer to questions that VMSINSTAL asks throughout the 
             installation procedure. To take the default answer, press the 
             return key.

Corrections and suggestions for improving this publication are welcomed.





CHAPTER 1
INTRODUCTION


1.1 PRODUCT DESCRIPTION

VAX DECscan VMS and ELN BITBUS drivers software are the host MicroVAX II to 
IBQ01 BITBUS Controller communications link and associated utilities.

The following components are included in V2.0:

    oo	 IBQ01 VAX/VMS software
    oo	 8044 cross assembler
    oo	 IBQ01 VAXELN software

Please see the IBQ01 User's Guide for more details.


1.2 PRODUCT COMPATIBILITY

This manual describes the installation of V2.0 of the DECSCAN VMS and ELN 
BITBUS drivers software.  For the installation of subsequent versions, please 
see the release notes before continuing.


CHAPTER 2
INSTALLATION PREPARATION


2.1 CHECKING THE CONTENTS OF THE KIT

The DECscan VMS and ELN BITBUS drivers software is available on RX50 or TK50 
or magtape. Your cover letter specifies the number and contents of your media. 
Contact your DIGITALTM representative if any components of the kit are missing. 



2.2 PREREQUISITE SOFTWARE PRODUCTS

You must have a valid version of VMS installed (V4.4 or later) in order to 
install the DECscan BITBUS software. To install the DECscan VAXELN software, 
V3.0 or later of the VAXELN Tool Kit must be installed.  Refer to the VAX/VMS 
Optional Software Cross Reference Table for the required version.


2.3 REQUIRED DISK SPACE

You must have at least 1000 free disk blocks to install and run the DECscan 
VAX/VMS software, or to install the DECscan VAXELN software.


2.4 SPECIAL REQUIREMENTS 

The IBQ01 hardware must be installed with correct CSR and vector addresses for 
the DECscan VAX/VMS software to be successfully installed.  Please refer to 
the IBQ01 Hardware Installation Manual for details.


2.5 APPROXIMATE INSTALLATION TIME

The approximate installation time for the DECscan BITBUS software is 10 
minutes.


2.6 REGISTER THE LICENSE

If your system is running VAX/VMS V5.0 or later, this product supports the 
License Management Facility features provided by VMS, and requires that a 
Product Authorization Key (PAK) be registered. To register your PAK, use the 
command procedure @SYS$UPDATE:VMSLICENSE.COM. Reference the VMS License 
Management Utility Reference Manual for information pertaining to this command 
procedure and to management features of LMF.


CHAPTER 3
INSTALLATION


3.1 VMSINSTAL

DECscan VMS and ELN BITBUS drivers software is installed using the standard 
VMS installation procedure VMSINSTAL. Before attempting to install the DECscan 
BITBUS software, be sure to read the information regarding the proper use of 
VMSINSTAL in Chapter 5 of the VAX/VMS Guide to Software Installations.

Prior to installing the DECscan BITBUS software, ensure that:

    1.	 You have VAX VMS V4.4 or later installed on the host. 

    2.	 Your system has enough free disk blocks on the system disk. See 
         Chapter 2, Section 2.3.

    3.	 You have read Chapter 5 of the VAX/VMS Software Installation Guide 
         for information regarding the proper use of VMSINSTAL.

It is essential that all users read the release notes in 
SYS$SYSROOT:[SYSHLP]IBQ020.RELEASE_NOTES.


3.2 INSTALLING VAX DECSCAN VMS AND ELN BITBUS DRIVERS SOFTWARE

To begin installation, log into the system manager's account and then invoke 
VMSINSTAL by typing:
$@SYS$UPDATE:VMSINSTAL <CR>

                                     NOTE
                        
                        If VMSINSTAL detects errors in 
                        your system environment, it 
                        will notify you and ask if you 
                        wish to continue the 
                        installation. Refer to Chapter 
                        5 of the VAX/VMS Software 
                        Installation Guide for 
                        additional information.
                        
VMSINSTAL will begin by printing a greeting message and asking you if you are 
satisfied with the backup of your system disk.
%VMSINSTAL-W-DECNET, Your DECnet network is up and running.
* Do you want to continue anyway [NO]? YES <CR>
* Are you satisfied with the backup of your system disk [YES]?<CR>
Please ask your system manager for the logical name of the device which 
services your media.  Assuming your logical name is MUA0:, the following 
interaction occurs:

* Where will the distribution volumes be mounted:MUA0:<CR>
Enter the products to be processed from the first distribution volume set.

This is the name shown on your software distribution kit.

* Products: IBQ <CR>

The system then asks if you are ready and, when you respond, it tells you when 
it is mounted.

Please mount the first volume of the set on MUA0:.
* Are you ready? YES <CR>
%MOUNT-I-MOUNTED, IBQ020 mounted on _MUA0:

The system then names the product and gives the installation start time.

The following products will be processed:

    IBQ V2.0

    Beginning installation of IBQ V2.0 at 14:33

    %VMSINSTAL-I-RESTORE, Restoring product saveset A...
The following release note message appears:
%VMINSTAL-I-RELMOVED, the product release notes have been 
successfully moved to SYS$HELP.

VMSINSTAL will then begin to restore the DECscan BITBUS software from your 
media. After VMSINSTAL has completed restoring the DECscan BITBUS software, 
the installation procedure will proceed with prompt.

This installation procedure will install either VAX/VMS or the VAXELN driver. 
The following question will determine which one:

* Which software would you like to install (VMS or ELN)? 
  VMS <CR>

Regardless of the response, you will see the following:

* Do you want to purge files replaced by this installation 
  [YES]? <CR>
If you have previous versions of DECscan BITBUS software installed, you may 
wish to purge files in order to recover disk space.

See the IBQ01 BITBUS Controller Hardware Installation Manual for details on 
setting the CSR and vector addresses.

At this point, separate processing for the DECscan VAX/VMS software and VAXELN 
software installation begins.

[t1.2]VMS - When you select the DECscan VAX/VMS software, the following is 
displayed:

    The IBQ01 kit will take about 10 minutes to install.

			IBQ V2.0

		  IBQ Software V2.0

Before any files are installed, the following questions are asked if you 
choose to install the VMS software.

These messages define the present configuration for this installation.  If 
they are correct, enter a return at the end of each line.  If they need to be 
changed, enter the correct value and then enter a return.

* Number of IBQ01 interfaces to be supported_[1]:<CR>
* Enter CSR address for interface 1 [760770]:<CR>
* Enter vector address for interface 1 [300]:<CR>

When VMSINSTAL has completed building the DECscan BITBUS software, it displays 
a series of messages that the files are being moved to their target 
directories.

The command file IBQ$STRUP.COM will be located in the 
directory SYS$SYSROOT:[SYSMGR].  This command file can be
used to load the BQDRIVER when the system is booted
if AUTOCONFIGURE is not used.  This file should then be added to 
SYS$MANAGER:SYSTARTUP.COM.

The INTERACTIVE INTERFACE program, IBQ$BCS.EXE, will be located 
in the directory SYS$SYSROOT:[SYSEXE].

The language definition files
    IBQ$FUNC.BAS
    IBQ$FUNC.FOR
    IBQ$FUNC.H
    IBQ$FUNC.MAR
    IBQ$DEF.MAR
    IBQ$FUNC.PAS
    IBQ$FUNC.PEN
will be located in the directory SYS$SYSROOT:[SYSHLP.EXAMPLES.IBQ].

The Installation Verification source and executable
    IBQ$IVP.FOR
    IBQ$IVP.EXE
will be located in the directory SYS$SYSROOT:[SYSTEST.IBQ]

The download utility for assembled 8044 files
IBQ$LD44V.EXE
will be located in the directory SYS$SYSROOT:[SYSEXE](SYS$SYSTEM)
After the DECscan BITBUS software files are moved to their final destinations, 
the driver is loaded, and the installation procedure will call the IVP.  After 
the IVP completes, VMSINSTAL will issue a message stating whether the IVP was 
successful or not. The release notes IBQ020.RELEASE_NOTES will be placed in 
the directory SYS$SYSROOT:[SYSHLP] (SYS$HELP).

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

The installation verification procedure will test that the software is 
properly installed and that there is an IBQ01 at the address specified.  
It cannot test that the interrupt vector is correct.
 __Driver_____Start____End____Dev___DDB______CRB______IDB_____Unit__UCB_____
 QDRIVER    80111910 80112130
                              BQA 801F9620 80194390 801F9E00
                                                                  0 80112130
 
 Device			Device       			 Error
 Name			Status       			 Count
 BAQ0:			Online       			 0
 
If the IVP did not complete successfully, ensure that you have met all 
prerequisites for installing the product.  See Chapter 5 for additional 
information on error recovery.  VMSINSTAL will not exit and display a 
"procedure done" message and the time of completion.  See Chapter 4 for 
post-installation requirements.

[t1.2]ELN - If the VAXELN software is to be installed, the following messages 
appear:
    The IBQ01 kit will take about 10 minutes to install.

			IBQ V2.0

		   IBQ Software V2.0

* The IBQ01 ELN library IBQ$ELNLIB is now being installed.


A message verifying installation of the installed product is then 
displayed.

Then:


* IBQ$LD44E.EXE, the ELN download utility is placed in 
SYS$SYSROOT:[SYSEXE].


The DECscan VAXELN IVP will now be run.  The user will be informed 
upon success or failure.

[t1.2]For either the VMS or ELN case prior to running the IVP, the 
installation procedure installs the following cross-assembler files, 
which are included in either software package and writes the 
following:

* The 8044 cross-assembler support software will be installed. The
* following files are included in this distribution:
*
* 1. IBQ$ASM44.EXE, the 8044 cross-assembler is placed in 
     SYS$SYSTEM.
* 2. IBQ$FLASH.A44, a sample 8044 program is placed in 
     [SYSHLP.EXAMPLES.IBQ]
* 3. IBQ$RMX51I.EXT, an include file for 8044 programs is placed in
*    [SYSHLP.EXAMPLES.IBQ]




CHAPTER 4
POST INSTALLATION REQUIREMENTS


4.1 THE VAX DECSCAN VMS BITBUS DRIVER SOFTWARE STARTUP PROCEDURE

The DECscan BITBUS software builds a startup procedure for the VMS driver. The 
startup procedure is named IBQ$STRUP.COM, and is placed in SYS$MANAGER. You 
should edit SYSTARTUP.COM to invoke this procedure at boot time. The following 
line should be added to your site-specific startup command file, 
SYSTARTUP.COM.


$ @SYS$MANAGER:IBQ$STRUP.COM




CHAPTER 5
INSTALLATION VERIFICATION


5.1 VAX DECSCAN VMS AND ELN BITBUS DRIVERS SOFTWARE INSTALLATION VERIFICATION 
PROCEDURE

The DECscan BITBUS software contains separate installation verification 
procedures for the DECscan VAXELN software and IBQ01 VAX/VMS software.

For the DECscan VAX/VMS software, IBQ$IVP.EXE verifies the correct 
installation of the software. This procedure is placed in the [.IBQ] 
subdirectory of the SYS$TEST directory by the installation procedure. The IVP 
is composed of three tests designed to verify the major functional components 
of the DECscan BITBUS software. Successful completion of the IVP indicates 
that the DECscan BITBUS software was installed correctly. 

For the DECscan VAXELN software, a command procedure (IBQ$ELNIVP) verifies 
correct installation of the DECscan VAXELN software only.  No hardware testing 
is performed.

The DECscan BITBUS software IVPs may be run during the installation itself, or 
at any time afterwards.  VMSINSTAL invokes the IVP after the software 
components are moved to their target directories. You will receive a message 
that the IVP is complete, and whether the IVP was successful or not. Please 
note that running the IVP independent of the installation will require the 
process to have SYSPRV, CMEXEC, and CMKRNL privileges. To run the IVP 
independently of the installation procedure, type:

$ RUN SYS$SYSROOT:[SYSTEST.IBQ]IBQ$IVP.EXE (VMS software)

  or

$ @SYS$SYSROOT:[SYSTEST.IBQ]IBQ$ELNIVP (VAXELN software)

The IVP will then run tests of the DECscan BITBUS software, and print a 
SUCCESS/FAIL message next to the test number. When the tests are complete, the 
IVP displays a SUCCESS/FAIL message stating whether or not the installation 
was successful. Compare your output with the expected output contained in 
Appendix A or B.

                                     NOTE
                        
                        The DECscan BITBUS software IVP 
                        (IBQ$IVP.EXE or IBQ$ELNIVP.COM) 
                        is independent of the DECscan 
                        BITBUS software. If you need to 
                        recover disk space, you may 
                        delete this file without any 
                        adverse effect on DECscan 
                        BITBUS software.
                        
If errors occur during the IVP, see Chapter 6 for information on error 
recovery.


5.2 RUNNING THE IVP

There are no manual interventions required to run either of the DECscan BITBUS 
IVPs.


5.3 OUTPUT OF THE IVP

A sample of the IVP output is shown in Appendix A or B.


CHAPTER 6 
ERROR RECOVERY

The following is a list of errors you may receive during the running of VMS 
install, and the solutions for correcting the errors.


6.1 INSTALLATION ERRORS

1.   Error       --     QUANTITY-F-NOSPACE, Insufficient disk space for 
                     installation.

   Solution       --     Your system does not have enough free blocks on the 
                     system disk to install the DECscan BITBUS software. See 
                     Chapter 2, Section 2.3, for disk space requirements.

2.   For an explanation of any LICENSE facility messages or errors and of any 
   corresponding User Actions required, please reference the VMS License 
   Management Utility Reference Manual.


6.2 VERIFICATION ERRORS

1.   Error	--   %IBQ01-F-ACC, Error accessing IBQ01REC, file not found.

   Solution	--   The startup procedure (IBQ$STRUP.COM) has not been 
                   executed. See Chapter 4, Section 4.1, for information on 
                   the IBQ01 startup command procedure.

2.   Error	--   %RMS-F-PRV, No privilege for the attempted operation.

   Solution	--   You are attempting to use the IVP without the proper 
                   privileges. See Chapter 5, Section 5.1, for information on 
                   the privileges needed to run the IVP.


6.3 PROBLEM DETERMINATION REPORTING

If the error occurs while an IBQ01 program is being compiled or executed, and 
you have reason to believe that the error is due to a problem with the DECscan 
BITBUS software, you should submit a Software Performance Report (SPR). 

When you prepare an SPR, please do the following:

    1.	 Provide as complete a description of the problem as possible, trying 
         not to overlook any details. Include in the description the version 
         number of DECscan BITBUS software.

    2.	 Reduce the problem to as small a size as possible, preferably to a 
         program of 200 source lines or less, including user INCLUDE files.

    3.	 Submit program sources on machine-readable media (floppy diskette or 
         magnetic tape) if possible. All media will be returned when the SPR 
         is answered.

    4.	 Provide a listing of the program, compiled with the DECscan BITBUS 
         software command, /LIST/CROSS_REFERENCE/SHOW=ALL.

    5.	 Remember to include listings of any command files, linker maps, 
         relevant data files, and so on.


APPENDIX A
SAMPLE VAX/VMS DECSCAN BITBUS DRIVERS SOFTWARE INSTALLATION 

These examples depict installation of V2.0. The first example is for a V4.4 
installation, and the second example is for a V5.0 installation. All 
references to version numbers will reflect the version you are installing 
during your installation.

Example 1
$SET DEF SYS$UPDATE

$@ vmsinstal

             VAX/VMS Software Product Installation Procedure V4.4

It is 18-MAY-l988 at 17:59.
Enter a question mark (?) at any time for help.

* Are you satisfied with the backup of our system disk [YES]?
* Where will the distribution volumes be mounted: MUA0:

Enter the products to be processed from the first distribution 
volume set.
* Products: IBQ
Please mount the first volume of the set on MUA0:
* Are you ready? YES
%MOUNT-I-MOUNTED, IBQ020 mounted on _MUA0:

The following will be processed:

    IBQ V2.0
                 Beginning installation of IBQ V2.0 at 17:59

%VMSINSTAL-I-RESTORE, Restoring product saveset A...
* Do you want to run the IVP after the installation [YES]?
* Which software would you like to install (VMS or ELN)?: VMS
* Do you want to purge files replaced by this installation [YES]?

The IBQ kit will take about ten minutes to install.

IBQ V2.0

IBQ Software V2.0

%VMSINSTAL-I-SYSDIR, This product creates a system directory 
[SYSHLP.EXAMPLES.IBQ]

%VMSINSTAL-I-SYSDIR, This product creates system directory 
[SYSTEST.IBQ].
* Number of IBQ01 interfaces to be supported_[1]:
* Enter CSR address for interface 1 [760770]:
* Enter vector address for interface 1 [300]:

The command file IBQ$STRUP.COM will be located in the directory 
SYS$SYSROOT:[SYSMGR]. This command file can be used to load the 
BQDRIVER when the system is booted if AUTOCONFIGURE is not used. 
This file should then be added to SYS$MANAGER:SYSTARTUP.COM

The INTERACTIVE INTERFACE program, IBQ$BCS.EXE, will be located in 
the directory SYS$ROOT:[SYSEXE].

The language definition files
	 IBQ$FUNC.BAS
	 IBQ$FUNC.FOR
	 IBQ$FUNC.H
	 IBQ$FUNC.MAR
	 IBQ$DEF.MAR
 	 IBQ$FUNC.PAS
	 IBQ$FUNC.PEN
will be located in the directory SYS$ROOT:[SYSHLP.EXAMPLES.IBQ]

The Installation Verification source and executable
	 IBQ$IVP.FOR
	 IBQ$IVP.EXE
will be located in the directory SYS$SYSROOT:[SYSTEST.IBQ]

The download utility for assembled 8044 files

	 IBQ$LD44V.EXE

will be located in the directory SYS$SYSROOT:[SYSEXE]

The 8044 cross-assembler support software will be installed. 
The following files are included in this distribution:

    1.	 IBQ$ASM44.EXE, the 8044 cross-assembler is placed in 
    	 SYS$SYSTEM.

    2.	 IBQ$FLASH.A44, a sample 8044 program is placed in
    	 [SYSHLP.EXAMPLES.IBQ].

    3.	 IBQ$RMX51I.EXT, an include file for 8044 programs is 
    	 placed in [SYSHLP.EXAMPLES.IBQ].

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

The installation verification procedure will test that the driver is 
properly installed and that there is an IBQ01 at the address specified. 
It cannot test that the interrupt vector is correct.

--Driver-----Start----End----Dev---DDB------CRB------IDB-----Unit--UCB---
BQDRIVER     8011E1B0 9011EB90
                       BQA 80247640 8001E2520 80247340
						     0 8011EB90

Device		   Device	       Error
Name		   Status	       Count
BQA0:		   Online	       0				     
Installation Verification Procedure IBQ V2.0 
***BOARD A INSTALLED, TESTING FOLLOWS***

Successful board communications
Successful short DMA
Successful long DMA

TESTING COMPLETE:
Number of devices assigned:     1
Number of devices passed:     1

Installation of IBQ V2.0 completed at 18:03

Enter the products to be processed from the next distribution 
volume set. 
* Products: Exit

VMSINSTAL procedure done at 18:03

Example 2

$ set def sys$update
$ @vmsinstal

    VAX/VMS Software Product Installation Procedure V5.0

It is 18-MAY-1988 at 17:44.
Enter a question mark (?) at any time for help.

%VMSINSTAL-W-DECNET, your DECnet network is up and running.
* Do you want to continue anyway [NO]? yes
* Are you satisfied with the backup of your system disk [YES]?
* Where will the distribution volumes be mounted: MUA0

Enter the products to be processed from the first distribution 
volume set.
* Products: IBQ								     
* Options:
Please mount the first volume of the set on MUA0:
* Are you ready? YES
%MOUNT-I-MOUNTED, IBQ020 MOUNTED ON MUA0:

The following will be processed:

    IBQ V2.0

Beginning installation of IBQ V2.0 at 17:44

%VMSINSTAL-I-RESTORE, Restoring product saveset A...
%VMSINSTAL-I-RELMOVED, the product's release notes have been 
successfully moved to SYS$HELP.

	 Product:		       DECSCAN-BITBUS
	 Producer:		       DEC
	 Version:		       2.0
	 Release Date:		       30-MAY-1988

* Does this product have an authorization key registered and 
  loaded? Yes
* Do you want to run the IVP after the installation [YES]?
* Which software would you like to install (VMS or ELN)?: VMS
* Do you want to purge files replaced by this installation [YES]?

The IBQ01 kit will take about ten minutes to install.

			IBQ V2.0

		   IBQ Software V2.0

* Number of IBQ01 interfaces to be supported_[1]:
* Enter CSR address for interface 1 [760770]: 
* Enter vector address for interface 1 [300]:

The command file IBQ$STRUP.COM will be located in the directory 
SYS$SYSROOT:[SYSMGR]. This command file can be used to load the 
BQDRIVER when the system is booted if AUTOCONFIGURE is not used. 
This file should then be added to SYS$MANAGER:SYSTARTUP.COM.

the INTERACTIVE INTERFACE program, IBQ$BCS.EXE, will be located 
to the directory SYS$SYSROOOT:[SYSEXE].

The language definition files
    IBQ$FUNC.BAS
    IBQ$FUNC.FOR
    IBQ$FUNC.H
    IBQ$FUNC.MAR
    IBQ.DEF.MAR
    IBQ$FUNC.PAS
    IBQ$FUNC.PEN
will be located in the directory 
SYS$SYSROOT:[SYSHLP.EXAMPLES.IBQ]

The Installation Verification source and executable
    IBQ$IVP.FOR
    IBQ$IVP.EXE
will be located in the directory SYS$SYSROOT:[SYSTEST.IBQ]

The download utility for assembled 8044 files 
    IBQ$LD44V.EXE
will be located in the directory SYS$SYSROOT:[SYSEXE]

The 8044 cross-assembler support software will be installed. The 
following files are included in this distribution:

    1.	 IBQ$ASM44.EXE, the 8044 cross-assembler is placed in 
         SYS$SYSTEM.

    2.	 IBQ$FLASH.A44, a sample 8044 program is placed in
         [SYSHLP.EXAMPLES.IBQ].

    3.	 IBQ$RMX51I.EXT, an include file for 8044 programs is placed 
    	 in [SYSHLP.EXAMPLES.IBQ].

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

The installation verification procedure will test that the driver is 
properly installed and that there is an IBQ01 at the address specified. 
It cannot test that the interrupt vector is correct.

---Driver-----Start----End----Dev---DDB-----CRB-----IDB-----Unit---UCB---
BQDRIVER    802181D0  80218D60
		              BQA 802D6EA0 802B0730 802D7320

						            0 801E5FA0

	Device		Device		    Error
	Name		Status		    Count
	BQA0:		Online		        0

Installation Verification Procedure IBQ V2.0 ***BOARD A INSTALLED, 
TESTING FOLLOWS***

Successful board communications
Successful short DMA
Successful long DMA

TESTING COMPLETE:
Number of devices assigned:	       1
Number of devices passed:	       1

Installation of IBQ V2.0 completed at 17:49

Enter the products to be processed from the next distribution 
volume set. 
* Products: Exit

VMINSTAL procedure done at 17:50



APPENDIX B
SAMPLE VAXELN DECSCAN BITBUS DRIVERS SOFTWARE INSTALLATION

These examples depict installation of V2.0. The first example is for a VMS 
V4.4 installation and the second example is for VMS 5.0.

Example 1
$ SET DEF SYS$UPDATE
$ @vmsinstal

VAX/VMS Software Product Installation Procedure V4.4

It is 18-MAY-1988 at 18:03.
Enter a question mark (?) at any time for help.

* Are you satisfied with the backup of your system disk [YES]?
* Where will the distribution volumes be mounted: MUA0:

Enter the products to be processed from the first distribution 
volume set. 
* Products: IBQ

Please mount the first volume of the set on MUA0:
*Are you ready? YES
% MOUNT-I-MOUNTED, IBQ020 mounted on _MUA0

The following product will be processed:

		   IBQ V2.0

Beginning installation of IBQ V2.0 at 18:04

%VMSINSTAL-I-RESTORE, Restoring product saveset A...
* Do you want to run the IVP after the installation [YES]?
* Which software would you like to install (VMS or ELN)?: ELN
* Do you want to purge files replaced by this installation [YES]?

The IBQ01 kit will take about ten minutes to install.

		   IBQ V2.0

	      IBQ Software V2.0

The IBQ01 ELN library IBQ$ELNLIB is now being installed.

The IBQ01 ELN library has been installed.
The Installation Verification Procedures
IBQ$ELNIVP.PAS and IBQ$ELNIVP.COM will now be
placed in SYS$SYSROOT:[SYSTEST.IBQ]

IBQ$LD44E.EXE the ELN download utility is placed in 
SYS$SYSROOT:[SYSEXE]

The 8044 cross-assembler support software will be installed. The 
following files are included in this distribution:

    1.	 IBQ$ASM44.EXE, the 8044 cross-assembler is placed in 
         SYS$SYSTEM.

    2.	 IBQ$FLASH.A44, a sample 8044 program is placed in
    	 [SYSHLP.EXAMPLES.IBQ].

    3.	 IBQ$RMX51I.EXT, an include file for 8044 programs is placed 
         in [SYSHLP.EXAMPLES.IBQ].

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

The installation verification procedure will test that the IBQ01 
VAXELN library has been installed and interacts properly with the 
VAXELN toolkit. This is strictly a host system test, no hardware 
installation is required or tested.

DECscan VAXELN Software successfully installed, V2.0

Installation of IBQ V2.0 completed at 18:06

Enter the products to be processed from the next distribution 
volume set. 
* Products: Exit

VMSINSTAL procedure done at 18:06

$
Example 2

$ SET DEF SYS$UPDATE
$ @vmsinstal

VAX/VMS Software Product Installation Procedure V5.0

It is 18-MAY-1988 at 17:52.
Enter a question mark (?) at any time for help.

%VMSINSTAL-W-DECNET, your DECnet network is up and running.
* Do you want to continue anyway [NO]? yes
* Are you satisfied with the backup of your system disk [YES]?
* Where will the distribution volumes be mounted: MUA0: 

Enter the products to be processed from the first distribution 
volume set.
* Products: IBQ
* Options:
Please mount the first volume of the set on MUA0:
* Are you ready? YES
% MOUNT-I-MOUNTED, IBQ020 MOUNTED ON _MUA0

The following products will be processed:

	 IBQ V2.0

    Beginning installation of IBQ V2.0 at 17:52

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

	 Product:	     DECSCAN-BITBUS
	 Producer:	     DEC
	 Version:	     2.0
	 Release Date:	     30-MAY-1988

* Does this product have an authorization key registered 
  and loaded? YES
* Do you want to run the IVP after the installation [YES]?
* Which software would you like to install (VMS or ELN)?: ELN
* Do you want to purge files replaced by this installation [YES]?

The IBQ01 kit will take about ten minutes to install.

IBQ V2.0

IBQ Software V2.0

The IBQ01 ELN library IBQ$ELNLIB is now being installed.

The IBQ01 ELN Library has been installed.
The Installation Verification Procedures IBQ$ELNIVP.PAS and 
IBQ$ELNIVP.COM will now be placed in SYS$SYSROOT:[SYSTEST.IBQ]

IBQ$LD44E.EXE the ELN download utility is placed in 
SYS$SYSROOT:[SYSEXE]

The 8044 cross-assembler support software will be installed. The 
following files are included in this distribution:

    1.	 IBQ$ASM44.EXE, the 8044 cross-assembler is placed in 
         SYS$SYSTEM.

    2.	 IBQ$FLASH.A44, a sample 8044 program is placed in 
    	 [SYSHLP.EXAMPLES.IBQ].

    3.	 IBQ$RMX51I.EXT, an include file for 8044 programs is 
    	 placed in [SYSHLP.EXAMPLES.IBQ].

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

The installation verification procedure will test that the IBQ01 
VAXELN library has been installed and interacts properly with the 
VAXELN toolkit. This is strictly a host system test, no hardware 
installation is required or tested.

DECscan VAXELN Software successfully installed, V2.0

Installation of IBQ V2.0 completed at 17:56

Enter the products to be processed from the next distribution 
volume set. 
* Products: Exit

VMSINSTAL procedure done at 17:56



APPENDIX C
FILES CREATED DURING INSTALLATION

The files created during the installation of the DECscan VAX/VMS software are:

For IBQ01 VAX/VMS software installation only:

For V5:
SYS$SYSROOT:[SYS$LDR]BQDRIVER.EXE

For V4:
SYS$SYSROOT:[SYSEXE]BQDRIVER.EXE

For both V5 and V4:
SYS$SYSROOT:[SYSEXE]IBQ$BCS.EXE
SYS$SYSROOT:[SYSMGR]IBQ$STRUP.COM
SYS$SYSROOT:[SYSTEST.IBQ]IBQ$IVP.EXE
SYS$SYSROOT:[SYSHLP.EXAMPLES.IBQ]IBQ$FUNC.BAS
SYS$SYSROOT:[SYSHLP.EXAMPLES.IBQ]IBQ$FUNC.FOR
SYS$SYSROOT:[SYSHLP.EXAMPLES.IBQ]IBQ$FUNC.H
SYS$SYSROOT:[SYSHLP.EXAMPLES.IBQ]IBQ$DEF.MAR
SYS$SYSROOT:[SYSHLP.EXAMPLES,IBQ]IBQ$FUNC.MAR
SYS$SYSROOT:[SYSHLP.EXAMPLES.IBQ]IBQ$FUNC.PAS
SYS$SYSROOT:[SYSHLP.EXAMPLES.IBQ]IBQ$FUNC.PEN
SYS$SYSROOT:[SYSEXE]IBQ$LD44V.EXE

For the DECscan VAXELN installation only:

ELN$:IBQ$ELNLIB.OLB
SYS$SYSROOT:[SYSTEST.IBQ]IBQ$ELNIVP.PAS
SYS$SYSROOT:[SYSTEST.IBQ]IBQ$ELNIVP.COM
SYS$SYSROOT:[SYSEXE]IBQ$LD44E.EXE

Common to both installations:

SYS$SYSROOT:[SYSEXE]IBQ$ASM44.EXE
SYS$SYSROOT:[SYSHLP.EXAMPLES.IBQ]IBQ$FLASH.A44
SYS$SYSROOT:[SYSHLP.EXAMPLES.IBQ]IBQ$RMX51I.EXT
SYS$SYSROOT:[SYSHLP]IBQ020.RELEASE_NOTES

