com.isti.jevalresp
Class RespNetProc

java.lang.Object
  extended by com.isti.jevalresp.RespProcessor
      extended by com.isti.jevalresp.RespNetProc

public class RespNetProc
extends RespProcessor

Class RespNetProc is an extension of high-level processing functions for 'JEvalResp' that adds methods for finding and processing responses via FISSURES interface.


Field Summary
static java.lang.String DEF_NETDC_OBJNMSTR
          Default Network DataCenter object name ("IRIS_NetworkDC").
static java.lang.String DEF_NETDC_PATHSTR
          Default Network DataCenter path ("edu/iris/dmc").
static java.lang.String DEF_NETFNDR_NAMESTR
          Default Network Finder name ("IRIS_NetworkFinder").
static java.lang.String NAME_SERVICE_KEY
          Property name for Name Service ("ooc.orb.service.NameService").
static java.lang.String NET_DC_PATHNAMEKEY
          Property name for Network DataCenter ("fissures.networkDCname").
static java.lang.String NET_FINDER_NAMEKEY
          Property name for Network Finder ("fissures.networkfindername").
 
Fields inherited from class com.isti.jevalresp.RespProcessor
errorMessage, headerFlag, LINE_SEP_STR, multiOutputFlag, numberErrors, numRespFound, outputDirectory, outputFileNamesCount, outputFileNamesStr, RESP_FILE_PREFIX
 
Constructor Summary
RespNetProc(java.util.Properties propsObj, boolean multiOutputFlag, boolean headerFlag, boolean debugFlag, java.io.File outputDirectory)
          Constructs object and initializes CORBA ORB used for finding and processing responses via FISSURES interface.
 
Method Summary
 void destroyORB()
          Frees the resources associated with the CORBA ORB.
 boolean findAndOutputNetResponses(java.lang.String[] staArr, java.lang.String[] chaArr, java.lang.String[] netArr, java.lang.String[] siteArr, java.util.Date beginDateObj, java.util.Date endDateObj, int outUnitsConvIdx, double[] freqArr, boolean logSpacingFlag, boolean verboseFlag, int startStageNum, int stopStageNum, boolean useDelayFlag, boolean showInputFlag, boolean listInterpOutFlag, boolean listInterpInFlag, double listInterpTension, boolean unwrapPhaseFlag, boolean totalSensitFlag, double b62XValue, int respTypeIndex, boolean stdioFlag)
          Finds responses (via FISSURES interface) with matching channel IDs, then processes them and writes their output.
 boolean findAndOutputNetResponses(java.lang.String[] staArr, java.lang.String[] chaArr, java.lang.String[] netArr, java.lang.String[] siteArr, java.util.Date beginDateObj, java.util.Date endDateObj, int outUnitsConvIdx, double[] freqArr, boolean logSpacingFlag, boolean verboseFlag, int startStageNum, int stopStageNum, boolean useDelayFlag, boolean showInputFlag, boolean listInterpOutFlag, boolean listInterpInFlag, double listInterpTension, boolean unwrapPhaseFlag, boolean totalSensitFlag, int respTypeIndex, boolean stdioFlag)
          Finds responses (via FISSURES interface) with matching channel IDs, then processes them and writes their output.
 boolean findAndOutputNetResponses(java.lang.String[] staArr, java.lang.String[] chaArr, java.lang.String[] netArr, java.lang.String[] siteArr, java.util.Date beginDateObj, java.util.Date endDateObj, int outUnitsConvIdx, double[] freqArr, boolean logSpacingFlag, boolean verboseFlag, int startStageNum, int stopStageNum, boolean useDelayFlag, boolean showInputFlag, boolean listInterpOutFlag, boolean listInterpInFlag, double listInterpTension, int respTypeIndex, boolean stdioFlag)
          Finds responses (via FISSURES interface) with matching channel IDs, then processes them and writes their output.
 boolean findAndOutputNetResponses(java.lang.String[] staArr, java.lang.String[] chaArr, java.lang.String[] netArr, java.lang.String[] siteArr, java.util.Date beginDateObj, java.util.Date endDateObj, int outUnitsConvIdx, double[] freqArr, boolean logSpacingFlag, boolean verboseFlag, int startStageNum, int stopStageNum, boolean useDelayFlag, boolean showInputFlag, int respTypeIndex, boolean stdioFlag)
          Finds responses (via FISSURES interface) with matching channel IDs, then processes them and writes their output.
 boolean findAndOutputNetResponses(java.lang.String[] staArr, java.lang.String[] chaArr, java.lang.String[] netArr, java.lang.String[] siteArr, java.util.Date beginDateObj, java.util.Date endDateObj, int outUnitsConvIdx, double[] freqArr, boolean logSpacingFlag, boolean verboseFlag, int startStageNum, int stopStageNum, int respTypeIndex, boolean stdioFlag)
          Finds responses (via FISSURES interface) with matching channel IDs, then processes them and writes their output.
 boolean findNetResponses(java.lang.String[] staArr, java.lang.String[] chaArr, java.lang.String[] netArr, java.lang.String[] siteArr, java.util.Date beginDateObj, java.util.Date endDateObj, boolean verboseFlag, RespCallback respCallbackObj)
          Finds responses (via FISSURES interface) with matching channel IDs.
 boolean findNetResponses(java.lang.String staListStr, java.lang.String chaListStr, java.lang.String netListStr, java.lang.String siteListStr, java.util.Date beginDateObj, java.util.Date endDateObj, boolean verboseFlag, RespCallback respCallbackObj)
          Finds responses (via FISSURES interface) with matching channel IDs.
 edu.iris.Fissures.IfNetwork.NetworkAccess[] findNetworks(java.lang.String[] netArr, java.util.Date beginDateObj, java.util.Date endDateObj, boolean verboseFlag)
          Queries server for matching 'NetworkAccess' objects.
 boolean procNetResponses(edu.iris.Fissures.IfNetwork.NetworkAccess[] netAccArr, java.lang.String[] staArr, java.lang.String[] chaArr, java.lang.String[] siteArr, java.util.Date beginDateObj, java.util.Date endDateObj, boolean verboseFlag, RespCallback respCallbackObj)
          Queries server for responses that match-up to the given names, and then processes the responses.
 boolean resolveNameService()
          Resolves the initial "NameService" reference.
 boolean resolveNetworkFinder()
          Resolves the reference to the FISSURES 'NetworkFinder' object.
 
Methods inherited from class com.isti.jevalresp.RespProcessor
clearErrorMessage, doReadResponses, findAndOutputResponses, findAndOutputResponses, findAndOutputResponses, findAndOutputResponses, findAndOutputResponses, findResponses, findResponses, getErrorFlag, getErrorMessage, getNumberErrors, getNumRespFound, getOutputFileNamesCount, getOutputFileNamesStr, outputData, outputData, processResponse, processResponse, processResponse, processResponse, setErrorMessage
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

NET_DC_PATHNAMEKEY

public static final java.lang.String NET_DC_PATHNAMEKEY
Property name for Network DataCenter ("fissures.networkDCname").

See Also:
Constant Field Values

NET_FINDER_NAMEKEY

public static final java.lang.String NET_FINDER_NAMEKEY
Property name for Network Finder ("fissures.networkfindername").

See Also:
Constant Field Values

DEF_NETDC_PATHSTR

public static final java.lang.String DEF_NETDC_PATHSTR
Default Network DataCenter path ("edu/iris/dmc").

See Also:
Constant Field Values

DEF_NETDC_OBJNMSTR

public static final java.lang.String DEF_NETDC_OBJNMSTR
Default Network DataCenter object name ("IRIS_NetworkDC").

See Also:
Constant Field Values

DEF_NETFNDR_NAMESTR

public static final java.lang.String DEF_NETFNDR_NAMESTR
Default Network Finder name ("IRIS_NetworkFinder").

See Also:
Constant Field Values

NAME_SERVICE_KEY

public static final java.lang.String NAME_SERVICE_KEY
Property name for Name Service ("ooc.orb.service.NameService").

See Also:
Constant Field Values
Constructor Detail

RespNetProc

public RespNetProc(java.util.Properties propsObj,
                   boolean multiOutputFlag,
                   boolean headerFlag,
                   boolean debugFlag,
                   java.io.File outputDirectory)
Constructs object and initializes CORBA ORB used for finding and processing responses via FISSURES interface. If error then the 'getErrorFlag()' method will return true and the 'getErrorMessage()' method will return the description.

Parameters:
propsObj - a 'Properties' objects holding the properties to be used to initialize the CORBA ORB and find services.
multiOutputFlag - true to allow multiple response outputs with the same "net.sta.loc.cha" code.
headerFlag - true to enable header information in the output file; false for no header information.
debugFlag - true to send debug messages to 'stderr'.
outputDirectory - output directory.
Method Detail

destroyORB

public void destroyORB()
Frees the resources associated with the CORBA ORB.


resolveNameService

public boolean resolveNameService()
Resolves the initial "NameService" reference. The "nameContextObj" field is set to the associated 'NamingContextExt' object.

Returns:
true if sucessful, false if error (in which case 'getErrorMessage()' may be used to see information about the error).

resolveNetworkFinder

public boolean resolveNetworkFinder()
Resolves the reference to the FISSURES 'NetworkFinder' object. The "networkFinderObj" handle is set to the object.

Returns:
true if sucessful, false if error (in which case 'getErrorMessage()' may be used to see information about the error).

findAndOutputNetResponses

public boolean findAndOutputNetResponses(java.lang.String[] staArr,
                                         java.lang.String[] chaArr,
                                         java.lang.String[] netArr,
                                         java.lang.String[] siteArr,
                                         java.util.Date beginDateObj,
                                         java.util.Date endDateObj,
                                         int outUnitsConvIdx,
                                         double[] freqArr,
                                         boolean logSpacingFlag,
                                         boolean verboseFlag,
                                         int startStageNum,
                                         int stopStageNum,
                                         boolean useDelayFlag,
                                         boolean showInputFlag,
                                         boolean listInterpOutFlag,
                                         boolean listInterpInFlag,
                                         double listInterpTension,
                                         boolean unwrapPhaseFlag,
                                         boolean totalSensitFlag,
                                         double b62XValue,
                                         int respTypeIndex,
                                         boolean stdioFlag)
Finds responses (via FISSURES interface) with matching channel IDs, then processes them and writes their output. This is a convenience method that may be used to add a different "front-end" to the program.

Parameters:
staArr - an array of station name patterns to search for, or a null or empty array to accept all station names.
chaArr - an array of channel name patterns to search for, or a null or empty array to accept all channel names.
netArr - an array of network name patterns to search for, or a null or empty array to accept all network names.
siteArr - an array of site name patterns to search for, or a null or empty array to accept all site names.
beginDateObj - the beginning of a date range to search for, or null for no begin date. If no end-date is given then this becomes a single date that must be within the date-range of matched responses.
endDateObj - the end of a date range to search for, or null for no end date.
outUnitsConvIdx - output units conversion index for the requested output units type; one of the '..._UNIT_CONV' values.
freqArr - an array of frequency values to use.
logSpacingFlag - true to indicate that the frequency spacing is logarithmic; false to indicate linear spacing.
verboseFlag - true for verbose output messages.
startStageNum - if greater than zero then the start of the range of stage sequence numbers to use, otherwise all stages are used.
stopStageNum - if greater than zero then the end of the range of stage sequence numbers to use, otherwise only the single stage specified by 'startStageNum' is used.
useDelayFlag - true to use estimated delay in phase calculation.
showInputFlag - true to show RESP input text (sent to stdout).
listInterpOutFlag - true to interpolate amp/phase output from responses containing List blockettes.
listInterpInFlag - true to interpolate amp/phase input from List blockettes in responses (before output is calculated).
listInterpTension - tension value for List-blockette interpolation algorithm.
unwrapPhaseFlag - true to unwrap phase output values.
totalSensitFlag - true to use stage 0 (total) sensitivity; false to use computed sensitivity.
b62XValue - sample value for polynomial blockette (62).
respTypeIndex - index value indicating type of output (separate amp/phase file, complex-spectra file or single amp/phase file).
stdioFlag - true for output to 'stdout', false for output to file(s).
Returns:
true if successful; false if error (in which case an error message will be sent to 'stderr').

findAndOutputNetResponses

public boolean findAndOutputNetResponses(java.lang.String[] staArr,
                                         java.lang.String[] chaArr,
                                         java.lang.String[] netArr,
                                         java.lang.String[] siteArr,
                                         java.util.Date beginDateObj,
                                         java.util.Date endDateObj,
                                         int outUnitsConvIdx,
                                         double[] freqArr,
                                         boolean logSpacingFlag,
                                         boolean verboseFlag,
                                         int startStageNum,
                                         int stopStageNum,
                                         boolean useDelayFlag,
                                         boolean showInputFlag,
                                         boolean listInterpOutFlag,
                                         boolean listInterpInFlag,
                                         double listInterpTension,
                                         boolean unwrapPhaseFlag,
                                         boolean totalSensitFlag,
                                         int respTypeIndex,
                                         boolean stdioFlag)
Finds responses (via FISSURES interface) with matching channel IDs, then processes them and writes their output. This is a convenience method that may be used to add a different "front-end" to the program.

Parameters:
staArr - an array of station name patterns to search for, or a null or empty array to accept all station names.
chaArr - an array of channel name patterns to search for, or a null or empty array to accept all channel names.
netArr - an array of network name patterns to search for, or a null or empty array to accept all network names.
siteArr - an array of site name patterns to search for, or a null or empty array to accept all site names.
beginDateObj - the beginning of a date range to search for, or null for no begin date. If no end-date is given then this becomes a single date that must be within the date-range of matched responses.
endDateObj - the end of a date range to search for, or null for no end date.
outUnitsConvIdx - output units conversion index for the requested output units type; one of the '..._UNIT_CONV' values.
freqArr - an array of frequency values to use.
logSpacingFlag - true to indicate that the frequency spacing is logarithmic; false to indicate linear spacing.
verboseFlag - true for verbose output messages.
startStageNum - if greater than zero then the start of the range of stage sequence numbers to use, otherwise all stages are used.
stopStageNum - if greater than zero then the end of the range of stage sequence numbers to use, otherwise only the single stage specified by 'startStageNum' is used.
useDelayFlag - true to use estimated delay in phase calculation.
showInputFlag - true to show RESP input text (sent to stdout).
listInterpOutFlag - true to interpolate amp/phase output from responses containing List blockettes.
listInterpInFlag - true to interpolate amp/phase input from List blockettes in responses (before output is calculated).
listInterpTension - tension value for List-blockette interpolation algorithm.
unwrapPhaseFlag - true to unwrap phase output values.
totalSensitFlag - true to use stage 0 (total) sensitivity; false to use computed sensitivity.
respTypeIndex - index value indicating type of output (separate amp/phase file, complex-spectra file or single amp/phase file).
stdioFlag - true for output to 'stdout', false for output to file(s).
Returns:
true if successful; false if error (in which case an error message will be sent to 'stderr').

findAndOutputNetResponses

public boolean findAndOutputNetResponses(java.lang.String[] staArr,
                                         java.lang.String[] chaArr,
                                         java.lang.String[] netArr,
                                         java.lang.String[] siteArr,
                                         java.util.Date beginDateObj,
                                         java.util.Date endDateObj,
                                         int outUnitsConvIdx,
                                         double[] freqArr,
                                         boolean logSpacingFlag,
                                         boolean verboseFlag,
                                         int startStageNum,
                                         int stopStageNum,
                                         boolean useDelayFlag,
                                         boolean showInputFlag,
                                         boolean listInterpOutFlag,
                                         boolean listInterpInFlag,
                                         double listInterpTension,
                                         int respTypeIndex,
                                         boolean stdioFlag)
Finds responses (via FISSURES interface) with matching channel IDs, then processes them and writes their output. This is a convenience method that may be used to add a different "front-end" to the program.

Parameters:
staArr - an array of station name patterns to search for, or a null or empty array to accept all station names.
chaArr - an array of channel name patterns to search for, or a null or empty array to accept all channel names.
netArr - an array of network name patterns to search for, or a null or empty array to accept all network names.
siteArr - an array of site name patterns to search for, or a null or empty array to accept all site names.
beginDateObj - the beginning of a date range to search for, or null for no begin date. If no end-date is given then this becomes a single date that must be within the date-range of matched responses.
endDateObj - the end of a date range to search for, or null for no end date.
outUnitsConvIdx - output units conversion index for the requested output units type; one of the '..._UNIT_CONV' values.
freqArr - an array of frequency values to use.
logSpacingFlag - true to indicate that the frequency spacing is logarithmic; false to indicate linear spacing.
verboseFlag - true for verbose output messages.
startStageNum - if greater than zero then the start of the range of stage sequence numbers to use, otherwise all stages are used.
stopStageNum - if greater than zero then the end of the range of stage sequence numbers to use, otherwise only the single stage specified by 'startStageNum' is used.
useDelayFlag - true to use estimated delay in phase calculation.
showInputFlag - true to show RESP input text (sent to stdout).
listInterpOutFlag - true to interpolate amp/phase output from responses containing List blockettes.
listInterpInFlag - true to interpolate amp/phase input from List blockettes in responses (before output is calculated).
listInterpTension - tension value for List-blockette interpolation algorithm.
respTypeIndex - index value indicating type of output (separate amp/phase file, complex-spectra file or single amp/phase file).
stdioFlag - true for output to 'stdout', false for output to file(s).
Returns:
true if successful; false if error (in which case an error message will be sent to 'stderr').

findAndOutputNetResponses

public boolean findAndOutputNetResponses(java.lang.String[] staArr,
                                         java.lang.String[] chaArr,
                                         java.lang.String[] netArr,
                                         java.lang.String[] siteArr,
                                         java.util.Date beginDateObj,
                                         java.util.Date endDateObj,
                                         int outUnitsConvIdx,
                                         double[] freqArr,
                                         boolean logSpacingFlag,
                                         boolean verboseFlag,
                                         int startStageNum,
                                         int stopStageNum,
                                         boolean useDelayFlag,
                                         boolean showInputFlag,
                                         int respTypeIndex,
                                         boolean stdioFlag)
Finds responses (via FISSURES interface) with matching channel IDs, then processes them and writes their output. This is a convenience method that may be used to add a different "front-end" to the program.

Parameters:
staArr - an array of station name patterns to search for, or a null or empty array to accept all station names.
chaArr - an array of channel name patterns to search for, or a null or empty array to accept all channel names.
netArr - an array of network name patterns to search for, or a null or empty array to accept all network names.
siteArr - an array of site name patterns to search for, or a null or empty array to accept all site names.
beginDateObj - the beginning of a date range to search for, or null for no begin date. If no end-date is given then this becomes a single date that must be within the date-range of matched responses.
endDateObj - the end of a date range to search for, or null for no end date.
outUnitsConvIdx - output units conversion index for the requested output units type; one of the '..._UNIT_CONV' values.
freqArr - an array of frequency values to use.
logSpacingFlag - true to indicate that the frequency spacing is logarithmic; false to indicate linear spacing.
verboseFlag - true for verbose output messages.
startStageNum - if greater than zero then the start of the range of stage sequence numbers to use, otherwise all stages are used.
stopStageNum - if greater than zero then the end of the range of stage sequence numbers to use, otherwise only the single stage specified by 'startStageNum' is used.
useDelayFlag - true to use estimated delay in phase calculation.
showInputFlag - true to show RESP input text (sent to stdout).
respTypeIndex - index value indicating type of output (separate amp/phase file, complex-spectra file or single amp/phase file).
stdioFlag - true for output to 'stdout', false for output to file(s).
Returns:
true if successful; false if error (in which case an error message will be sent to 'stderr').

findAndOutputNetResponses

public boolean findAndOutputNetResponses(java.lang.String[] staArr,
                                         java.lang.String[] chaArr,
                                         java.lang.String[] netArr,
                                         java.lang.String[] siteArr,
                                         java.util.Date beginDateObj,
                                         java.util.Date endDateObj,
                                         int outUnitsConvIdx,
                                         double[] freqArr,
                                         boolean logSpacingFlag,
                                         boolean verboseFlag,
                                         int startStageNum,
                                         int stopStageNum,
                                         int respTypeIndex,
                                         boolean stdioFlag)
Finds responses (via FISSURES interface) with matching channel IDs, then processes them and writes their output. This is a convenience method that may be used to add a different "front-end" to the program.

Parameters:
staArr - an array of station name patterns to search for, or a null or empty array to accept all station names.
chaArr - an array of channel name patterns to search for, or a null or empty array to accept all channel names.
netArr - an array of network name patterns to search for, or a null or empty array to accept all network names.
siteArr - an array of site name patterns to search for, or a null or empty array to accept all site names.
beginDateObj - the beginning of a date range to search for, or null for no begin date. If no end-date is given then this becomes a single date that must be within the date-range of matched responses.
endDateObj - the end of a date range to search for, or null for no end date.
outUnitsConvIdx - output units conversion index for the requested output units type; one of the '..._UNIT_CONV' values.
freqArr - an array of frequency values to use.
logSpacingFlag - true to indicate that the frequency spacing is logarithmic; false to indicate linear spacing.
verboseFlag - true for verbose output messages.
startStageNum - if greater than zero then the start of the range of stage sequence numbers to use, otherwise all stages are used.
stopStageNum - if greater than zero then the end of the range of stage sequence numbers to use, otherwise only the single stage specified by 'startStageNum' is used.
respTypeIndex - index value indicating type of output (separate amp/phase file, complex-spectra file or single amp/phase file).
stdioFlag - true for output to 'stdout', false for output to file(s).
Returns:
true if successful; false if error (in which case an error message will be sent to 'stderr').

findNetResponses

public boolean findNetResponses(java.lang.String[] staArr,
                                java.lang.String[] chaArr,
                                java.lang.String[] netArr,
                                java.lang.String[] siteArr,
                                java.util.Date beginDateObj,
                                java.util.Date endDateObj,
                                boolean verboseFlag,
                                RespCallback respCallbackObj)
Finds responses (via FISSURES interface) with matching channel IDs. Each found channel ID and response is reported via the "RespCallback.responseInfo()' method.

Parameters:
staArr - an array of station name patterns to search for, or a null or empty array to accept all station names.
chaArr - an array of channel name patterns to search for, or a null or empty array to accept all channel names.
netArr - an array of network name patterns to search for, or a null or empty array to accept all network names.
siteArr - an array of site name patterns to search for, or a null or empty array to accept all site names.
beginDateObj - the beginning of a date range to search for, or null for no begin date. If no end-date is given then this becomes a single date that must be within the date-range of matched responses.
endDateObj - the end of a date range to search for, or null for no end date.
verboseFlag - true for verbose output messages.
respCallbackObj - a 'RespCallback' object whose 'responseInfo()' method will be called to report on each response found.
Returns:
true if successful; false if error (in which case 'getErrorMessage()' may be used to see information about the error).

findNetResponses

public boolean findNetResponses(java.lang.String staListStr,
                                java.lang.String chaListStr,
                                java.lang.String netListStr,
                                java.lang.String siteListStr,
                                java.util.Date beginDateObj,
                                java.util.Date endDateObj,
                                boolean verboseFlag,
                                RespCallback respCallbackObj)
Finds responses (via FISSURES interface) with matching channel IDs. Each found channel ID and response is reported via the "RespCallback.responseInfo()' method.

Parameters:
staListStr - a list of station name patterns to search for, or a null or empty string to accept all station names.
chaListStr - a list of channel name patterns to search for, or a null or empty string to accept all channel names.
netListStr - a list of network name patterns to search for, or a null or empty string to accept all network names.
siteListStr - a list of site name patterns to search for, or a null or empty string to accept all site names.
beginDateObj - the beginning of a date range to search for, or null for no begin date. If no end-date is given then this becomes a single date that must be within the date-range of matched responses.
endDateObj - the end of a date range to search for, or null for no end date.
verboseFlag - true for verbose output messages.
respCallbackObj - a 'RespCallback' object whose 'responseInfo()' method will be called to report on each response found.
Returns:
true if successful; false if error (in which case 'getErrorMessage()' may be used to see information about the error).

findNetworks

public edu.iris.Fissures.IfNetwork.NetworkAccess[] findNetworks(java.lang.String[] netArr,
                                                                java.util.Date beginDateObj,
                                                                java.util.Date endDateObj,
                                                                boolean verboseFlag)
Queries server for matching 'NetworkAccess' objects. Each network name is tried with 'NetworkFinder.retrieve_by_code()'; if no matches and the network name contains wildcard characters then all network objects are fetched (via 'NetworkFinder.retrieve_all()') and compared.

Parameters:
netArr - an array of network names to search for.
beginDateObj - the beginning of a date range to search for, or null for no begin date. If no end-date is given then this becomes a single date that must be within the date-range of matched networks.
endDateObj - the end of a date range to search for, or null for no end date. date range for the network (or null for all dates).
verboseFlag - if true then status messages are sent to 'stderr'.
Returns:
An array of 'NetworkAccess' objects, or null if an error occurred (in which case 'getErrorMessage()' may be used to see information about the error).

procNetResponses

public boolean procNetResponses(edu.iris.Fissures.IfNetwork.NetworkAccess[] netAccArr,
                                java.lang.String[] staArr,
                                java.lang.String[] chaArr,
                                java.lang.String[] siteArr,
                                java.util.Date beginDateObj,
                                java.util.Date endDateObj,
                                boolean verboseFlag,
                                RespCallback respCallbackObj)
Queries server for responses that match-up to the given names, and then processes the responses. For each network that was found via 'findNetworks()', each set of names is first tried with 'NetworkAccess.retrieve_channels_by_code()'; if no matches and any of the names are empty or contain wildcard characters then all the channel-ID objects for the network are fetched (via 'NetworkAccess.retrieve_all_channels()') and compared.

Parameters:
netAccArr - an array of 'NetworkAccess' objects found via 'findNetworks()'.
staArr - an array of station name patterns to search for, or a null or empty array to accept all station names.
chaArr - an array of channel name patterns to search for, or a null or empty array to accept all channel names.
siteArr - an array of site name patterns to search for, or a null or empty array to accept all site names.
beginDateObj - the beginning of a date range to search for, or null for no begin date. If no end-date is given then this becomes a single date that must be within the date-range of matched responses.
endDateObj - the end of a date range to search for, or null for no end date.
verboseFlag - if true then status messages are sent to 'stderr'.
respCallbackObj - a 'RespCallback' object whose 'responseInfo()' method will be called to report on each response found.
Returns:
true if successful, false if an error occurred (in which case 'getErrorMessage()' may be used to see information about the error).