1.2 Building Log Files

Follow these steps to build a log file:

  1. Call NWSMGetFirstName, NWSMGetNextName, NWSMGetDataSetName, and NWSMGetOneName to get a name from the skipped data sets list.

  2. Set createSkippedDataSetsFile of NWSM_SCAN_CONTROL to TRUE to direct the TSA to build the skipped data sets log file.

1.2.1 Reading Log Files

To read built log files, follow these steps:

  1. Call NWSMTSScanDataSetBegin and pass ERROR LOG or SKIPPED DATA SETS to resourceName to receive the name of the log file contained in dataSetNames.

  2. Call NWSMTSOpenDataSetForBackup to open the log file and receive a data set handle.

  3. Call NWSMTSReadDataSet to read the contents of the log file.

  4. Call NWSMTSCloseDataSet to close the file.

  5. Call NWSMTSScanDataSetEnd to end the read file session.

    WARNING:Do not send the data from the error or the skipped data sets log to NWSMTSWriteDataSet because scanInformation and dataSetNames will not contain valid SIDF information and the system might abend.

1.2.2 Engine Log File

  1. Call NWSMTSScanDataSetBegin and NWSMTSScanNextDataSet.

  2. Build a log file or database of the data sets that were backed up from the returned information.