AUTOMATED INFORMATION COLLECTION SYSTEM AICS INSTALLATION GUIDE Version 3.0 ...

52 Pages·2004·1.08 MB·English

AUTOMATED INFORMATION
COLLECTION SYSTEM

AICS

INSTALLATION GUIDE

Version 3.0

April 1997

Department of Veterans Affairs
Health Systems Design & Development (HSD&D)

Table of Contents

I. Introduction ........................................................................................................... 1
Package Integration ............................................................................................ 1

II. Client ...................................................................................................................... 3
Pre-Install Steps ................................................................................................. 3
Installation Activity ............................................................................................ 3

III. Server ..................................................................................................................... 5
Pre-Install Steps ................................................................................................. 5
Installation Activity ............................................................................................ 5

IV. Appendix A - Files Installed on Client Workstation and Sample Installation ... 9

V. Appendix B - Sample Server Installation ........................................................... 23

VI. Appendix C - Checksum Values .......................................................................... 35

VII. Appendix D - Scanner Calibration ...................................................................... 39

April 1997 AICS V. 3.0 Installation Guide i

I. Introduction

This package was created using Kernel V. 8.0 and VA FileMan V. 21.0. It was
exported using the Kernel Installation and Distribution System (KIDS) instead of
the FileMan DIFROM utility. You must use Kernel V. 8.0 to install this software.
Installation (not including the placement of globals) will take between 2 and 15
minutes.

Please review the KIDS documentation and familiarize yourself with KIDS prior to
installing this package.

Package Integration

The following package versions (or higher) must be installed prior to loading
the AICS software. AICS's environment check routine checks for certain critical
patches to each of these packages. Sites should verify that all patches to these
packages have been installed prior to the install of AICS.

Kernel V. 8.0
VA FileMan V. 21.0
RPC Broker V. 1.0
PCE V. 1.0
PIMS V. 5.3
Kernel Toolkit V. 7.3
Clinical Lexicon Utility V. 1.0 or Lexicon Utility V. 2.0
Problem List V. 2.0 (including patch GMP*2*3)
Visit Tracking V. 2.0

During the Post Installation routine, AICS will determine the version of the
Lexicon Utility you are running and will update the data dictionary for fields
that point to the EXPRESSIONS file (#757.01) to the correct global location.

A list of the checksum values is located in Appendix C.

April 1997 AICS V. 3.0 Installation Guide 1
II. Client

Pre-Install Steps

You must have a client workstation that has the RPC Broker’s Client Manager
running. You must be able to run the RPC Broker Test provided by the RPC
Broker in order to run AICS. The client software needs to be installed on a
workstation to do the scanning functionality for AICS. Workstations should
conform to the “Veterans Health Administration Recommendations to the Field -
August 3, 1995” document. This document may be found on the VHA Home
Page - or directly via www.va.gov/wsnosrec.htm. The workstations must meet
the following requirements.

1. At a minimum, be a 80486 CPU-based PC workstation with 20 megabytes of
RAM. A Pentium 100 with 32 megabytes is the recommended minimum.

2. Have one of the following operating systems:
• MS Windows for Workgroups V. 3.11,
• MS Windows 95.

3. Have Network Capability:
• Each workstation should be networked into your VISTA Server through a
local area network, using a network interface card and TCP/IP protocol;
OR, under Windows 95, a Point-to-Point Protocol (PPP) into a Windows
NT Server.
• Successfully run the RPC Broker’s RPC Broker Test on each client
workstation. (See Section III - Server, Installation Activity.)

Installation Activity

Before you install AICS on a client workstation, you should have successfully
run the RPC Broker Test program and executed each of its functions. You
should also make sure that Paper Keyboard has been loaded. Do not proceed
until this has been accomplished.

The following steps must be taken for each workstation that will be used as an
AICS workstation.
April 1997 AICS V. 3.0 Installation Guide 2
Client
1. Get AICS3_0.EXE.
This can be obtained from the appropriate anonymous software directory.
• Make sure to set transfer as BINARY.
• Get the AICS3_0.EXE file. Depending on the FTP software, this file
should be placed in a shared directory. If you cannot find it, use Window's
File Manager's Search functionality.

2. Find the AICS3_0.EXE file. It is not necessary to copy the file; the file can be
run from the shared directory.

3. Run AICS3_0.EXE (double click on it). This starts the AICS installation. See
Appendix A for information on the files installed on the Client Workstation and
a sample run of the installation.
• Example: Run c:\xxx\AICS3_0.EXE from Program Manager.
• Take all the default prompts unless it causes a conflict.
• The install program creates an AICS directory, three subdirectories
(unrforms, images, backup), and a new Windows Program Group. It
populates the Program Group with the AICS Scanning Work Center Icon,
the AICS Scanning Work Center Help Icon, and the AICS Scanning Work
Center Uninstall Icon.

***Load Server software before continuing***

4. Run the AICS Client software.
• Double click on the AICS Scanning Work Center Icon.
• Logon either by clicking the logon speed button or by selecting Logon from
the File Menu. Make entries for both access and verify codes. Note that
moving the cursor over any button will display additional information on
that button.
• Should an error dialog box appear with an ABORT or IGNORE button,
clicking the ABORT will shut down the application; the IGNORE button
will clear the exception and attempt to continue. If you IGNORE, you
may see additional errors depending on the severity of the initial error.
• You have connected to the server database when you hear a bell and see
the message displaying which server you are connected to at the bottom of
the screen.
• Use the client software. Note that not all menu items are available and
not all data fields have connections with the database.

5. Calibrate your scanner. Appendix D lists the steps to take in order to
calibrate your scanner. This step must be done before scanning forms.
April 1997 AICS V. 3.0 Installation Guide 3

III. Server

Pre-Install Steps

You must have all current Kernel, Kernel Toolkit, VA FileMan, PCE, PIMS,
Problem List, Visit Tracking, and RPC Broker patches installed.

Kernel V. 8.0
The following patches are checked for by the environment check routine.

XU*8*2
XU*8*15
XU*8*16
XU*8*28
XU*8*32
XU*8*44

Installation Activity

1. Install RPC Broker V. 1.0 using the RPC Broker Installation instructions.

Loading and Installing the KIDS Distribution should be accomplished during
non-peak hours to minimize disruption to users. Installation of the KIDS
Distribution will take less than 30 minutes.

a. Review your mapped set. If you map routines, you should disable routine
mapping on the IBD* routines.

b. If you wish, you may disable journalling for IBE and IBD globals, as
appropriate.

c. From the Kernel Installation and Distribution System Menu, select the
Installation menu.

d. From this menu, select the Load a Distribution option. Enter
“AICS3_0.KID” at the “Enter a Host File:” prompt. Enter YES at the “Want to
Continue with Load? YES//” and “Want to RUN the Environment Check
Routine? YES//” prompts.

e. From the Installation menu, you may elect to use the following options
(when prompted for INSTALL NAME, enter AICS3_0.KID.).
April 1997 AICS V. 3.0 Installation Guide 5
Server
• Backup a Transport Global - this option will create a backup message
of any routines exported with the patch. It will NOT backup any other
changes such as DDs or templates.
• Compare Transport Global to Current System - this option will allow
you to view all changes that will be made upon installation. It compares
all components of the package (routines, DDs, templates, etc.).
• Verify Checksums in Transport Global - this option will allow you to
ensure the integrity of the routines that are in the transport global.

f. Use the Install Package(s) option and select the package, AICS3_0.KID.

g. Respond to the prompts as follows:

•
Want to DISABLE Scheduled Options, Menu Options, and Protocols?
YES// YES
•
Disable IBD*

h. MSM sites: Please ensure you answer YES when asked if you want to move
the routines to other systems, and indicate the appropriate CPUs.

i. If routines were unmapped as part of Step 1a, they should be returned to the
mapped set once the installation has run to completion.

2. Assign Security Keys.

• IBDF IRM should be assigned to those who access the IRM menu option.
• IBD SCAN MANAGER should be assigned to the users who will be using the
scanning software.
• IBD MANAGER should be assigned to the user who needs to perform
functions in AICS that should not be allocated to all users of the package.

3. The IBD SCANNING WORKSTATION option must be given as a secondary
menu to users who will be using the scanning software.

4. OPTIONAL: Print out a copy of the AICS builds.
• Select the Kernel Installation & Distribution System menu.
• Select the Utilities menu.
• Select Install File Print.
• Print Automated Info Collection Sys 3.0.
6 AICS V. 3.0 Installation Guide April 1997