1 SWXCR The SWXCR Utilities are used to monitor and maintain SWXCR RAID disk arrays. 2 MONITOR The SWXCR MONITOR command is used to start a SWXCR monitor process. The monitor process will scan the SWXCR RAID array for non-optimal device status. Events are reported to the user either through OPCOM, an error log file, or by MAIL messages. Format: SWXCR MONITOR devname 3 Parameters devname The device name for the controller. For example, if you specify DRA as the device name, the monitor process scans all of the DRAn devices which are configured on the subsystem. If you specify a unit number, a device with the specified unit number must exist. If you do not specify a unit number, then unit 0 (DRx0) must exist. 3 Qualifiers /INTERVAL=n Specifies the rate at which the SWXCR RAID array is scanned for non-optimal status. The value of n can be 1 to 10, specifying the number of minutes that will elapse between the completion of a scan operation until the start of the next scan operation. Example: SWXCR MONITOR DRA0 /INTERVAL=1 /LOG /NOLOG Causes events to be written into the product log file, SYS$COMMON:[SWXCR$LOG]SWXCR$MON_DRx.LOG, where x is the controller letter specified in the SWXCR MONITOR devname parameter. If /NOLOG is specified, no log file is created. The default is /NOLOG. /MAIL /NOMAIL Sends notification of subsystem events by mail. The default is /NOMAIL. If /MAIL is specified without a mailing list, then mail is sent to the SYSTEM account on the local node. Example: SWXCR MONITOR DRA0 /MAIL=(RONCO::SMITH) /OPCOM /NOOPCOM Specifies that the SWXCR monitor process send notification of subsystem events to OPCOM. If /NOOPCOM is specified, events are not sent to OPCOM. The default is /OPCOM. /REPEAT /NOREPEAT Specifies that unique events will be reported as long as the condition exists in the system. For example, if a hard disk status changes to failed, every time the monitor process scans the array, it will report that the hard disk is failed. If /NOREPEAT is specified, a unique event is reported only the first time it is encountered. The default is /NOREPEAT. 3 devname The device name for the controller. For example, if you specify DRA, as the device name, the monitor process scans all of the DRAn devices which are configured on the subsystem. If you specify a unit number, a device with the specified unit number must exist. If you do not specify a unit number, then unit 0 (DRx0) must exist. 3 /INTERVAL Specifies the rate at which the SWXCR RAID array is scanned for non-optimal status. The value of n can be 1 to 10, specifying the number of minutes that will elapse between the completion of a scan operation until the start of the next scan operation. Example: SWXCR MONITOR DRA /INTERVAL=10 3 /LOG Causes events to be written into the product log file, SYS$COMMON:[SWXCR$LOG]SWXCR$MON_DRx.LOG, where x is the controller letter specified in the SWXCR MONITOR devname parameter. If /NOLOG is specified, no log file is created. The default is /NOLOG. 3 /MAIL Sends notification of subsystem events by mail. The default is /NOMAIL. If /MAIL is specified without a mailing list, then mail is sent to the SYSTEM account on the local node. Example: SWXCR MONITOR DRA0 /MAIL=(RONCO::SMITH) 3 /OPCOM Specifies that the SWXCR monitor process send notification of subsystem events to OPCOM. If /NOOPCOM is specified, events are not sent to OPCOM. The default is /OPCOM. 3 /REPEAT Specifies that unique events will be reported as long as the condition exists in the system. For example, if a hard disk status changes to failed, every time the monitor process scans the array, it will report that the hard disk is failed. If /NOREPEAT is specified, a unique event is reported only the first time it is encountered. The default is /NOREPEAT. 2 CHECK The SWXCR CHECK command is used to verify, and optionally repair, the parity information on the SWXCR logical RAID drives. This function is only available for redundant RAID levels (for example, RAID 1, RAID 0+1, and RAID 5). Format: SWXCR CHECK devname 3 Parameters devname The device name for the desired logical RAID drive on the controller. For example, if you specify DRA1 as the device name, the parity is checked on logical RAID drive '1' on controller 'A'. Example: SWXCR CHECK DRA2 3 Qualifiers /LOG /NOLOG Display a log of bad block information. The default is /NOLOG. /OUTPUT Write a log of bad block information to a log file, or to the default log file, SYS$COMMON:[SWXCR$LOG]SWXCR$DRxn_CHECK.LOG. /REPAIR /NOREPAIR Repair any inconsistent parity information. The default is /NOREPAIR. 3 devname The device name for the desired logical RAID drive on the controller. For example, if you specify DRA1 as the device name, the parity is checked on logical RAID drive '1' on controller 'A'. Example: SWXCR CHECK DRA1 3 /LOG Display a log of bad block information. The default is /NOLOG. 3 /REPAIR Repair any inconsistent parity information. The default is /NOREPAIR. 3 /OUTPUT Write a log of bad block information to the specified log file. If no log file name is specified, output is to the default log file, SYS$COMMON:[SWXCR$LOG]SWXCR$DRxn_CHECK.LOG. Format: SWXCR CHECK DRA2 /OUTPUT=check.log 2 SHOW The SWXCR SHOW REBUILD_RATE command is used to display the current rebuild rate for a specified controller. Format: SWXCR SHOW REBUILD_RATE devname 3 Parameters devname The device name for the controller. For example, if you specify DRA as the device name, the current rebuild rate for the DRA controller is displayed. If you specify a unit number, a device with the specified unit number must exist. If you do not specify a unit number, then unit 0 (DRx0) must exist. 3 devname The device name for the controller. For example, if you specify DRA as the device name, the current rebuild rate for the DRA controller is displayed. If you specify a unit number, a device with the specified unit number must exist. If you do not specify a unit number, then unit 0 (DRx0) must exist. 2 SET The SWXCR SET REBUILD_RATE command is used to set the rebuild rate for a specified controller. The rebuild rate is the priority that the controller gives to the rebuild process. The rebuild rate can be set from 0 to 50, where 50 is the fastest and 0 is the slowest. Setting the rate to 50 causes the controller to run the rebuild process at equal priority with other disk operations. Setting the rebuild rate to 0 causes the controller to run the rebuild process only when there is no other disk activity. As a guideline, allow 20 minutes to rebuild 1 GB of data when the rebuild rate is set at 50 with minimal disk activity. Format: SWXCR SET REBUILD_RATE=rate devname 3 Parameters devname The device name for the controller. For example, if you specify DRA as the device name, the current rebuild rate for the DRA controller is displayed. If you specify a unit number, a device with the specified unit number must exist. If you do not specify a unit number, then unit 0 (DRx0) must exist. rate The rebuild rate value, from 0 to 50. A rate of 50 is the fastest, while 0 is the slowest. Setting the rate to 50 causes the controller to run the rebuild process at equal priority with other disk operations. Setting the rebuild rate to 0 causes the controller to run the rebuild process only when there is no other disk activity. As a guideline, allow 20 minutes to rebuild 1 GB of data when the rebuild rate is set at 50 with minimal disk activity. 3 devname The device name for the controller. For example, if you specify DRA as the device name, the current rebuild rate for the DRA controller is displayed. If you specify a unit number, a device with the specified unit number must exist. If you do not specify a unit number, then unit 0 (DRx0) must exist. 3 rate The rebuild rate value, from 0 to 50. A rate of 50 is the fastest, while 0 is the slowest. Setting the rate to 50 causes the controller to run the rebuild process at equal priority with other disk operations. Setting the rebuild rate to 0 causes the controller to run the rebuild process only when there is no other disk activity. As a guideline, allow 20 minutes to rebuild 1 GB of data when the rebuild rate is set at 50 with minimal disk activity. 2 REBUILD The SWXCR REBUILD command will initiate a rebuild operation on the specified physical drive. The specified drive must be in the FAILED state. Format: SWXCR REBUILD devname channel target 3 Parameters devname The device name for the controller. channel The channel number (0-2) of the physical drive to be rebuilt. target The target number (0-7) of the physical drive to be rebuilt. 2 MKOPT The SWXCR MKOPT command will set the state of the specified physical drive to OPTIMAL. Format: SWXCR MKOPT devname channel target 3 Parameters devname The device name for the controller. channel The channel number (0-2) of the physical drive to be made OPTIMAL. target The target number (0-7) of the physical drive to be made OPTIMAL. 2 FAIL The SWXCR FAIL command will set the state of the specified physical drive to FAILED. Format: SWXCR FAIL devname channel target 3 Parameters devname The device name for the controller. channel The channel number (0-2) of the physical drive to be set FAILED. target The target number (0-7) of the physical drive to be set FAILED. 2 SPARE The SWXCR SPARE command will mark the specified physical drive as being a HOT SPARE. Format: SWXCR SPARE devname channel target 3 Parameters devname The device name for the controller. channel The channel number (0-2) of the physical drive to be made a HOT SPARE. target The target number (0-7) of the physical drive to be made a HOT SPARE. 2 HELP The SWXCR HELP command prints help information for the SWXCR command. Format: SWXCR HELP