Error Translation

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.