********************** The Power Management Utilities *********************** 

Power management support for NetWare is provided by two NLMs, PMMAKE.NLM and 
PMSCHED.NLM. Use one or both of these NLMs to activate power management of 
disk devices registered with the Netware operating system through the 
SDMSNETx.DSK driver.

PMSCHED.NLM allows manual control of power management to individual devices, 
while PMMAKE.NLM allows creation of a schedule for power management. You must 
not load these two utilities at the same time. If you plan to use power 
management regularly, you can have PMSCHED.NLM load from the AUTOEXEC.NCF 
file.

SDMS power management is supported only on disk devices. Some disk devices do 
not support power management. If such a device is detected, PMSCHED indicates 
the device is not power manageable. Command line options for the PMMAKE.NLM 
and PMSCHED.NLM utilities are described in this document.

Note: Power management of disk devices connected to Symbios Logic 8XX 
      controllers and handled by SDMSNETx.DSK is NOT supported in the NetWare 
      4.10 SFT-III environment.


*  *  *  *  *  *  * Installing the Power Management Utilities *  *  *  *  *

Follow these steps to install the Power Management Utilities.

1. Copy PMMAKE.NLM and PMSCHED.NLM to the SYS:\SYSTEM directory of the 
   NetWare server.

2. Create a subdirectory called SYS:\PM. This is the directory in which the 
   schedule text and configuration files should reside.


*  *  *  *  *  *  *  * Using the PMMAKE.NLM Utility  *  *  *  *  *  *  *  *

The PMMAKE.NLM utility is used to compile a power management schedule file 
from a standard text file, which you can create using the NetWare EDIT 
utility, or some other editor. Place the text file in the SYS:\PM directory 
on the server. The format for this text file is given below.

The syntax for the line that loads the PMMAKE utility is:

     load PMMAKE <input filename> [<output filename>]

where

<input filename> is the full path name of the text file containing the power 
management scheduling directives. If the path is not specified, the NetWare 
search path is used.

<output filename> is the full path name of the output configuration (CFG) 
file produced. If the output file name is not specified, the output file 
produced is named PM.CFG, located in the SYS:\PM directory.

The format for the PMMAKE input (text) file is:

     !<DAY INDICATOR>
     BEGIN, <START TIME>, <DELAY TIME>, <DEVICE LIST>
     END, <STOP TIME>, <DELAY TIME>, <DEVICE LIST>

where

DAY INDICATOR = SUN,MON,TUE,WED,THR,FRI,SAT 

START TIME = 24 hour time format: 00:00 - 23:59 

STOP TIME = 24 hour time format: 00:00 - 23:59 

DELAY TIME = Time to wait during no activity on a device before spinning it 
down, in seconds 1 - 3600 

DEVICE LIST = ALL or <DEVICE ID>[, <DEVICE ID> ...] 

DEVICE ID = BXXIXXLXX 

BXX identifies the bus 

IXX identifies the SCSI ID 

LXX identifies the LUN (if zero you can omit) 

You may omit bus identifiers after the first one. It is assumed that multiple 
sequential directives are on the same day until another day is specified. It 
is assumed that future devices are on the same bus until a new bus id is 
specified. 

For example: 

     B00I01L01, I02, I03, I04, B01I00, I01,I02

specifies 

     Devices ID 01 LUN 01, ID 2, ID 3, ID 4 on Bus 0

     Devices ID 0, ID1, ID 2 on Bus 1

Here is a PMMAKE sample input file:

     !SUN 
     BEGIN, 00:00, 10, ALL 
     END, 23:59, 10, ALL 
     !MON 
     BEGIN, 00:00, 10, ALL 
     END, 06:00, 10, B00I00 
     END, 06:30, 10, B00I01 
     BEGIN, 18:00, 10, ALL 
     END, 23:59, 10, ALL 
     !FRI 
     BEGIN, 00:00, 10, ALL 
     END, 06:00, 10, B00I00 
     END, 06:30, 10, B00I01 
     BEGIN, 17:30, 10, B00I01 
     BEGIN, 18:00, 10, B00I00 
     END, 23:59, 10, ALL 
     !SAT 
     BEGIN, 00:00, 10, ALL 
     END, 23:59, 10, ALL 


*  *  *  *  *  *  *  * Using the PMSCHED.NLM Utility *  *  *  *  *  *  *  *

You must load the PMSCHED.NLM utility to activate power management for 
devices controlled by the SDMSNETx.DSK driver.

The syntax for the line that loads the PMMAKE utility is: 

     load PMSCHED [<schedule file>] 

where 

<schedule file> is the name of the power management configuration file to 
use. If no file is specified, PMSCHED looks for SYS:\PM\PM.CFG. If PM.CFG is 
not found, PMSCHED loads for manual operation of power management.


*   *   * Manual Operation *   *   *

In manual operation, power management is initially off on all devices, and 
gather / displaying of device statistics is on. PMSCHED.NLM allows manual 
enabling and disabling of power management on individual drives. You can also 
enable and disable statistics gathering, and clear statistics.

To toggle power management on and off for a device, highlight the device 
under PMSCHED.NLM and press the F3 key. A menu appears with these selections: 

     1. Toggle Power Management

     2. Toggle Statistics

     3. Reset Statistics

Highlight Toggle Power Management and press Enter. Toggling Power Management 
has no effect on the device statistics.


*   *   * Scheduled Operation *   *   *

Automatic scheduling of power management cycles is possible only when PMSCHED 
remains loaded. For scheduled operation, PMSCHED.NLM requires either:

the file SYS:\PM\PM.CFG, created by PMMAKE.NLM, 

or 

the name of the schedule file, created by PMMAKE.NLM, loaded with PMSCHED as 
a command line parameter.


*   *   * Unloading the PMSCHED.NLM Utility *   *   *

Unloading PMSCHED.NLM does not turn power management off. The state of power 
management on each device is maintained until the server is downed or 
PMSCHED.NLM is reloaded.


*   *   * Device Statistics *   *   *

Device statistics are gathered on all devices registered by SDMSNETx.DSK with 
the NetWare operating system. These statistics record the number of reads and 
writes performed on a device and, if the device is power manageable by the 
SDMS driver, the number of times the device is spun up and spun down. 
Statistics are viewed, toggled on and off, or reset from the power management 
utility PMSCHED.NLM.
