HP-UX Reference (11i v1 00/12) - 1M System Administration Commands A-M (vol 3)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/!!!intro.1m
________________________________________________________________
___ ___
a
amlog(1M) amlog(1M)
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 sys-
tem 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
availablefrom 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.
Section 1M32 2 HP-UX Release 11i: December 2000
___
___