unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 amdsp(1M)							   amdsp(1M)




 NAME
      amdsp - display the status and operating configuration of the disk
      array

 SYNOPSIS
      amdsp [ -l [LUN] | -g | -d | -c | -s | -h | -a | -A | -r ] [-V] [-S]
	   [-?] ArrayID

      amdsp -p [-V] [-S] [-?] DeviceFile

      amdsp -i [-V] [-S] [-?]

      amdsp -R [-V] [-?]

 DESCRIPTION
      amdsp displays status and configuration information for the disk array
      identified by ArrayID.  Logical configuration, physical configuration,
      and current status can all be displayed using amdsp.  A list of all
      the disk arrays recognized by the host can also be displayed.

      The ArrayID used to address the disk array can be the disk array
      serial number or name, if one has been assigned to the disk array.

    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
      amdsp supports the following options:

	   none		  Display general information about the disk array.
			  This includes product and vendor information,
			  array state, and capacity usage.

	   -a		  Display all information presented by the -c,-d,-g,
			  -h,-s,-l, and -r options.  This is a quick way of
			  displaying all configuration and status
			  information about the disk array.  This option
			  will display information for all LUNs.

	   -A		  Display information related to the interface
			  between the server and the specified disk array.



				    - 1 -	  Formatted:  August 2, 2006






 amdsp(1M)							   amdsp(1M)




	   -c		  Display information for both disk array
			  controllers and the BCC disk system controllers.

	   -d		  Display information for all disks installed in the
			  array.  Each disk is identified by a numbered pair
			  of the form channel:ID.  The enclosure and slot in
			  which the disk is installed are also displayed.

	   -g		  Display disk group information.  Information will
			  be displayed for each disk group on the disk
			  array.  There is a disk group for each LUN.

	   -h		  Display information about the disk array hardware.
			  This includes the hardware components in the disk
			  array subsystem and each disk system.

	   -i		  Display the ID of all disk arrays currently
			  connected to and recognized by the server.  If the
			  disk array has been assigned a name, it will also
			  be displayed.	 Because this option is device-
			  independent, it does not use ArrayID.

	   -l [LUN]	  Display information for the LUN identified by LUN.
			  If LUN is not specified, display information for
			  all LUNs on the disk array.

	   -p DeviceFile  Display hardware path information for the
			  controller corresponding to the specified device
			  file.

	   -r		  Display the progress of all rebuilds currently in
			  progress on the disk array.

	   -R		  Rescan for disk arrays.  The host will scan for
			  all supported disk arrays and update the current
			  list.	 This may be useful if a new disk array has
			  been added but does not yet show up in the disk
			  array list returned by the -i option.

	   -s		  Display disk array state information.	 This
			  includes cache settings for the disk array.

	   -S		  Raw output display.  Data is output as a colon-
			  delimited ASCII text string.	Raw output format is
			  near the end of this page.

	   -V		  Verbose mode displays additional command
			  execution, state, and/or status messages.

	   -?		  Display extended usage message.  This option
			  overrides all others.



				    - 2 -	  Formatted:  August 2, 2006






 amdsp(1M)							   amdsp(1M)




 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
      amdsp 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.
	   3	Timeout in communication to server.  May indicate AM60Srvr
		is not running.





				    - 3 -	  Formatted:  August 2, 2006






 amdsp(1M)							   amdsp(1M)




 DIAGNOSTICS
      The following messages can be generated by amdsp:

      Usage: amdsp [-l [LUN] | -d | -g | -c |
	   -s | -h | -r | -a | -A]
	   [-V] [-S] <&lt&lt&lt;ArrayID>&gt&gt&gt;

      amdsp {-i | -R} [-V] [-S]

      amdsp -p [-V] [-S] <&lt&lt&lt;DeviceFile>&gt&gt&gt;

      Extended help: amdsp -?
	   An error in command syntax has occurred. Reenter the command with
	   all necessary arguments.

      amdsp: Arg out of range
	   One of the arguments has exceeded its maximum or minimum size, or
	   is incorrect in form.  Check the size and form of each argument.

      amdsp: The <&lt&lt&lt;ArrayID>&gt&gt&gt; entered does not identify a known, supported
	   array
	   The specified ArrayID does not exist or does not identify a
	   device that is communicating with the system.  Verify the array
	   exists and is operational.

      amdsp: The specified controller is not physically installed.
	   A controller-specific command was issued to a non-existent or
	   inaccessible controller.

      amdsp: The specified LUN does not exist in this array.
	   The specified LUN does not exist.

      amdsp: No array controllers installed
	   The software was unable to identify an installed controller in
	   the array.  This may be due to controller failure, or cabling
	   problems.  Correct the problem and re-issue the command.

      amdsp: No controller hardware path was found for the given device file
	   A controller-specific command was issued to a non-existent or
	   inaccessible controller.

      amdsp: Error in command execution, <&lt&lt&lt;Additional Error Info>&gt&gt&gt;:
	   <&lt&lt&lt;Error Info Decode>&gt&gt&gt;
	   The command failed due to a device error, an internal error, or a
	   system error.  The Additional Error Info and Error Info Decode
	   fields will hold specifics about the failure and its cause.

 EXAMPLES
      Display general information about disk array RACK_51:





				    - 4 -	  Formatted:  August 2, 2006






 amdsp(1M)							   amdsp(1M)




	   amdsp RACK_51

      Display information for LUN 2 on disk array named RACK_51:

	   amdsp -l 2 RACK_51

      Display information for all LUNs on disk array RACK_51:

	   amdsp -l RACK_51

      Display information for all disks installed in disk array named
      RACK_51:

	   amdsp -d RACK_51

      List the serial numbers of all of the disk arrays recognized by the
      host:

	   amdsp -i

 RAW OUTPUT FORMAT
      The contents of the raw output text string for each display option are
      listed here. Note that the raw output for the -a option comprises the
      individual strings displayed by the -l,-d,-c, -s,-g,-A, -r, and -h
      options.	For clarification when evaluating Boolean expressions,
      TRUE=1 and FALSE=0.

      OPTION	RAW OUTPUT DESCRIPTION

      none	D:VendorID:ProductID:ArrayID:ServerName:ArrayType:
		MfgProdCode:PhysCapacity:LUNCapacity:
		HotSpareCapacity:UnallocatedCapacity:ArrayState:
		ArrayAlias

		The leading D is literal to identify this as a DEFAULT
		record.

		All capacities are in GB where 1GB=1024^3 bytes , except LUN
		capacity, which is always in MB in raw output mode, where
		1MB=1024^2 bytes .

      -c	The following is output for each disk array controller:

		C:Subsystem:CntrlrID:CompState:CntrlrMode:Quiesced:VendorID:
		ModelNum:SerNumber:FWRevision:BootRevision:HPRev:LoopID:ALPA:
		PreferredALPA:CntrlrDate:CntrlrTime:CacheBattAge:ArrayID:NVRAMChecksum

		The following is output for each disk enclosure controller:

		C:Subsystem:CntrlrID:CompState:CntrlrMode:Quiesced:VendorID:




				    - 5 -	  Formatted:  August 2, 2006






 amdsp(1M)							   amdsp(1M)




		ModelNum:SerNumber:FWRevision:EncSerNum:EncID:SubsysChannel:
		SubsysScsiID:ThumbwheelSetting:CntrlrDate:CntrlrTime:CacheBattAge:ArrayID

		The leading C is literal to identify this as a CONTROLLER
		record.

		The above will be displayed for each controller installed.
		The first type of record shown above will be displayed for
		each Subsystem whose value is 0.  The second record type
		will be displayed when the Subsystem is greater than 0.

		Quiesced is a boolean field indicating whether the
		controller is quiescent.

		CntrlrMode, Quiesced, CntrlrDate, CntrlrTime, and
		CacheBattAge are only defined when the Subsystem is 0 (array
		controller enclosure).	Otherwise they are undefined.

		EncSerNum is the serial number of the disk subsystem
		enclosure.

		CntrlrTime is a colon delimited field having a format of
		HH:MM:SS.

		If CompState is not GOOD (1), or CntrlrMode is FAILED (4),
		information in the remaining fields may be undefined or
		absent.

		ALPA and PreferredALPA are displayed in hexadecimal.

		CacheBattAge is the time in days (rounded to the nearest 90
		days) since the cache battery age was last reset.

      -d	The following output is provided for each installed disk:

		PD:Channel:ID:EnclosureID:SlotID:DiskState:DiskGroupID:DGType:
		Capacity:Manufacturer:Model:FWRevision:SerialNum:ArrayID

		OR

		PD:Channel:ID:EnclosureID:SlotID:DiskState:DiskGroupID:DGType:
		Capacity:Manufacturer:Model:FWRevision:SerialNum:ArrayID:
		SparedChannel:SparedID

		The leading PD is literal to identify this as a PHYSICAL
		DISK record.

		The above will be displayed for each disk slot.	 For disks
		which have been bound to a LUN and then removed, or assigned
		as a hot spare and then removed, the Manufacturer, Model,
		FWRevision and SerialNum fields may be undefined.



				    - 6 -	  Formatted:  August 2, 2006






 amdsp(1M)							   amdsp(1M)




		Unassigned disks which are removed will have no PD record.

		Capacity is displayed in GB, rounded up to the nearest GB.

		If DGType is 1 (HOT SPARE), and if this disk is currently
		sparing another disk, then two extra fields will be printed,
		designating the channel and SCSI ID of the spared disk.

      -g	One or more LUN records will be displayed in the following
		format:

		G:VendorID:ProductID:DiskGroupID:DGType:
		NumLUns:LUN...:RemCapacity:RAIDLevel:SegmentSize:nDisks:
		Channel-ID,Channel-ID...:ArrayID

		The leading G is literal to identify this as a Disk Group
		record.

		The above fields will be displayed for each disk group.

		The following fields are undefined when DGType is 1 or 2:
		NumLUNs, LUN, RemCapacity, RAIDLevel, and SegmentSize.

		Note that capacity will always be expressed in MB for raw
		output.

      -h	One or more "component state records" will be displayed in
		the following format:

		H:VendorID:ProductID:SubSystem:CntrlrAStatus:CntrlrBStatus:
		PS1Status:PS2Status:Fan1Status:Fan2Status:TsensorStatus:
		BattStatus:EncSerNum:ArrayID

		OR

		H:VendorID:ProductID:SubSystem:CntrlrAStatus:CntrlrBStatus:
		PwrSupplyAStatus:PwrSupplyBStatus:FanAStatus:FanBStatus:
		TsensorStatus:BattStatus:EncSerNum:ArrayID

		The leading H is literal to identify this as a Hardware
		Status record.

		When the SubSystem is greater than 0 (disk enclosure), the
		BattStatus is undefined.

		When the SubSystem is greater than 0 (disk enclosure), the
		power supplies and fans are designated as A and B, rather
		than 1 and 2.  The left to right orientation of the disk
		enclosure power supplies may not match that of the array
		controller power supplies.




				    - 7 -	  Formatted:  August 2, 2006






 amdsp(1M)							   amdsp(1M)




		EncSerNum is the disk enclosure serial number, and is only
		defined when the SubSystem is greater than 0; otherwise, it
		is undefined.

      -i	The following output includes a separate field
		(ArrayID:Alias) for each disk array identified:

		I:ArrayID:Alias:ArrayID:Alias:...

		The leading I is literal to identify this as an Identify
		record.

      -l	L:VendorID:ProductID:LunNumber:Present:LunState:
		CacheState:Capacity:Owner:RaidLevel:SegmentSize:
		DiskGroup:nDisks:Channel-ID,Channel-ID,...:ArrayID:
		CME:CWOB:RCD:WCA:RCA:IsUtm:UtmLunState

		The leading L is literal to identify this as a LUN record.

		Present is a Boolean, TRUE if the LUN is configured, FALSE
		otherwise.

		If no option is specified, the above will be displayed for
		all LUNs, both present and not present.

		CacheState is a two-bit field in which the high order bit is
		the boolean CacheMirroringActive (CMA) state of the LUN's
		owning controller, and the low order bit is the boolean
		WriteCacheEnabled (WCE) state for the controller.

		CME (Cache Mirroring Enabled), CWOB (Cache Without
		Batteries), RCD (Read Cache Disabled), WCA (Write Cache
		Active), and RCA (Read Cache Active) indicate the state of
		the caching parameters.

		Capacities displayed in the raw output are always shown in
		MB, where 1MB=1024^2 bytes.

		IsUtm is a boolean that indicates whether the current LUN is
		the Universal Transport Mechanism (UTM).  When IsUtm is TRUE
		(1),  only the following additional fields are valid:
		VendorID,ProductID,LunNumber, Present, and UtmLunState.	 The
		remaining fields are undefined.

		When IsUtm is TRUE (1), UtmLunState indicates the status of
		the UTM LUN, as defined in the UTM Specification.  Otherwise
		this field is undefined.

		If nDisks is "0", the drive list (Chan-ID,Chan-ID,...) will
		also be "0".




				    - 8 -	  Formatted:  August 2, 2006






 amdsp(1M)							   amdsp(1M)




      -p	P:CntrlrID:SerNumber:ArrayID
		P:AltCntrlrID:AltSerNumber:ArrayID

		The leading P is literal to identify this as a HARDWARE PATH
		record.

		The first hardware path record is for the controller that
		corresponds to the given device file. The second record is
		for the alternate controller.  If the alternate controller
		is not present, its serial number will be 0.

      -r	R:VendorID:ProductID:CntrlrID:LUN:RebuildProgress:Freq:
		Amt:ArrayID

		The leading R is literal, and identifies this as a LUN
		rebuild record.

		One rebuild record is returned for each LUN that is
		currently rebuilding.  If no LUN is rebuilding, no record
		will be returned.

		RebuildProgress above is percent complete

		Freq is the rebuild frequency in tenths of a second

		Amt is the rebuild amount in blocks per rebuild command

      -s	S:VendorID:ProductID:ValidData-A:ValidData-B:
		CacheBlkSize-A:CacheBlkSize-B:CacheFlushThresh-A:
		acheFlushThresh-B:CacheFlushLim-A:CacheFlushLim-B:
		CacheSize-A:CacheSize-B:ArrayState:ArrayID

		The leading S is literal to identify this as an ARRAY STATE
		record.

 DEPENDENCIES
      AM60Srvr must be running to execute this command.	 See AM60Srvr(1M).

 AUTHOR
      amdsp was developed by HP.

 SEE ALSO
      ammgr(1M), amcfg(1M), amutil(1M), amlog(1M), AM60Srvr(1M).











				    - 9 -	  Formatted:  August 2, 2006