# Compaq ACMS for OpenVMS
Getting Started

Previous | Contents | Index

## 15.3.1 Authorizing ACMS Users

Authorized OpenVMS users cannot sign in to ACMS until the system manager has also authorized them as ACMS users. The User Definition Utility (UDU) provides the capability to do this. Using the UDU, the system manager creates an ACMS database named ACMSUDF.DAT, located in the SYS$SYSTEM directory. When adding a user to the database, the system manager also specifies the default menu the user sees upon signing in to ACMS.

To add a new user to the ACMS database, perform the following steps:

1. Define UDU as a global symbol in your login command file. Then initialize the symbol by executing your login command file:

       $ UDU :== $ACMSUDU
       $ @LOGIN.COM
       $

2. Set the default directory to SYS$SYSTEM:

       $ SET DEFAULT SYS$SYSTEM
       $

3. Invoke UDU:

       $ UDU
       UDU>

4. Add an OpenVMS user name to the ACMS database by entering the ADD command:

       UDU> ADD uname /MDB=AVERTZ_DEFAULT:VR_MENU
       UDU>

   Include the MDB qualifier to specify the default menu displayed to this user when entering ACMS.
5. Enter the SHOW command to verify this entry in the ACMSUDF.DAT database:

       UDU> SHOW uname
       User name:       UNAME               DISPLAY MENU
       Default menu:
       Default MDB:     AVERTZ_DEFAULT:VR_MENU
       .
       .
       .
       UDU>

   An entry under uname indicates that the uname is authorized to sign in to ACMS. The default characteristic DISPLAY MENU causes ACMS to display the top menu in uname's VR_MENU database.
6. Enter the SHOW SYSTEM command to determine if user name SYSTEM has been added to the ACMS database (it may not, if this is the first ACMS access). If you receive a "user does not exist" message, then add SYSTEM as follows:

       UDU> ADD SYSTEM /AGENT
       UDU>

   Although ACMS assigns the user name SYSTEM to the Command Process (CP) when you install ACMS, it does not automatically authorize the Command Process as an agent. Without this authorization, ACMS cannot sign in any users. The /AGENT qualifier enables an agent to submit a task that has a user name different from the user name of the agent process.
7. Exit from UDU.

## 15.3.2 Authorizing ACMS Terminals

Authorized ACMS users must sign in from terminals that have been authorized for access to ACMS. With the Device Definition Utility (DDU), the system manager creates a database named ACMSDDF.DAT that contains a list of authorized ACMS devices. In the simplest case, the system manager can use one DDU definition to authorize all terminals on your system, both local and remote, to use ACMS.

To use DDU to authorize terminals for users, follow these steps:

1. Define DDU as a global symbol in your login command file. Then initialize the symbol by executing your login command file:

       $ DDU :== $ACMSDDU
       $ @LOGIN.COM
       $

2. Set the default directory to SYS$SYSTEM:

       $ SET DEFAULT SYS$SYSTEM
       $

3. Invoke DDU:

       $ DDU
       DDU>

4. Use the ADD command to authorize a LAT terminal on your system for ACMS use. The device name LT authorizes all LAT terminals.

       DDU> ADD LT
       DDU>

   If the ADD LT command has been performed before, you receive the message, "device name already exists in the data base." In this case, you can exit from DDU and proceed to the next section.
5. Use the SHOW command to display information about the LT entry:

       DDU> SHOW LT
       Device name:     LT                   NOT CONTROLLED
       No Autologin
       Printfile
       DDU>

   When the system manager creates a new ACMSDDF.DAT database, DDU creates a DEFAULT definition that assigns all terminals the NOT CONTROLLED characteristic. From a CONTROLLED terminal, the user signs in directly to ACMS; from a NOT CONTROLLED terminal, the user first logs in to the OpenVMS operating system and then signs in to ACMS from DCL command level.
6. Exit from DDU.

# 15.4 Starting and Stopping ACMS and AVERTZ

Both the ACMS system and the AVERTZ application must be started before users can sign in. You can also stop your ACMS system or AVERTZ application at any time. The next two sections describe how to:

- Start ACMS and AVERTZ
- Stop ACMS and AVERTZ

## 15.4.1 Starting ACMS and the AVERTZ Application

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 the AVERTZ application, perform the following steps:

1. Issue the SHOW SYSTEM command to determine if another user has already started ACMS:

       $ ACMS/SHOW SYSTEM

   If the subsequent display states that "current system state" is STOPPED, proceed to the next step and start the ACMS system. However, if the display states that the current system state is STARTED, proceed to step 3.
2. Issue the START SYSTEM command to start the ACMS system:

       $ ACMS/START SYSTEM

   If the ACMS system starts successfully, the $ prompt returns with no intervening error messages.
3. Before you can invoke a command that runs the application, you need to start the application. Issue the START APPLICATION command with the name of the AVERTZ application:

       $ ACMS/START APPLICATION VR_APPL

   If the ACMS system starts successfully, the $ prompt returns with no intervening error messages. However, if your system logical AVERTZ_DEFAULT is not defined on this system, you receive an error message that states, in part, "Error opening TDB file AVERTZ_DEFAULT:[SYSHLP.EXAMPLES.ACMS]..." See Section 15.2.2 for information about defining your system logical.
   If you receive an "invalid login attempt" message, your system manager may not have authorized the ACMS Command Process (CP) to run as an agent (described in Section 15.3.1). Without this authorization, ACMS cannot sign in any users.

## 15.4.2 Stopping the AVERTZ Application and ACMS

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 VR_APPL
    $ ACMS/STOP SYSTEM
    $

ACMS waits until all active tasks have finished executing before it stops the application and the system.

# Chapter 16
User's View

To understand how the AVERTZ application looks to the user, imagine the conversation between a reservation clerk working for AVERTZ operations in New England and a customer who needs a rental car.

# 16.1 Entering AVERTZ

After his morning cup of coffee, Sparky Hartshorn, a reservation clerk at AVERTZ, enters the AVERTZ application from his OpenVMS account:

$ ACMS/ENTER VR_APPL`[Return]`

AVERTZ displays the AVERTZ Rental Menu shown in Figure 16-1.

Figure 16-1 AVERTZ Rental Menu

To select an option, the clerk types the option number and presses `[Return]`. For example, to reserve a car, the clerk types:

Selection:1`[Return]`

If the clerk needs online help while using AVERTZ, he can display help for any field by pressing `[Help]` when the cursor is on that field.

The next three sections describe a sample dialog between a customer and the clerk at AVERTZ for the following transactions:

- Reserving a car
- Checking out a car (beginning the rental)
- Checking in a car (ending the rental)

# 16.2 Customer Reserves a Car

Bertram Simpson needs a car. The following telephone conversation between Bertram and the AVERTZ clerk, on April 19, shows how the reservation option is used in a real business situation. Integrated with the conversation are the steps the clerk must take to enter the car reservation in AVERTZ:

Clerk: | "Hello, AVERTZ Car Rental ... can I help you?"
Customer: | "Oh, hi. My name is Bertram Simpson and I need to rent a car for this weekend."
Clerk: | "OK, Mr. Simpson. Let me just ask you a few questions." The clerk enters the following at the AVERTZ Rental Menu: Selection: 1 `[Return]` AVERTZ displays the reservation panel shown in Figure 16-2.

Figure 16-2 Reservation Panel

Figure 16-3 Site Selection Panel

Figure 16-4 New Customer Panel

Figure 16-5 Reservation Completed Panel

Clerk: | "Have you rented a vehicle with us before?" The clerk asks this question because, if Mr. Simpson is an existing customer, the clerk can enter his customer ID number instead of his name.
Customer: | "No, I haven't."
Clerk: | "OK, can you give me your full last name, first name, and middle initial, please?"
Customer: | "Sure. Simpson, Bertram H."
Clerk: | To move to the name field and enter the customer's name, the clerk enters the following: `[Tab]`Simpson `[Tab]`Bertram `[Tab]`H `[Tab]` "OK, Mr. Simpson. And from what AVERTZ location would you like to pick up your vehicle?"
Customer: | "I'm not sure. I'll be meeting a friend in Manchester, New Hampshire. Where is the closest AVERTZ location to Manchester?"
Clerk: | "Let me get a list of the sites." The clerk enters the following to display a list of sites: `[PF1]` `[ S ]` AVERTZ displays the site selection panel shown in Figure 16-3.
Clerk: | "Sir, we have three sites in New Hampshire: one at the Manchester Airport, one at the Nashua Depot, and one in Concord. Is the Manchester Airport location OK with you?"
Customer: | "Great, that's perfect!"
Clerk: | The clerk enters the following: `[Select]` Because the site selected is the first site on the list, the clerk does not need to move the cursor. If, however, the clerk did need to move the cursor, he could press the up-arrow key or the down-arrow key to select different sites. "OK. What day would you like to start your rental?"
Customer: | "I need the car for the weekend, beginning later today."
Clerk: | "OK, you want to pick up the car today, and return it on April 22. Correct?"
Customer: | "Right."
Clerk: | The clerk enters the following: 19-APR-1991 `[Tab]`22-APR-1991 `[Tab]` "And would you like a compact, mid-size, or full-size car, Mr. Simpson?" The clerk enters the following to display the car type codes: `[Help]` AVERTZ displays a message listing the car types available. The following table lists the valid car type codes for this field:
Code | Car Type
--- | ---
1 | Compact
2 | Mid-Size
3 | Full-Size
Customer: | "There will just be two people using the vehicle, so compact should be fine."
Clerk: | The clerk enters the following: 1 `[Return]` Because Mr. Simpson is a new customer, AVERTZ displays the new customer panel shown in Figure 16-4.
Clerk: | If Mr. Simpson were an existing customer, the new customer panel would display information for each field, based on the data in Mr. Simpson's database record.
| "OK, Mr. Simpson. Because you are a new customer, we would like to collect a few more pieces of information about where you live and how you will pay for the vehicle. First, what is your address?"
Customer: | "901 Maple Drive, Apartment 12, Nashua, New Hampshire."
Clerk: | Based on the address the customer provided, the clerk completes the panel up to the Postal Code field by entering the following:
`[Tab]` `[Tab]` `[Tab]`901 Maple Drive `[Tab]`Apt. 12 `[Tab]`Nashua `[Tab]`NH `[Tab]`USA `[Tab]`
| "And what is your zip code, sir?"
Customer: | "03060."
Clerk: | The clerk enters the following: 03060 `[Tab]` "And your phone number?"
Customer: | "603-555-9966."
Clerk: | The clerk enters the following: 603-555-9966 `[Tab]` "Will you be paying with cash or charge?" The clerk enters the following to display the credit type codes: `[Help]` AVERTZ displays a message listing the credit types available. The following table lists the valid credit type codes for this field:
Code | Credit Type
--- | ---
0 | Cash
1 | Globetrotter
2 | Viceroy
3 | PlasticMoney
4 | Gourmet Gold
Customer: | "Cash."
Clerk: | Because 0 is the code for cash, the clerk enters the following: 0 `[Tab]` "Your driver's license number, please?"
Customer: | "555-33-0000."
Clerk: | The clerk enters the following: 555-33-0000 `[Tab]` "And that license is for the state of New Hampshire?"
Customer: | "Actually, no. I just moved to New Hampshire a short while ago. It is a Massachusetts license."
Clerk: | The clerk enters the following: MA `[Tab]`USA `[Return]` AVERTZ processes the reservation. Since the reservation is being made on the same day as the requested checkout, AVERTZ prompts to see if the clerk wants to check out the car now (see Figure 16-5) .
Clerk: | "Mr. Simpson, your reservation for a compact car rental from April 19, 1991, to April 22, 1991, is confirmed, with a reservation confirmation number of 2. Please stop by our Manchester office later today to check out the car. Thank you for calling AVERTZ! Bye ..." Because Mr. Simpson phoned in his reservation, the clerk knows that he is not ready to check out the car. The clerk enters the following: `[Tab]` `[Select]` AVERTZ returns to the AVERTZ Rental Menu.

# 16.3 Customer Checks Out a Car (Beginning the Rental)

Bertram Simpson now has a reservation for a compact vehicle rental from April 19, 1991, until April 22, 1991. He shows up at the reservations counter at AVERTZ later in the day on April 19, after having made his reservation earlier that day. The following dialog takes place while Bertram Simpson checks out the car to begin the rental period:

Figure 16-6 Checkout Panel

Figure 16-7 Checkout Update Panel

Figure 16-8 Car Selection Panel

Figure 16-9 Checkout Completion Panel

Clerk: | "Hi, can I help you?"
Customer: | "Yes, my name is Bertram Simpson and I have a reservation for a compact car for today."
Clerk: | "OK, Mr. Simpson, let me call up your reservation." The clerk enters the following at the AVERTZ Rental Menu (Figure 16-1 shows the AVERTZ Rental Menu): Selection: 2 `[Return]` AVERTZ displays the checkout panel shown in Figure 16-6.
Clerk: | "OK, Mr. Simpson, could I have your reservation number?"
Customer: | "Sure, I have reservation number 2."
Clerk: | "Thank you." The clerk enters the following: 2 `[Return]` AVERTZ displays the checkout update panel shown in Figure 16-7, with the cursor positioned at the Credit Type field.
Clerk: | "Are you still planning on paying with cash, Mr. Simpson?"
Customer: | "Yes, I am."
Clerk: | "Great." The clerk enters the following: `[Return]` AVERTZ displays a list of available vehicles, as shown in Figure 16-8.
Clerk: | "Do you have any options that you want with your vehicle?" The clerk uses the following table to determine what each option code means:
Code | Option
--- | ---
00 | Standard transmission
01 | Cruise control
02 | Tape deck
03 | Sunroof
04 | 4-wheel drive
05 | Roof rack
06 | Bulletproof glass and body
Customer: | "Well, I have a bit of a drive into the mountains, so if you have a car with a tape deck, that would be great."
Clerk: | The clerk presses the down-arrow key and the Select key to select the first available vehicle with option 2. AVERTZ now displays the checkout completion panel, as shown in Figure 16-9.
Clerk: | The clerk enters the following to complete the checkout: `[Do]` AVERTZ displays a message indicating that the checkout is completed, and then prompts the clerk to press `[Return]` to continue. "OK, Mr. Simpson, you're all set. Here are the keys to a Chevrolet, NH license plate 899BHV. The vehicle does have a tape deck, and is located in the parking area just to the left of our front door. When you return the car, please record the odometer reading before you check the car back in. Do you have any questions?"
Customer: | "No, that's great. Thank you very much."
Clerk: | "You're welcome. Have a good weekend and see you on Monday." The clerk enters the following to return to the AVERTZ Rental Menu: `[Return]` AVERTZ returns to the AVERTZ Rental Menu.

Previous | Next | Contents | Index