NWSMTSConfigureTargetService

Configures the target service for a variety of tasks.

Syntax

  #include <smstsapi.h>
  
  CCODE NWSMTSConfigureTargetService (
     UINT32    connection
     UINT32    actionFlag,
     void     *actionData)

Parameters

connection

(IN) Specifies the connection information returned by NWSMTSConnectToTargetService or NWSMTSConnectToTargetServiceEx.

actionFlag

(IN) Specifies the appropriate action to be taken.

actionData

(IN) Specifies the data relevant to the actionFlag.

Return Values

The following table lists the return values associated with the function.

0x00000000

Successful

0xFFFDFFB9

NWSMTS_UNSUPPORTED_FUNCTION

0xFFFDFFE7

NWSMTS_INVALID_CONNECTION_HANDL

0xFFFEFFFF

NWSMDR_INVALID_CONNECTION

0xFFFDFFAD

NWSMTS_UNSUPPORTED_OPTION

Remarks

The following table describes the action flags and the associated action data.

Action Flag

Description

Data Type

Action Data

Supported By

NWSM_FLUSH_LOGFILES

Deletes the contents of the skipped data sets and error log files

UINT32 *

Set the value of the unsigned integer to 1.

TSAFS

NWSM_CONFIGURE_SKIPPED_LOG

By default, skipped data sets log file is created in the directory, sys:\system\tsa for NetWare and /var/opt/novell/sms for Linux .

You can override it by supplying the name along with the full path. The file is automatically deleted when NWSMTSReleaseTargetService is called.

STRING

Set the value of the string to the full path name of the file.

TSAFS

NWSM_CONFIGURE_ERROR_ LOG

By default, error log file is created in the directory, sys:\system\tsa for NetWare and /var/opt/novell/sms for Linux .

You can override this by supplying the full path of the file name. The file is automatically deleted when NWSMTSReleaseTargetService is called.

STRING

Set the value of the string to the full path name of the file.

TSAFS

NWSM_DONOT_IGNORE_ BACKUP_BIT

Does not ignore the zATTR_DONT_BACKUP attribute of NSS file system and considers a primary resource for backup only if this attribute is not set. By default, the zATTR_DONT_BACKUP attribute is ignored and all resources are considered as eligible for backup.

UINT32 *

Set the value of the unsigned integer to 1.

TSAFS

NWSM_USE_CACHING_MODE

Sets the TSAFS caching mode. TSAFS will operate on caching mode if this is set to true and operate on serial mode if is false. By default, caching mode is enabled.

UINT32 *

Set the value of the unsigned integer to 1 or 0.

TSAFS

NOTE:This symbol is not present in the SMS import file, as all versions of SMS do not export this symbol. To use this function, programmatically import the symbol and invoke it.

See Also

NWSMTSConnectToTargetService, NWSMTSConnectToTargetServiceEx, Log Files

Example

  #include <smstsapi.h>
  #include <smsdrapi.h>
  
  UINT32 connection;
  
  STRING tsaName;
  
  /* connection related code goes here*/
  
  /* After the connection:
   * if it is a file system TSA, 
   * 1. set the NWSM_DONOT_IGNORE_BACKUP_BIT for this connection
   * 2. rename skipped log file to BIGVOL:SKIPDATA.LOG */
  
  if(strstr(tsaName, "NetWare File System") || strstr(tsaName, "NetWare Cluster File System"))
  
  {
  
          UINT32 doNotBackupBit;
  
          doNotBackupBit = 1;          
    cCode = NWSMTSConfigureTargetService (connection, NWSM_DONOT_IGNORE_BACKUP_BIT, &doNotBackupBit );
  
    if (cCode)
  
          {
  
                      //do error handling
  
          }
  
        cCode = NWSMTSConfigureTargetService (connection, NWSM_CONFIGURE_SKIPPED_LOG, 
  
        "BIGVOL:SKIPDATA.LOG");
  
          if (cCode)
  
          {
  
                      //do error handling
  
          }
  
  }