Compaq ACMS for OpenVMS
Version 4.4 Release Notes

Previous Contents

6.10 Use Logical Names for File Allocation in ACMSATL

The Audit Trail Logger (ACMSATL) attempts to translate the following logical names and uses the values specified when the Audit Trail Log file is created:

See the OpenVMS Record Management Services Reference Manual for additional information on these fields.

6.11 New Logical Name Must be Defined for RI Agents and User-Written Agents

During the initialization of a CP process or a user-written agent, ACMS determines the following two conditions: whether CMA is in the process and the version of DECforms being used. Depending on these two conditions, the ACMS agent with respect to DECforms operates in either SINGLE-USER mode or MULTI-USER mode.

SINGLE-USER mode is defined as one (1) user at a time executing an ACMS task. A single-threaded user-written agent is an example of SINGLE-USER mode.

MULTI-USER mode is defined as more than one (1) user at a time executing an ACMS task. A CP process is an example of MULTI-USER mode. If you use a MULTI-USER user-written agent with DECforms Version 2.2, the agent must be linked with CMA.

ACMS provides the logical name ACMS$DECFORMS_IN_AGENT. This logical name must be defined as a process logical name when a user-written agent uses DECforms in ACMS tasks. The following values are valid for defining the logical name to a TRUE value: 1, "T", "t", "Y", "y". For example:


ACMS Version 4.1 used the logical name ACMS$CMA_USER_AGENT for essentially the same purpose, but the name was confusing. Later versions of ACMS still support this logical name, but it is undocumented.

Compaq recommends that you use settings for the logical name based on the version of DECforms that the agent uses, as follows:

Define the logical name ACMS$DECFORMS_IN_AGENT only when using DECforms Version 2.1B or when using DECforms Version 2.2 or later in MULTI-USER mode.

6.12 Cache Directories for Application and Forms Files Should Not Be Write Protected

The directories used for caching the application and forms files should not be write protected. Write protecting the caching directories will cause the task to fail when caching of the application or forms files to the submitter node is performed.

6.13 No Longer Necessary to Store ACMS Definitions in CDD

In previous versions of ACMS, after ACMS definitions were checked for syntax errors they were always stored in CDD. When all the definitions were processed, the definitions were read out of the dictionary, and a database file to be used by the ACMS run-time software was created. With ACMS Version 4.3 and later, the ACMS definitions no longer have to be stored in CDD. The ADU COMPILE command can be used to compile ACMS definitions and store the results in an OpenVMS file. Once all the definitions are processed, the ADU LINK command can be used to create the runtime database files.

CDD record definitions must continue to be stored in the dictionary. When determining whether to store definitions in CDD or to compile the definitions into OpenVMS files, keep in mind the following:

For more information about the ADU COMPILE and LINK commands, refer to the Compaq ACMS for OpenVMS ADU Reference Manual.

Chapter 7
Guidelines for Reporting an ACMS Problem

The following sections discuss the kinds of information you should have available when reporting an ACMS problem.

7.1 Calling in a Problem to Your Compaq Support Representative

When you call your Compaq support representative to report a problem, the telephone support specialist will most likely ask you for the following information:

The support specialist may also ask for the following information:

After listening to your responses, the specialist might be able to provide immediate help or might have to call you back after doing some testing and research. For problems that the specialist cannot reproduce or resolve, you might be asked to supply additional detailed information.

7.2 Additional ACMS Information You Can Collect

This section provides additional information that you may be asked to collect to assist in analyzing a problem. It would be helpful if, for very large log files, you extract and forward only the portion of the log file that represents the time of the error.

7.2.1 Reporting Problems with ACMS Utilities

In addition to the information listed in Section 7.2, it may be helpful to collect the following information for problems with ACMS utilities:

7.2.2 Reporting Problems with the ACMS Run-Time System

In addition to the information listed in Section 7.2, it may be helpful to collect the following additional information for problems with the ACMS run-time system:

7.2.3 Reporting Problems with the Remote Manager Web Agent

If you encounter problems with the Remote Manager web agent process (ACMS$MGMT_HMMO), refer to the following files for error information specific to the web agent:


If the problem is with WBEM$SERVER process, supply your Compaq support representative with the dump file. If the problem is with the Remote Manager web agent process, please have the following files ready for analysis in addition to a procedure which reproduces the error condition:


Previous Contents Contents