9.3 Target Service Return Values

This section lists the return values returned by the TSAPI and SMDR, and TSANDS return values that directly map to the NDS return values, see TSANDS Return Values.

9.3.1 TSAPI and SMDR Return Values

The following table lists completion codes for the TS API and SMDR. (completion codes beginning with 0xFFFD, 0xFFFE, and 0xFFFF).

Value

Error String

Description

0xFFFDFFAC

NWSMTS_OUT_OF_QUOTA_SPACE

A file or directory cannot be restored. The user or directory quota limit is exceeded.

0xFFFDFFAD

NWSMTS_UNSUPPORTED_OPTION

One of the selected options is not supported by the target service

0xFFFDFFAE

NWSMTS_CLUSTER_TARGET_HAS_NO_VOLUMES

The cluster pool does not contain any resources

0xFFFDFFAF

NWSMTS_CLUSTER_TARGET_DOES_NOT_EXIST

Cluster target does not exist

0xFFFDFFB0

NWSMTS_INVALID_MESSAGE_NUMBER

Message number is invalid

0xFFFDFFB1

NWSMTS_INTERNAL_ERROR

An internal TSA error occurred, see the error log for more details

0xFFFDFFB2

NWSMTS_COMPRESSION_CONFLICT

Attempted to put compressed data on a noncompressed resource

0xFFFDFFB3

NWSMTS_MAX_CONNECTIONS

All available connections to the TSA are in use

0xFFFDFFB4

NWSMTS_REDIRECT_TRANSPORT

Indicates reconnection requirement

0xFFFDFFB5

NWSMTS_WRITE_ERROR

An error occurred while writing to a file

0xFFFDFFB6

NWSMTS_WRITE_ERROR_SHORT

An error occurred while writing to a file. Could not write all of the data of current request

0xFFFDFFB7

NWSMTS_WRITE_EA_ERR

Unable to write the extended attribute information

0xFFFDFFB8

NWSMTS_VALID_PARENT_HANDLE

A valid parent handle was created

0xFFFDFFB9

NWSMTS_UNSUPPORTED_FUNCTION

The requested function is not supported by this TSA

0xFFFDFFBA

NWSMTS_TSA_NOT_FOUND

Invalid or inactive TSA specified

0xFFFDFFBB

NWSMTS_TRANSPORT_PACKET_SIZE_ER

The read/write request exceeds 128K

0xFFFDFFBC

NWSMTS_TRANSPORT_FAILURE

The transport mechanism failed

0xFFFDFFBD

NWSMTS_SET_FILE_INFO_ERR

Unable to set file information

0xFFFDFFBE

NWSMTS_SELECTION_TYPE_NOT_USED

Selection type is not used

0xFFFDFFBF

NWSMTS_SCAN_TYPE_NOT_USED

Scan type is not used

0xFFFDFFC0

NWSMTS_SCAN_TRUSTEE_ERR

Unable to scan for the trustees information. Running DSRepair may resolve the issue

0xFFFDFFC1

NWSMTS_SCAN_NAME_SPACE_ERR

Unable to scan name-space specific information

0xFFFDFFC2

NWSMTS_SCAN_IN_PROGRESS

Cannot alter the resource list while a scans is in progress

0xFFFDFFC4

NWSMTS_SCAN_ERROR

The scan failed; the probable cause is an invalid path

0xFFFDFFC3

NWSMTS_SCAN_FILE_ENTRY_ERR

Unable to scan file entry information

0xFFFDFFC5

NWSMTS_RESOURCE_NAME_NOT_FOUND

No resource name is found or all resource names have been found

0xFFFDFFC6

NWSMTS_READ_ERROR

Cannot read the file

0xFFFDFFC7

NWSMTS_READ_EA_ERR

Unable to read the extended attributes

0xFFFDFFC8

NWSMTS_OVERFLOW

A UINT64 value overflowed

0xFFFDFFC9

NWSMTS_OUT_OF_MEMORY

The file server is out of memory or the memory allocation failed

0xFFFDFFCA

NWSMTS_OUT_OF_DISK_SPACE

Cannot restore the data, because the target service is out of disk space

0xFFFDFFCB

NWSMTS_OPEN_MODE_TYPE_NOT_USED

The open mode option is not used

0xFFFDFFCC

NWSMTS_OPEN_ERROR

Cannot open a file

0xFFFDFFCD

NWSMTS_OPEN_DATA_STREAM_ERR

The possible instances when TSA500 can encounter this error are:

  • Returning the meta data information for the file object.
  • Returning the directory base information for a specified file path.
  • Opening a file.

In either case, the engine should continue with the next data set that it can backup.

The possible instance when TSA600 can encounter this error is from the file system open call while opening a file system object. In this case, the engine should continue with the next data set that it can backup.

0xFFFDFFCE

NWSMTS_NO_SUCH_PROPERTY

No such property.

0xFFFDFFCF

NWSMTS_NO_SEARCH_PRIVILEGES

No search privilege on the client service

0xFFFDFFD0

NWSMTS_NO_MORE_NAMES

No more entries in the list or name space does not exist

0xFFFDFFD1

NWSMTS_NO_MORE_DATA_SETS

There are no more data sets to scan

0xFFFDFFD2

NWSMTS_NO_MORE_DATA

No more data exists

0xFFFDFFD3

NWSMTS_NO_CONNECTION

The specified connection is invalid or does not exist

0xFFFDFFD4

NWSMTS_NOT_READY

The specified server is unable to service the request at this time

0xFFFDFFD5

NWSMTS_NAME_SP_PATH_NOT_UPDATED

The name space path has not been updated

0xFFFDFFD6

NWSMTS_LOGOUT_ERROR

Unable to logout

0xFFFDFFD7

NWSMTS_LOGIN_DENIED

Login denied

0xFFFDFFD8

NWSMTS_INVALID_SEQUENCE_NUMBER

The sequence number is invalid

0xFFFDFFD9

NWSMTS_INVALID_SELECTION_TYPE

Invalid selection type. The selection type was either less than zero or greater than thirty one

0xFFFDFFDA

NWSMTS_INVALID_SEL_LIST_ENTRY

An invalid selection list entry was passed

0xFFFDFFDB

NWSMTS_INVALID_SCAN_TYPE

Invalid scan type was used. The scan type was either less than zero or greater than thirty one

0xFFFDFFDC

NWSMTS_INVALID_PATH

An invalid path was used

0xFFFDFFDD

NWSMTS_INVALID_PARAMETER

One or more of the parameters are NULL or invalid

0xFFFDFFDE

NWSMTS_INVALID_OPEN_MODE_TYPE

Invalid open mode option type. The option type is less than zero or greater than 23

0xFFFDFFDF

NWSMTS_INVALID_OBJECT_ID

The object’s backed up id and name does not match the current object’s id and name

0xFFFDFFE0

NWSMTS_INVALID_NAME_SPACE_TYPE

The name space type does not exist or is invalid

0xFFFDFFE1

NWSMTS_INVALID_MESSAGE_NUMBER

The message number is invalid

0xFFFDFFE2

NWSMTS_INVALID_HANDLE

The handle is tagged invalid or is set to zero

0xFFFDFFE3

NWSMTS_INVALID_DATA_SET_TYPE

Data set type is invalid

0xFFFDFFE4

NWSMTS_INVALID_DATA_SET_NAME

The data set name is invalid

0xFFFDFFE5

NWSMTS_INVALID_DATA_SET_HANDLE

The data set handle is invalid

0xFFFDFFE6

NWSMTS_INVALID_DATA

The data set is invalid

0xFFFDFFE7

NWSMTS_INVALID_CONNECTION_HANDL

Invalid connection handle was passed

0xFFFDFFE8

NWSMTS_GET_VOL_NAME_SPACE_ERR

Unable to get the name space information that is supported by the resource

0xFFFDFFE9

NWSMTS_GET_SERVER_INFO_ERR

Unable to get the file server’s information

0xFFFDFFEA

NWSMTS_GET_NAME_SPACE_SIZE_ERR

Unable to get name space size information

0xFFFDFFEB

NWSMTS_GET_NAME_SPACE_ENTRY_ERR

Unable to get the name space entry name

0xFFFDFFEC

NWSMTS_GET_ENTRY_INDEX_ERR

Unable to get the entry index

0xFFFDFFED

NWSMTS_GET_DATA_STREAM_NAME_ERR

Unable to get the data stream’s name

0xFFFDFFEE

NWSMTS_GET_BIND_OBJ_NAME_ERR

Unable to get the name of a bindery object

0xFFFDFFEF

NWSMTS_EXPECTING_TRAILER

Received a Record or Subrecord Trailer, but could not locate the trailer field

0xFFFDFFF0

NWSMTS_EXPECTING_HEADER

Received a Record or Subrecord Header, but could not locate the header field

0xFFFDFFF1

NWSMTS_DELETE_ERR

Cannot delete a data set

0xFFFDFFF2

NWSMTS_DATA_SET_NOT_FOUND

No data set was found or the resource is not available.

0xFFFDFFF3

NWSMTS_DATA_SET_IS_OPEN

Attempted to open an already data set or attempted to alter a scan while a data set is open

0xFFFDFFF4

NWSMTS_DATA_SET_IS_OLDER

The existing data set on the target data set is newer the one on the media, the data set will not be restored

0xFFFDFFF5

NWSMTS_DATA_SET_IN_USE

Data set is currently in use and cannot be accessed

0xFFFDFFF6

NWSMTS_DATA_SET_EXECUTE_ONLY

Can only execute the file

0xFFFDFFF7

NWSMTS_DATA_SET_EXCLUDED

The data set is excluded by the selection list

0xFFFDFFF8

NWSMTS_DATA_SET_ALREADY_EXISTS

The data set name already exists

0xFFFDFFF9

NWSMTS_CREATE_ERROR

Cannot create a file

0xFFFDFFFA

NWSMTS_CREATE_DIR_ENTRY_ERR

Cannot create directory entry

0xFFFDFFFB

NWSMTS_CLOSE_BINDERY_ERROR

Cannot close the bindery

0xFFFDFFFC

NWSMTS_CANT_ALLOC_DIR_HANDLE

Cannot allocate a directory handle

0xFFFDFFFD

NWSMTS_BUFFER_UNDERFLOW

Buffer underflow, unable to get entire field

0xFFFDFFFE

NWSMTS_BINDERY_OBJECT_NAME_ERR

Unable to get bindery object name

0xFFFDFFFF

NWSMTS_ACCESS_DENIED

Invalid user name or authentication

0xFFFEFFFF

NWSMDR_INVALID_CONNECTION

Invalid connection handle was passed to the SMDR

0xFFFEFFFE

NWSMDR_INVALID_PARAMETER

One or more of the parameters is NULL or invalid

0xFFFEFFFD

NWSMDR_OUT_OF_MEMORY

SMDR memory allocation failed

0xFFFEFFFC

NWSMDR_TRANSPORT_FAILURE

The transport mechanism has failed

0xFFFEFFFB

NWSMDR_UNSUPPORTED_FUNCTION

The requested function is not supported by SMDR

0xFFFEFFFA

NWSMDR_MODULE_ALREADY_EXPORTED

The module is already exported by SMDR

0xFFFEFFF9

NWSMDR_DECRYPTION_FAILURE

The decryption mechanism of the SMDR failed

0xFFFEFFF8

NWSMDR_ENCRYPTION_FAILURE

The encryption mechanism of the SMDR failed

0xFFFEFFF7

NWSMDR_TSA_NOT_LOADED

The requested TSA is not loaded

0xFFFEFFF6

NWSMDR_NO_SUCH_SMDR

The specified SMDR does not exist

0xFFFEFFF5

NWSMDR_SMDR_CONNECT_FAILURE

SMDR connection failure. Load the SMDR on the remote server and try again

0xFFFEFFF4

NWSMDR_NO_MORE_DATA

No more data to process

0xFFFEFFF3

NWSMDR_NO_SOCKETS

No more sockets available

0xFFFEFFF2

NWSMDR_INVALID_PROTOCOL

The specified protocol does not exist

0xFFFEFFF1

NWSMDR_NO_MORE_CONNECTIONS

Unable to create another connection handle. Maximum number of connections is reached. Try to close some existing connections

0xFFFEFFF0

NWSMDR_NO_SUCH_TSA

Requested TSA does not exist

0xFFFEFFEF

NWSMDR_INVALID_MESSAGE_NUMBER

Invalid message number

0xFFFEFFE9

NWSMDR_INVALID_CONTEXT

The specified context is invalid

9.3.2 TSANDS Return Values

The TSANDS return values directly map to the NDS return values.

The following table lists the TSANDS return values.

TSANDS Hexadecimal Number

Constant

Maps to...

FFFDFEFF

NWSMTS_INSUFFICIENT_MEMORY

0xFFFF FF6A > NDS Return Values from the Operating System

FFFDFEFE

NWSMTS_REQUEST_UNKNOWN

0xFFFF FF05 > NDS Return Values from the Operating System

FFFDFEFD

NWSMTS_OF_SOME_SORT

0xFFFF FF01 > NDS Return Values from the Operating System

TSANDS return values from FFFDFEFC to FFFDFEC8 map to NDS return values: NDS Return Values > NDS Client Return Values - 0xFFFF FED3 through 0xFFFF FE9E.

TSANDS return values from FFFDFEC7 to FFFDFE1B map to NDS return values: NDS Return Values > NDS Agent return values 0xFFFF FDA7 through 0xFFFF FCFA.