A P P E N D I X  B

Error Messages

This section discusses user-visible error messages for SMS. The types of errors and the numerical ranges are listed. To view individual errors, you must install the SMSHelp software package (SUNWSMSjh). This section contains instructions for installing SUNWSMSjh, if it was not already installed during the SMS software installation.

Each error in SMSHelp contains the error ID, the text of the message, the meaning of the message, references for further information if applicable, and recovery action to take or suggested steps for further analysis.

This chapter includes the following sections:


Installing SMSHelp

This section explains how to manually install the SUNWSMSjh package using the standard installation utility, pkgadd.


procedure icon  To Install the SUNWSMSjh Package

1. Log in to the SC as superuser.

2. Load the SUNWSMSjh package on the server:


# pkgadd -d . SUNWSMSjh 

The software briefly displays copyright, trademark, and license information for each package. Then it displays messages about pkgadd(1M) actions taken to install the package, including a list of the files and directories being installed. Depending on your configuration, the following messages might be displayed:


This package contains scripts which will be executed 
with superuser permission during the process of installing this 
package.
 
Do you want to continue with the installation of this 
package [y,n,?]

3. Type y at each successive prompt to continue.

When this portion of the installation is complete, the SUNWSMSjh package has been installed and the superuser prompt is displayed.

4. Log out as superuser.


procedure icon  To Start SMS Help

1. Log in to the SC as a user with platform or domain group privileges.

2. In any terminal window, type:


 sc0:sms-user:> smshelp &

The SMS help browser appears. You can resize the panes if necessary, by placing the pointer to the right of the vertical scrollbar, pressing the left mouse button, and dragging to the right.

3. Choose an error message and note its message.code.

Error messages are recorded in the platform and domain logs.

The message format follows the syslog(3) convention:


timestamp  host process_name  [pid]: [message_code 
hight_res_timestamp level source_code_file_name  
source_code_line_num] message_text

For example:


Feb 2 18:36:14 2002 xc17-sc0 dsmd[117469]-B(): [2517 
16955334989087 WARNING EventHandler.cc 121] Record stop has been 
detected in domain B.

Using the message_code, you can either do a quick search using the magnifying glass at the top of the browser, or you can scroll through the table of contents.

single-step bulletTo do a quick search, click the magnifying glass, enter the error message number, and press Return as shown in the following example.


single-step bulletTo scroll the table of contents, left-click on the message folder containing your error message, in this case, DSMD Error Messages, 2500 through 2599. Then click on error 2517, as shown in the following example.



Types of Errors

This section describes the six types of errors reflected in the error messages in SMS Help (TABLE B-1).


TABLE B-1 Error Types

Error

Description

EMERG

Panic conditions that would normally be broadcast to all users

ALERT

Conditions that should be corrected immediately, such as a corrupted system database

CRIT

Warnings about critical conditions, such as hard device failures

ERROR

All other errors

WARNING

Warning messages

NOTICE

Conditions that are not error conditions but might require special handling



Error Categories

TABLE B-2 shows the different error categories in SMS. Nonsequential numbering is due to error messages reserved for internal or service use.


TABLE B-2 Error Categories

Error Numbers

Message Group

0-499

Reserved for DEBUG, INFO and POST messages

500-699

Reserved for SMS Foundation Library messages

700-899

Reserved for SMS Application Framework messages

900-1099

Reserved for SMSEvent IF Library messages

1100-1299

Reserved for HWAD daemon and library messages

1300-1499

Reserved for ssd messages

1500-1699

Reserved for flashupdate messages

1700-1899

Reserved for pcd messages

1900-2099

Reserved for esmd messages

2500-2699

Reserved for dsmd messages

2700-2899

Reserved for addtag messages

2900-3099

Reserved for deletetag messages

3100-3299

Reserved for Permissions messages

3300-3499

Reserved for domain-tag messages

3500-3699

Reserved for addboard messages

3700-3899

Reserved for tmd messages

4100-4299

Reserved for showkeyswitch messages

4300-4499

Reserved for dca messages

4500-4699

Reserved for libscdr plugin messages

4700-4899

Reserved for osd messages

4900-5099

Reserved for dxs messages

5100-5299

Reserved for deleteboard messages

5300-5499

Reserved for setkeyswitch messages

5500-5699

Reserved for libdrcmd messages

5700-5899

Reserved for moveboard messages

5900-6099

Reserved for setupplatform messages

6100-6299

Reserved for power command messages

6300-6499

Reserved for xir library messages

6500-6699

Reserved for showplatform messages

6700-6899

Reserved for help messages

6900-7099

Reserved for reset messages

7100-7299

Reserved for showboards messages

7300-7499

Reserved for libshowboards messages

7500-7699

Reserved for autolock messages

7700-7899

Reserved for mand messages

7900-8099

Reserved for showenvironment messages

8100-8299

Reserved for resetsc messages

8300-8499

Reserved for dynamic bus reconfiguration messages

8500-8699

Reserved for fomd messages

8700-8899

Reserved for kmd messages

8900-9099

Reserved for setdefaults messages

9100-9299

Reserved for mld messages

9300-9499

Reserved for showdevices messages

9500-9699

Reserved for showxirstate messages

9700-9899

Reserved for COD messages

9900-10000

Reserved for frad messages

10100-10299

Reserved for fruevent messages

10300-10499

Reserved for smsconnectsc messages

10700-10899

Reserved for EFE messages

11100-11299

Reserved for rcfgadm messages

11300-11499

Reserved for datasync messages

11500-11699

Reserved for EFHD messages

11700-11899

Reserved for ELAD messages

11900-12099

Reserved for ERD messages

12100-12299

Reserved for Event Utilities messages

12300-12499

Reserved for Wcapp messages

12500-12699

Reserved for FRUID-related messages

12700-12799

Reserved for EBD error messages

50000-50099

Reserved for SMS generic messages