ADSM V3R1 Messages

Part 1. Introduction

Chapter 1. Introduction

ADSTAR Distributed Storage Manager (ADSM) is an enterprise-wide storage management application for the network. It provides automated storage management services to multivendor workstations, personal computers, and local area network (LAN) file servers. ADSM is a client/server program that allows a user to save copies of files and then recover those copies if the original files are damaged or lost. The product uses an AIX, MVS, or Windows NT host system to save and recover workstation and personal computer data files.

ADSM includes the following components:

Server

Allows a host system to provide backup, archive, and space management services to workstations. The server maintains a database and recovery log for ADSM resources, users, and user data.

The server controls the ADSM server storage, or storage pools. These are groups of random and sequential access media that store backed up, archived, and space-managed files.

The ADSM server comes with an interface to server utilities for tasks such as configuring devices.

Administrative client

Allows administrators to control and monitor server activities, define management policies for client files, and set up schedules to provide services at regular intervals.

Backup-archive client

Allows users to maintain backup versions of their files, which they can restore if the original files are lost or damaged. Users can also archive files for long-term storage and retrieve the archived files when necessary. Users or administrators can register workstations and file servers as client nodes with an ADSM server.

Hierarchical storage management (HSM) client

Provides space management services for workstations on some platforms. ADSM users can free workstation storage by migrating less frequently used files to server storage. These migrated files are also called space-managed files. Users can recall space-managed files automatically simply by accessing them as they normally would.

Application programming interface (API)

Allows users to enhance existing applications with backup, archive, restore, and retrieve services. When users install the ADSM API client on their workstations, they can register as client nodes with an ADSM server.

This chapter contains information to help you understand the messages issued by ADSTAR Distributed Storage Manager (ADSM):

Server program
Administrative client graphical user interface
Administrative command line client
Backup-archive client
Space-management client

Messages can appear on the server console, the administrative client, an operator terminal, the administrative graphical user interface, the backup-archive client, or the space-management client.

ADSM provides an activity log to help the administrator track server activity and monitor the system.

The activity log contains messages generated by the server and is stored in the database. To access the activity log from the administrative graphical user interface, select the SERVER icon. The server automatically deletes messages from the activity log after they have passed the specified retention period. Any messages sent to the server console are stored in the activity log. Examples of the types of messages stored in the activity log include:

When client sessions start or end
When migration starts or ends
When backed up files are expired from data storage
Any output generated from background processes

Understanding Messages

The following examples illustrate the format used in this publication to describe ADSM messages:

Messages that begin with prefix ANE and are in range 4000-4999 originate from the backup-archive client and are documented in Chapter 23. "Event Logging (ANE4000-4999)". These messages (or events) are sent to the server for distribution to various event logging receivers.

The client may send statistics to the server providing information about a backup or restore. These statistics are informational messages that may be enabled or disabled to the various event logging receivers. These messages are not published in this manual. See "Messages Not Appearing in This Publication" for a list of the unpublished messages.

Messages that begin with prefix ANR originate from the server.

Messages that begin with prefix ANS and are in range 5000-5999 and 8000-8999 originate from the administrative client.

Any ANS messages not in range 5000-5999 and 8000-8999 are backup-archive client or space management client messages and are documented in Part 3. of this manual.

Message Format

The following examples describe the ADSM message format:

The callouts to the right identify each part of the format.


         ---------------------------------------------- Message Prefix
         |   ------------------------------------------ Message Number
         |   |   -------------------------------------- Message Type*
         |   |   |
         |   |   |
          
 ---- ANR 0992 I  ------------------------------à
 |                                                 |
 | ADSM server installation complete.              î---- Message Text
 |                                                 |
 -------------------------------------------------
                                                  à
   Explanation:  The server installation           |
   procedure has completed successfully.  The      î---- Explanation
   server is now available for normal operation.   |
                                                  
                                                  à
   System Action:  Server completes installation   |
   processing.                                     î---- System Action
                                                   |
                                                  
                                                  à
   User Response:  None.                           |
                                                   î---- User Response
                                                   |
                                                  
* I = Information
  E = Error
  S = Severe Error
  W = Warning
  K = Kernel messages that originate from the space management client

Message variables in the message text appear in italics. Both server and client messages fall into two categories:

Common messages that pertain to all ADSM server platforms, and common messages that pertain to all ADSM client platforms
Platform specific messages that pertain to each operating environment for the server and the client

How to Read a Return Code Message

Many different commands can generate the same return code. The following examples are illustrations of two different commands issued that result in the same return code; therefore, you must read the descriptive message for the command.

Example One for QUERY EVENT Command


         *----------------------------------------------> Message Prefix
         |   *------------------------------------------> Message Number
         |   |   *--------------------------------------> Message Type
         |   |   |
         |   |   |
        *** *** ***
 *----* ANS NNNN T  *------------------------------*
 |                                                 |
 | adsm> q event standard dddd                     *----> Command
 |                                                 |      issued
 *-------------------------------------------------*
                                                  **
   ANR2034I: QUERY EVENT: No match found for this  |      Descriptive
   query.                                          *----> message
                                                   |
                                                  **
                                                  **
                                                   |      (This value is
   ANS5102I: Return code 11                        *----> explained in
                                                   |      the descriptive
                                                   |      message.)
                                                  **

Example Two for DEFINE VOLUME Command


         *----------------------------------------------> Message Prefix
         |   *------------------------------------------> Message Number
         |   |   *--------------------------------------> Message Type
         |   |   |
         |   |   |
        *** *** ***
 *----* ANS NNNN T  *------------------------------*
 |                                                 |
 | adsm> def vol cstg05 primary                    *----> Command
 |                                                 |      issued
 *-------------------------------------------------*
                                                  **
   ANRxxxxx: DEFINE VOLUME: Storage pool CSTG05    |      Descriptive
   is not defined.                                 *----> message
                                                   |
                                                  **
                                                  **
                                                   |      (This value is
   ANS5102I: Return code 11                        *----> explained in
                                                   |      descriptive
                                                   |      message.)
                                                  **

[ Top of Page | Previous Page | Next Page | Table of Contents ]