amlog(1M)

NAME

amlog — displays host-based controller log entries for a disk array

SYNOPSIS

amlog [-s StartTime] [-e EndTime] [-d LogDir] [-S] [-a ArrayID]

amlog -?

DESCRIPTION

amlog displays the contents of the disk array controller logs maintained by the host. These logs contain information useful for diagnosing and troubleshooting the disk array. The host maintains multiple log files containing entries for each disk array.

The ArrayID used to address the disk array must be the disk array ID. An alias name cannot be used because alias names are not recorded in the log.

Identifying Disk Modules

Disk modules are identified within Array Manager 60 using a numbered pair of the form n:n. The first number identifies the SCSI channel (or bus) connecting the array controller to the enclosure containing the disk module. The channel number is indicated on the back of the array controller enclosure. The second number is the disk module SCSI ID. The SCSI ID is determined by the slot in which the disk module is installed, but is not the same as the physical slot number (0-9).

For example, the numbered pair 2:1 identifies the disk module on channel 2 with a SCSI ID of 1. Refer to the Disk Array FC/60 User's Guide for more information on disk module addressing.

Options

amlog supports the following options:

-a ArrayID

Identify a specific disk array for which the logs will be displayed. The default is to display the logs for all disk arrays.

-d LogDir

Specify the path name of the log directory. The default is /var/opt/hparray/log.

-e EndTime

Specify the ending date and time. Log records with a later date and time will not be printed. The default is the time of the last log record. Uses the same format as StartTime.

-s StartTime

Specify the starting date and time. Log records with an earlier date and time will not be printed. The default is the time of the oldest log record. The format for entering the date and time is MMddhhmm[yy], where

MM: = Month (01-12)
dd: = Day (01-31)
hh: = Hour (00-23)
mm: = Minute (00-59)
yy: = Year (00-99) [optional]. Years earlier than 90 are interpreted as 2000 + YY.

-S

Raw output display. Data is output as a colon-delimited ASCII text string. Raw output format is described below.

-?

Display expanded usage message. This option overrides all others.

SECURITY CONFIGURATION

This command is modified for all security configurations.

Security Behavior/Restrictions

Use of this command is restricted to authorized users only.

Command Authorizations

This command requires the sysadmin authorization to successfully execute.

Privileges

The command has been modified to support least privilege. The potential privileges possessed by the command and their uses include:

allowdacread: This privilege is raised to provide discretionary read access to the devices.
allowdacwrite: This privilege is raised to provide discretionary write access to the devices.
allowmacread: This privilege is raised to provide mandatory read access to the devices.
allowmacwrite: This privilege is raised to provide mandatory write access to the devices.
filesysops: This privilege is raised to allow the mknod(2) system call to succeed.
writeaudit: The command generates its own audit records and submits these directly to the system audit trail. This privilege is raised whenever the command needs to write an audit record.

EXTERNAL INFLUENCES

Environment Variables

LC_MESSAGES determines the language in which messages are displayed. The current language settings can be checked with locale(1).

RETURN VALUE

amlog returns the following values:

0: Successful completion.
1: An error in execution (I/O, subsystem, security, etc.) occurred.
2: An error in command syntax occurred: for example, an unknown command-line option was passed.

DIAGNOSTICS

The following message can be generated by amlog:

Usage: amlog [-s <StartTime>] [-e <EndTime>]

[-d <LogDir>] [-S] [-a <ArrayID>] 

amlog -?

An error in command syntax has occurred. Re-enter the command with all necessary arguments.

EXAMPLES

Display the controller log for disk array 000200A0B805E798. Display the log entries entered since 6/1/99.

amlog -s 0601000099 -a 000200A0B805E798 

Display the controller log for all disk arrays on the host. Use the default settings to display all log entries.

amlog 

RAW OUTPUT FORMAT

The contents of the raw output text string for log entries is as follows:

AL:LogFilename:AddSenAvailable:SenseDate:SenseTime:FRUCode: 
FRUCodeQual:SK:ASC:ASCQ:ArrayID:LogDate:LogTime:LUN 

One record will be printed for each log entry between the start and end times.

LogFilename is the name of the server log file where the record is found.

The leading AL is literal, and identifies this as an AM60 LOG record.

AddSenAvailable is a boolean that indicates whether the SenseDate, SenseTime and FRUCodeQual are available from the SCSI sense data that generates these fields. If FALSE (0), these fields will be undefined.

SenseDate and SenseTime correspond to the time of the reported event, while LogDate and LogTime correspond to the time when the event was written to the log file. The format of the SenseDate is MMDDYY, while that of LogDate is MMDDYYYY. The format for the SenseTime and LogTime is HHMMSS.

The SCSI sense data fields, FRUCode, SK, ASC,ASCQ, are one byte hexadecimal; the FRUCodeQual field is two bytes hexadecimal.

If the LUN information in the sense data is valid, it will be included.

DEPENDENCIES

There are no dependencies for this command.

AUTHOR

amlog was developed by HP.