Compaq ACMS Version 4.3 for OpenVMS
Installation Guide


Previous Contents Index

4.4 Modifying ACMS Parameters

After installing ACMS, run the ACMSPARAM.COM and ACMEXCPAR.COM command procedures to determine ACMS quotas, parameters, and privileges. There is no need to run ACMEXCPAR.COM after a new installation until applications have been installed.

Note

Compaq strongly recommends that you use ACMSPARAM.COM and ACMEXCPAR.COM. Otherwise, you might not be able to start ACMS.

These command procedures perform the following tasks:

ACMSPARAM.COM and ACMEXCPAR.COM do not support logical name search lists for the TDB file specifications.

Refer to Compaq ACMS for OpenVMS Managing Applications for information on how to use the ACMSPARAM and ACMEXCPAR command procedures.

Certain conditions require attention to adjust ACMS parameter values:

4.5 Authorizing Applications, Devices, Users, and Processes

ACMS provides utilities to specify which applications, terminals, users, and agent programs can access the ACMS system. The following sections describe these utilities.

4.5.1 Authorizing New Applications

Run the ACMS Application Authorization Utility (AAU) to authorize any new ACMS applications that you plan to install. AAU allows you to authorize applications, specify application user name restrictions, and define who can install those applications. You must restart ACMS after installing any new applications.

Users who have been authorized by AAU can use the ACMS/INSTALL operator command to install applications in ACMS$DIRECTORY. By default, no users are authorized to use the ACMS/INSTALL operator command.

Use of AAU is optional; however, it can simplify and ease the application management process during the development and maintenance of applications.

For information on using AAU, see Compaq ACMS for OpenVMS Managing Applications.

4.5.2 Authorizing New Terminals

If you have new terminals to authorize or modify, run the Device Definition Utility (DDU) to authorize either all terminals (with $ALL) or individual terminals (by device name) for access to ACMS:


$ SET DEFAULT SYS$SYSTEM
$ RUN ACMSDDU
DDU> ADD $ALL
DDU> EXIT

For information on using DDU, see Compaq ACMS for OpenVMS Managing Applications.

Note

Users on your system cannot sign in to ACMS until you authorize $ALL or specific terminals.

4.5.3 Authorizing New Users

If you have new users to authorize, run the ACMS User Definition Utility (UDU) to authorize ACMS users. You can either authorize all users (with $ALL) or individual users (by name):


$ SET DEFAULT SYS$SYSTEM
$ RUN ACMSUDU
UDU> ADD $ALL
UDU> EXIT

For information on using UDU, see Compaq ACMS for OpenVMS Managing Applications.

Note

Users on your system cannot sign in to ACMS until you authorize $ALL or specific user names.

4.5.4 Authorizing ACMS Processes

You must authorize the user name of any task-submitting agent program that submits a task for processing with a user name other than the user name of that agent. Use the /AGENT qualifier with the UDU ADD command to authorize this type of agent. For example, use the following command to authorize an agent with the user name SYSTEM:


$ RUN ACMSUDU
UDU> ADD SYSTEM /AGENT
User SYSTEM  has been added to the database

Both the ACMS Command Process (CP) and the Queued Task Initiator (QTI) must be authorized as agents. By default, ACMS assigns the user name SYSTEM to the CP and QTI. If you change the user name of the CP or QTI with ACMSGEN, you must run the UDU again, using the RENAME command to change the user name in the UDU authorization file.

For information on UDU, see Compaq ACMS for OpenVMS Managing Applications.

Note

The ACMSPARAM.COM procedure automatically authorizes the user names of the CP and QTI as agents (using the /AGENT qualifier) in the ACMS user authorization file ACMSUDF.DAT. The ACMSPARAM command procedure takes either the user name you supply or supplies a default user name. The default user name supplied for the CP is ACMS$CP. The default user name supplied for the QTI is ACMS$QTI.

4.6 Creating and Modifying ACMS User Accounts

Each person who uses ACMS on your system must be an authorized OpenVMS user, with certain privileges and quotas. The following sections describe these requirements. (See Compaq ACMS for OpenVMS Managing Applications for quotas required for users running the ACMS Task Debugger.)

4.6.1 Privileges

To use ACMS, each user account must have at least TMPMBX and NETMBX privileges. Those persons who are responsible for starting the ACMS system, starting applications, and using other ACMS operator commands must have OpenVMS OPER privilege. Use the OpenVMS Authorize Utility to determine whether users have the privileges they require.

4.6.2 Quotas

Make sure that the appropriate user accounts have sufficient quotas to be able to use ACMS. Table 4-4 summarizes the required user account quotas.

Table 4-4 User Account Quotas
Account Quota Value (=>)
ASTLM 24
BIOLM 18
BYTLM 10,240
DIOLM 22
ENQLM 100
FILLM 50
PRCLM 2
WSDEF 256
WSEXT 1,024
WSQUO 512
PGFLQUO 12,800

User account quotas are stored in the file SYSUAF.DAT. Use the Authorize Utility to verify and change user account quotas. First set your directory to SYS$SYSTEM and then run AUTHORIZE:


$ SET DEFAULT SYS$SYSTEM
$ RUN AUTHORIZE
UAF>

At the AUTHORIZE prompt (UAF>), enter the SHOW command with an account name to check a particular account. For example:


UAF> SHOW SMITH

To change a quota, enter the MODIFY command at the UAF> prompt. The MODIFY command has the following format:

MODIFY account-name/quota-name=nnnn

The following example changes the FILLM quota for the SMITH account and then exits from the utility:


UAF> MODIFY SMITH/FILLM=50
UAF> EXIT

After you exit from the utility, the OpenVMS system displays messages indicating whether or not changes were made. Once you have finished making the changes, the users must log out and log in again for the new quotas to take effect.

For more information on modifying account quotas, see the description of the Authorize Utility in the OpenVMS documentation on system management and operations.

4.7 Setting up ACMS on an OpenVMS Cluster System

Because ACMS treats an OpenVMS Cluster system as if it were a local area network, you must perform the following operations on each node of the cluster:

4.8 Enabling Distributed ACMS Processing

By default, ACMS does not enable distributed processing. If submitters on your node need to select tasks in a remote application, or if remote submitters need to select tasks in an application on your node, you must set the NODE_NAME parameter in ACMSGEN to your node name. (This step is usually necessary only for new installations, not system upgrades.) For example:


$ RUN SYS$SYSTEM:ACMSGEN
ACMSGEN> SET NODE_NAME DOVE
ACMSGEN> WRITE SYS$SPECIFIC:[SYSEXE]ACMSPAR.ACM

For more information about using ACMSGEN and ACMS distributed processing, see Compaq ACMS for OpenVMS Managing Applications.

4.9 Rebuilding the LSE Environment

If the DECtp Implementation Toolkit for OpenVMS is installed on your system, you must rebuild the toolkit's LSE environment and section files after installing ACMS Version 4.3. See the toolkit documentation for instructions on how to rebuild the LSE environment.

4.10 Installing ACMS Menu Form Files

If you have customized the ACMS menu form definition file, you must rebuild the form image file. Use the following DCL command file to rebuild and install the new form image file on the system:


$  @SYS$MANAGER:ACMS_BUILD_MENU_FORM.COM

4.11 Preparing Language-Specific ACMS Development Environments

The following sections describe how to set up an environment for developing ACMS agents in BLISS or Pascal.

4.11.1 BLISS Agents

ACMS Version 4.3 supplies the ACMSBLI.R32 file. If you plan to use BLISS agents, see the BLISS-32 documentation for directions on building the BLISS library file (ACMSBLI.L32) from the ACMSBLI.R32 file, and for general information on creating library files, and using library files and require files.

ACMSBLI.R32 contains the following:

4.11.2 Pascal Agents

ACMS Version 4.3 supplies the ACMSPAS.PAS file. If you plan to use Pascal agents, you must compile this file into an environment file. See the VAX Pascal documentation for directions on building the environment file (.PEN) from the ACMSPAS.PAS file, and on using environment definitions.

ACMSPAS.PAS contains the following:

Note

If you use the nonpositional syntax form of parameter association, you must use PROCEDURE_ rather than PROCEDURE as the formal parameter name for ACMS$GET_PROCEDURE_INFO, because PROCEDURE is a reserved word in Pascal. See VAX Pascal Reference Manual for more information.

4.12 Determining and Reporting Problems

Installing ACMS changes the state of your system. Record any changes to the system in your system management log. If an error occurs while ACMS is being used and you believe that the error is caused by a problem with ACMS, contact a Compaq Customer Support Center to report the problem.


Chapter 5
Running the ACMS IVP

This chapter describes how to run the ACMS software Installation Verification Procedure (IVP) separately from the installation procedure. The IVP checks that the installation procedure has successfully installed the ACMS software, and that the software can create and run ACMS applications.

The IVP can be run as a part of the normal installation. However, if the automatic IVP fails for any reason, correct the error and then run the IVP again.

You can also execute the IVP to verify that ACMS is functioning properly after your system environment has changed; for example, after you have installed or upgraded another layered product that ACMS uses, such as DECforms or Rdb.

5.1 Functions of the IVP

Table 5-1 lists the tests performed by the ACMS IVP. The full set of tests is performed if you installed the development kit; subsets are performed for the run-time kit with CDD, the run-time kit without CDD, and the remote-access kit.

Note

If disk quotas are enabled, the IVP fails. The installation procedure checks to see if disk quotas are enabled. If disk quotas are enabled, the installation procedure displays an informational message to that effect and continues. See Section 2.5 for more information on disk quotas.

Table 5-1 ACMS IVP Tests
Test Description Development Kit1 Run-Time Kit with CDD1 Run-Time Kit Without CDD Remote-
Access Kit
Check ACMS files + + + +
Define tasks and task groups +      
Define application + +    
Link procedure server image + + +  
Update DDF and UDF files + + + +
Create ACMSPAR file + + + +
Start ACMS system + + + +
Start application + + +  
Select tasks + + +  
Test ACMS debugger +      
Test Queued Task Initiator + + + +
Test queue manager + + + +
Stop ACMS system + + + +


1The IVP may fail if a DECdtm log file is not present on the system. CDD uses DECdtm, and, therefore, that portion of the IVP that builds the IVP task group and application is subject to the requirements of CDD and DECdtm. If you are installing the ACMS Remote-Access kit or the ACMS Run-Time kit without CDD, this error cannot occur. If the IVP fails, refer to Appendix D for directions on how to create a transaction log.

5.2 Running the IVP

To run the IVP independently of the installation procedure, follow these steps:

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


    Username:  SYSTEM
    Password:
    

  2. Shut down ACMS.
    You cannot run the IVP if ACMS is active on your system. To shut down ACMS, enter the following command at the DCL prompt:


    $ ACMS/STOP SYSTEM/CANCEL
    

  3. Set your default to SYS$SYSROOT:[SYSTEST.ACMS]:


    $ SET DEFAULT SYS$SYSROOT:[SYSTEST.ACMS]
    

  4. Run the ACMS Installation Verification Procedure, ACMSIVP.COM.
    To start the IVP, enter the following command:


    $ @ACMSIVP
    

The IVP checks for the presence of the user account ACMS$IVP. If the account does not exist, the IVP asks you for a user identification code (UIC) and password so that it can create the account. Refer to Section 2.9 and Section 3.2.2 for more information on creating the ACMS$IVP account.

Section 2.8 contains information on the time necessary to execute the IVP.


Previous Next Contents Index