1. SCRUtilityA02.zip Driver
2. README File Contents

README Driver File Contents (SCRUtilityA02.zip)

COMMANDLINES:          

The following commands are given for the root SDK directory.  Running the program from the 
demo\DiscoverArrays directory will not work because of the the current package designation.  The 
classpath environment variable must be set as specified in the readme in the main directory as 
well in order to compile and run the programs correctly.

   Compiling
      javac demo\DiscoverArrays\DiscoverArrays.java

   Using runsample to run the program
      runsample DiscoverArrays 
      runsample DiscoverArrays <-?>

   Running the program without runsample
      java demo.DiscoverArrays.DiscoverArrays 
      java demo.DiscoverArrays.DiscoverArrays <-?>



GENERAL HELP:

DiscoverArrays will display all LSI Storage Arrays that are accessible on the network.  If
the storage array also has a UTM agent connected, the program will also display the agent as a
storage array.  When an array or agent is displayed, the program reports the name of the agent or
storage array and also displays the host name and IP Address where it may be found.  If the storage
array has multiple available IP Addresses, the program will display the storage array once for each
address.


RESTRICTIONS:


PROGRAMMING NOTES:

1>    Initialize a RPCClientBroadcast object.

2>    Set the timeout of the object using the RPCClientBroadcast.setTimeout() method.

3>    Start the broadcast with the RPCClientBroadcast.broadcast() method.  One of the parameters to
      the method include a pointer to a RPCBroadcastReplyHandler object.  The reason for this is 
      the broadcast method will call the RPCBroadcastReplyHandler.processReply() method for each 
      response that it recieves and pass the IP Address through the parameters.
      
4>    For each IP address that a response is recieved, a separate thread should be started to 
      determine whether an array exists at the address.  This allows the broadcast to continue 
      while the thread waits for a response from the address or for a time-out.  The steps for this
      are:
      
      a> Bind to the controller- 
         The ManagementPath class is used with SYMbolClient to perform this task.

      b> Set the timeout for the array.  The SYMbolAPIClientV1.setTimeout() and 
         ProcedureTimeout.getProcTimeout() methods are used in the program.
      
      c> Make a SYMbol call such as SYMbolAPIClientV1.discoverControllers() or 
         SYMbolAPIClientV1.getSAInfo().
         
      If the above steps succeed, then the address points to an array.