Compaq ACMS Version 4.3 for OpenVMS
Release Notes


Previous Contents


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:


Appendix A
Error Messages

This appendix contains the ACMS error messages.

A.1 Remote Manager Messages

The following error messages pertain to the ACMS Remote Manager.

SUCCESS, operation completed

Explanation: The ACMS Remote Manager service completed without error.
User Action: No action is required.
INFO, operation completed with information message

Explanation: The ACMS Remote Manager service completed without error but has logged an informational message. Informational messages are for debugging and auditing purposes.
User Action: No action is required.
NOMORE_DATA, no more data is available

Explanation: There is no more data that satisfies the query. This message is provided on list RPCs that can return more than one buffer of data. If a list RPC is called and this status is not returned, then more data is available that satisfies the query criteria. If this status is returned, then there is no more data to retrieve for this query.
User Action: No action is required. The query is complete.
WARN, operation completed with warning, Not all operations completed successfully

Explanation: The ACMS Remote Manager service did not complete successfully; some of the actions requested could not be completed. This status is returned in the following situations:
User Action: No action is required; however, the record_state field of any record returned should be checked. The Remote Manager flags old data with a record_state of MGMT$K_INACTIVE.

If this status is returned as the result of an ACMSMGR command, old (inactive) records are flagged with an asterisk (*) preceding the node name.

FAIL, operation failed

Explanation: The function requested could not be performed.
User Action: The appropriate action depends on the function being called. In general, additional information is displayed by the ACMSMGR command in conjunction with this error code. That information should be more indicative of the reason for failure. If this status was returned by an RPC, the failure occurred in the Remote Manager process; a second-level error code is returned in the output record.
NOMEM, memory allocation failed

Explanation: An internal memory allocation by the Remote Manager failed. This can occur during a request for data, a call to add a record to a table, or during server initialization while it is loading initial configuration information. In the first two instances, the Remote Manager continues to run; in the third, the Remote Manager exits.
User Action: Increase the amount of memory available to the Remote Manager. If the problem is due to insufficient physical or virtual memory, try allocating more page or swap space. If physical and virtual memory are not exhausted, try increasing the memory quotas for the account in which the Remote Manager is running. Be sure to check SYSGEN PQL quotas to ensure that the quotas you grant to the Remote Manager are allowed by the system.

After making more memory available to the Remote Manager, you must restart the Remote Manager process.

LOGIN_EXPIRED, login credentials have expired, please log in again

Explanation: The credentials you used to log in to the Remote Manager have expired. Credentials are granted when the user logs in and are valid for a period of time equal to the value of the login_creds_lifetime parameter at the time of login. After that time, the credentials expire and must be re-created by logging in to the Remote Manager again.

Note that while proxy credentials also expire, they are automatically re-created at the end of the expiration period. Therefore, this status is never returned to proxy users.
User Action: The user must log in to the Remote Manager again.

2MANY_USERS, the maximum number of users has been reached

Explanation: The user could not be logged in because the maximum number of concurrent users has been reached. This maximum is determined by the max_logins parameter, which is a dynamic parameter (that is, it can be changed dynamically).
User Action: Either log some users out, or increase the value of the max_logins parameter. You can use the ACMSMGR SHO USERS command to determine which users are already logged in to the Remote Manager. Note that in order to issue that command or to increase the max_logins parameter, you must be logged in.
NO_NODELOGICAL, cannot translate logical UCX$INET_HOST to get node name

Explanation: The logical name UCX$INET_HOST could not be translated by the client process. This logical is used to determine the current host name, which is used during client authentication. It is defined by the UCX or TCP/IP layered product when it is started. If this logical is not defined, UCX or TCP/IP is not started; either a different TCP/IP networking package is being used, or something has gone wrong with the logical name.
User Action: Verify that the UCX or TCP/IP layered product is started. If it is not, start it and then reissue the command. If it is started, contact your system administrator to determine why the logical is not defined.
NO_CREDS_FILE, credentials file not found

Explanation: The credentials file for the user either could not be found or could not be opened by the client process. The credentials file is created when a user explicitly logs in to the Remote Manager (that is, when the user supplies a user name and password). A separate credentials file is created for each node to which a particular process logs in. The logical name ACMS$MGMT_CREDS_DIR is used to point to the directory containing credentials files.
User Action: Verify that the ACMS$MGMT_CREDS_DIR logical is pointing to a valid disk and directory in which a credentials file has been created; verify that the process has read access to the files in the directory. If necessary, the process may have to log in to the Remote Manager again to create a new credentials file.
CREDS_DATA_ERR, credentials file is corrupt

Explanation: The credentials file for this user has been corrupted. The file has been opened, but the client process cannot parse the contents of the file.
User Action: The user should log in to the Remote Manager again. This will create a new credentials file.
WRONG_PID, current pid does not match pid in credentials file!

Explanation: The PID stored in the credentials file does not match that of the current process. Either the file is corrupt, or it has been tampered with.
User Action: The user should log in to the Remote Manager again. This will create a new credentials file.
WRONG_NODE, current node does not match node in credentials file!

Explanation: The node name stored in the credentials file does not match the node name on which the current process created it. Either the file is corrupt, or it has been tampered with.
User Action: The user should log in to the Remote Manager again. This will create a new credentials file.
BADHOUR, network access is prohibited for this hour for this account

Explanation: This status is returned during user login if the UAF record for this user does not allow network access during this time of day. Time-of-day restrictions on network access are set by system administrators or security personnel.
User Action: Either wait until an authorized hour to access the Remote Manager, or modify the network access portion of the UAF for this user.
BADDAY, network access is prohibited for this day of week for this account

Explanation: This status is returned during user login if the UAF record for this user does not allow network access on this day of the week. Day-of-week restrictions on network access are set by system administrators or security personnel.
User Action: Either wait until an authorized day of the week to access the Remote Manager, or modify the network access portion of the UAF for this user.
PWDFAIL, invalid password

Explanation: The password entered for the user during user login does not match the one stored in the UAF for this user on the server node.
User Action: Resubmit the login request for the user with the correct password.
PWDEXP, password has expired

Explanation: The password entered by the user has expired in the UAF on the server node.
User Action: The user must either change the password or have it unexpired by a system or security administrator.
DISUSER, account is disusered

Explanation: This status is returned during user login if the account associated with the user name has the DISUSER flag set.
User Action: Clear the DISUSER flag on the UAF record for the account.
ACCTEXP, account is expired

Explanation: This status is returned during user login if the account associated with the user name has expired.
User Action: Either remove or modify the account expiration.
NONETACCESS, network access is prohibited for this account

Explanation: This status is returned during user login if the account associated with the user name has not been granted network access. Network access is required, even if the user is logged in to same node on which the Remote Manager is running.
User Action: Grant network access to the account.
NOPROXY, proxy access is not enabled

Explanation: This status is returned when a user attempts to access a Remote Manager function without explicitly logging in, and proxy access has not been enabled on the Remote Manager node. Proxy access is enabled on the node by defining the system logical ACMS$MGMT_ALLOW_PROXY_ACCESS to be TRUE, true, T, t, Y, y, or 1. The translation of this logical is cached by the Remote Manager when the RPC thread is started.
User Action: If proxy access is not supposed to be enabled, then there is no action to perform. If proxy access is to be allowed, define the ACMS$MGMT_ALLOW_PROXY_ACCESS system logical, with a translation value of TRUE, true, T,t, Y, y or 1. Then restart the Remote Manager and resubmit the RPC.
INV_CLNTID, client id is invalid

Explanation: A request was made to the Remote Manager with an invalid client id. The client id is a unique value assigned to each client and used to verify client authorization. If the client id is not known to the Remote Manager, it either belongs to an old log in that has expired and been purged, or it was never valid.
User Action: The user should log in to the Remote Manager again.
PROXY_FAILED, proxy access attempt failed

Explanation: An attempt to verify proxy information for this client failed. A more specific message indicating why the proxy failed is written to the Remote Manager log. Reasons for proxy authentication failure include:
User Action: First check the Remote Manager log for any additional information related to the login attempt. Then verify that none of the conditions listed are preventing the login from succeeding.
NORIGHT, user does not hold the proper rights identifier

Explanation: Access to Remote Manager functions is restricted by a set of rights identifiers; the account being used to access the function must have the appropriate rights identifier. If this status code is returned, the account does not have the appropriate rights identifier.
User Action: Grant the appropriate rights identifier to the user's account. If a proxy account is being used, the rights identifier must be granted to the proxy account.
NOT_MAPPED, ACMSMGMT global section is not available

Explanation: This status code is returned if a Remote Manager function was requested that requires access to the ACMSMGMT global section, but the global section does not exist. The global section is created by the ACMS ACC during system startup. This status code indicates that the ACMS ACC is not running or that it has not yet created the global section.
User Action: Start the ACMS run-time system in order to create the global section. The ACMS run-time system can be started by using either the ACMSMGR START SYSTEM command or the ACMS/START SYSTEM command.
INVVAR, invalid variable value was provided

Explanation: This status code is obsolete.
User Action: No action required.
NOT_VALID, entity data is stale, please resubmit query or wait until later

Explanation: The entity record in the global section is not valid. If this status code is returned, it means that the entity has never been started on the Remote Manager node. If the entity had been running at one time but no longer is, a severity level of WARN is returned and the record_state is set to INACTIVE.
User Action: No action is required. However, if the entity is started on the Remote Manager node, the data will become available.
DUPLICATE_ROW, table row exists

Explanation: An attempt was made to add a row to either the Trap or the Collection table, but the row already exists.
User Action: Either modify the existing row, or add a new row with unique data.
TABLE_FULL, collection table is full. Non dynamic parameter total_entity_slots controls size

Explanation: An attempt was made to add a row to the Collection table, but there are no empty slots. The maximum number of rows in the Collection table is determined by the nondynamic parameter total_entity_slots.
User Action: To make the table bigger, modify this parameter in the configuration file (using the ACMSCFG command), and restart the ACMS run-time system. The Remote Manager can be left running.


Previous Next Contents