HP OpenVMS Systems Documentation
Compaq ACMS for OpenVMS
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.
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:
Refer to Compaq ACMS for OpenVMS Managing Applications for information on how to use the ACMSPARAM and ACMEXCPAR command procedures.
-ACMSMSS-E-INVACMPAR, The system MSS parameters are invalid
$ MCR ACMSGEN USE CURRENT SET MSS_POOLSIZE 1024 WRITE CURRENT
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
$ SET DEFAULT SYS$SYSTEM $ RUN ACMSDDU DDU> ADD $ALL DDU> EXIT
For information on using DDU, see Compaq ACMS for OpenVMS Managing Applications.
Users on your system cannot sign in to ACMS until you authorize $ALL or specific terminals.
$ SET DEFAULT SYS$SYSTEM $ RUN ACMSUDU UDU> ADD $ALL UDU> EXIT
For information on using UDU, see Compaq ACMS for OpenVMS Managing Applications.
Users on your system cannot sign in to ACMS until you authorize $ALL or specific user names.
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.
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.
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.)
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.
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.
|Account Quota||Value (=>)|
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:
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:
$ LICENSE LOAD ACMS
$ INSTALL REPLACE SYS$SHARE:DCLTABLES
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.4. See the toolkit
documentation for instructions on how to rebuild the LSE environment.
4.10 Installing ACMS Menu Form Files
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.4 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:
ACMS Version 4.4 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:
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.
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.
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.
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.
|Test Description||Development Kit1||Run-Time Kit with CDD1||Run-Time Kit Without CDD||Remote-
|Check ACMS files||+||+||+||+|
|Define tasks and task groups||+|
|Link procedure server image||+||+||+|
|Update DDF and UDF files||+||+||+||+|
|Create ACMSPAR file||+||+||+||+|
|Start ACMS system||+||+||+||+|
|Test ACMS debugger||+|
|Test Queued Task Initiator||+||+||+||+|
|Test queue manager||+||+||+||+|
|Stop ACMS system||+||+||+||+|
To run the IVP independently of the installation procedure, follow these steps:
Username: SYSTEM Password:
$ ACMS/STOP SYSTEM/CANCEL
$ SET DEFAULT SYS$SYSROOT:[SYSTEST.ACMS]
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.