Previous | Contents | Index |
ACMS requires that the application database (.ADB) file reside in the directory associated with the logical name ACMS$DIRECTORY. Because this directory can be protected from unauthorized use, all application databases in ACMS$DIRECTORY remain secure.
Your application, EMPLOYEE_INFO_APPL_xxx.ADB, is currently located in your default OpenVMS directory. However, ACMS cannot find it there. You must install your application in ACMS$DIRECTORY after your system manager uses the Application Authorization Utility (AAU) to authorize both you and your application.
To use AAU to authorize tutorial users to install their applications in ACMS$DIRECTORY, follow these steps:
$ AAU :== $ACMSAAU |
$ @LOGIN.COM |
$ SET DEFAULT SYS$SYSTEM $ |
$ AAU AAU> |
AAU> ADD EMPLOYEE_INFO_APPL_xxx /ACL=(ID=[uname],ACCESS=CONTROL) %ACMSAAU-S-APPLADD, Appl name EMPLOYEE_INFO_APPL_XXX has been added to the database AAU> |
AAU> SHOW EMPLOYEE_INFO_APPL_xxx |
======================================================================= Appl name: EMPLOYEE_INFO_APPL_XXX Appl Username: * Server Usernames: * Access Control List: (IDENTIFIER=[ACMS,UNAME],ACCESS=CONTROL) ======================================================================= AAU> |
Other AAU commands let the system manager specify more characteristics
of individual applications, authorize all applications with the $ALL
keyword, remove authorizations, and change authorization names. See
Compaq ACMS for OpenVMS Managing Applications for more information about AAU.
12.6 Defining the ACMS$DIRECTORY Logical
The system manager needs to verify that the ACMS$DIRECTORY logical is associated with the device and directory where ACMS applications are to be stored. In the case of a new ACMS installation, the system manager may not yet have set up a protected directory for storing ACMS applications. If not, the system manager must first set up such a directory before defining the logical that points to it. Defining the ACMS$DIRECTORY logical must be done before the tutorial user can install the tutorial application.
If other ACMS applications are already on the tutorial user's system, the ACMS$DIRECTORY logical has been defined already. To verify the logical and define it, perform the following steps:
$ SHOW LOGICAL ACMS$DIRECTORY |
$ SET DEFAULT SYS$MANAGER $ @ACMS_POST_INSTALL.COM |
With the successful completion of this step, the tutorial user can proceed to install the application and run it.
This chapter describes how to install and run your tutorial
application. Before running the application, you perform steps to start
the ACMS system (if not running) and to start your specific
application. After running your application, you perform steps to stop
your application and stop the ACMS system (if no one else is using it).
13.1 Installing the Application
When you install an application, ACMS checks the ACMSAAF.DAT database to determine whether you are authorized to install that application. If so, ACMS copies the database to ACMS$DIRECTORY, deletes any earlier versions, and changes the user identification code (UIC) of the .ADB file to [1,4].
If you are not authorized to install the application, ACMS returns an error message indicating that you are not authorized. (Your system manager must have authorized you and your application with the AAU, as explained in Section 12.5.)
You install your application database file in ACMS$DIRECTORY by executing the ACMS/INSTALL command at DCL command level.
To install your application in ACMS$DIRECTORY, follow these steps:
$ SHOW LOGICAL ACMS$DIRECTORY |
$ SET DEFAULT udisk:[uname] |
$ ACMS/INSTALL EMPLOYEE_INFO_APPL_xxx |
%ACMSINS-S-ADBINS, Application UDISK:[UNAME]EMPLOYEE_INFO_APPL_XXX has been installed to ACMS$DIRECTORY $ |
Once all authorizations and installations are complete, you can start the ACMS system and start your application. To start and stop the ACMS system automatically with the OpenVMS system, you can include the ACMS/START and ACMS/STOP operator commands in your system startup and shutdown command files. However, in this tutorial, you start and stop ACMS interactively.
Any account from which the ACMS/START and ACMS/STOP commands are issued must have OpenVMS OPER privilege to execute these commands.
To start the ACMS system (if it is currently stopped), and to start your tutorial application, perform the following steps:
$ ACMS/SHOW SYSTEM |
$ ACMS/START SYSTEM |
$ ACMS/START APPLICATION EMPLOYEE_INFO_APPL_xxx |
The audit trail log (ATL) keeps a record of when the ACMS system starts
and stops, when users sign in, when applications and tasks start and
stop, and what errors occur. To display this log, you can run the Audit
Trail Report Utility (ATR) (see Section A.2).
13.3 Running the Application
If your system manager has authorized you to use ACMS, and has authorized your terminal, you can run your tutorial application by issuing the ACMS/ENTER command. When you enter this command, ACMS checks the authorization files to determine whether you and your terminal are authorized.
If you pass the authorization check, ACMS displays your default menu and waits for you to select a task. When you do, ACMS finds that task in the .TDB file and runs the task.
To run your tutorial application, perform the following steps:
$ ACMS/ENTER |
Figure 13-1 Selection Menu
You have now run your application and seen the results of choosing either the data entry task or the inquiry/update task. It is often helpful, especially in problem-solving, to know the various steps that ACMS takes to run one of these tasks. This information is available in Appendix A.
Appendix A also describes how to access various utilities that can help you solve problems that may occur when you run an ACMS application. These utilities include:
You can stop your application and the ACMS system with the ACMS/STOP command. Before you stop the system, however, issue the SHOW SYSTEM command to see if another person is using the ACMS system:
$ ACMS/SHOW SYSTEM |
The system displays the names of any active applications and any active users. If no other applications or users are active, issue both ACMS/STOP commands. Otherwise, issue only the STOP APPLICATION command, specifying the name of your application:
$ ACMS/STOP APPLICATION EMPLOYEE_INFO_APPL_xxx $ ACMS/STOP SYSTEM $ |
ACMS waits until all active tasks have finished executing before it stops the application and the system.
Other ACMS operator commands allow you to display information about your ACMS system and perform application management functions. Compaq ACMS for OpenVMS Managing Applications contains a detailed discussion of ACMS operator commands.
The AVERTZ car company is a fictional car rental company created to illustrate how transaction processing (TP) can solve a business problem. With AVERTZ, the business problem is how data entry personnel can quickly and efficiently create, access, and update car rental information.
As you walk through Part 3 and through the AVERTZ application, you can see different perspectives of a single TP system. This document contains the following three chapters, and is organized so that you can get AVERTZ up and running quickly:
Since the AVERTZ application is already designed and developed, the first step you should take is to set up the application so that you can try it out. This chapter helps you build, install, and set up AVERTZ.
You cannot build the AVERTZ application under multiversion Rdb. |
Before you follow the instructions in this chapter, check to make sure that the ACMS$DIRECTORY logical name is defined. Check this by typing the following command at your DCL prompt:
$ SHOW LOGICAL ACMS$DIRECTORY |
If the logical name is defined, you can proceed with the instructions in this chapter. If the logical name is not defined, you receive the following error message:
%SHOW-S-NOTRAN, no translation for logical name ACMS$DIRECTORY |
If you receive this error message, then before proceeding with the instructions in this document, you must follow the postinstallation instructions in Compaq ACMS Version 4.3 for OpenVMS Installation Guide.
Before you try to run the AVERTZ application, you must create a
transaction log for DECdtm services. See Compaq ACMS Version 4.3 for OpenVMS Installation Guide for a
description of how to do this.
15.1 Building the AVERTZ Application and Databases
The AVERTZ environment consists of the following directories:
Before you can run the AVERTZ application, you must build the databases and application. To build the databases and application, log in to an OpenVMS account that has SYSPRV privileges, and enter the following command:
$ SET PROCESS/PRIVILEGE=SYSPRV |
If SYSPRV is not enabled for the account you use, ask your system manager to enable that privilege using the OpenVMS Authorize Utility.
Once your account has SYSPRV enabled, enter the following command to use the directory that contains the AVERTZ sources:
$ SET DEFAULT ACMS$EXAMPLES |
To build the AVERTZ application, use the AVERTZ_BLD.COM command procedure, which is in the ACMS$EXAMPLES directory. The AVERTZ_BLD.COM procedure:
The AVERTZ_BLD.COM procedure requires additional files for successful execution. These files ship with the AVERTZ application, and are located in the ACMS$EXAMPLES directory:
When you run AVERTZ_BLD.COM, you are prompted to enter a directory location for the source code, the data dictionary, the databases, and the images.
The following example shows a sample walkthrough of AVERTZ_BLD.COM. You can follow the instructions by entering the commands and responses that are printed in red.
$ @AVERTZ_BLD.COM |
Enter name of the source directory for AVERTZ - e.g. disk1:[x.y]: |
SYS$COMMON:[SYSHLP.EXAMPLES.ACMS] |
Enter name of the directory for AVERTZ CDD dictionary - e.g. disk1:[x.y]: |
SYS$COMMON:[SYSHLP.EXAMPLES.ACMS.DICTIONARY] |
Enter name of the database directory for AVERTZ - e.g. disk1:[x.y]: |
SYS$COMMON:[SYSHLP.EXAMPLES.ACMS.DATABASE] |
Place object and image files in the source directory? [Y]/N: |
Y |
Are these directory names correct? - Y/[N]: |
Y |
Have the CDD dictionary and its sub-directories been created?: |
N |
Define fields and records in CDD? - Y/[N]: |
Y |
Build message file? - Y/[N]: |
Y |
Compile tasks? - Y/[N]: |
Y |
Build task group? - Y/[N]: |
Y |
Build menu? - Y/[N]: |
Y |
Build application? - Y/[N]: |
Y |
Build form? - Y/[N]: |
Y |
Compile server procedures? - Y/[N]: |
Y |
Previous | Next | Contents | Index |