This appendix lists error messages you may encounter while using BusinesSuite Module for Informix and provides suggestions to resolve the problems described.
When ON-Bar encounters an error or condition requiring a warning, it writes a message to the assigned message file. The default message file for ON-Bar is /tmp/bar_act.log. Refer to Appendix A in the INFORMIX-OnLine Dynamic Server Backup and Restore Guide for a listing of ON-Bar messages.
NetWorker error messages are displayed in the nwadmin window. The Messages display lists all messages generated during the past 24 hours. Error messages are also written to /nsr/messages/daemon.log.
NetWorker error messages appear in the format
day hh:mm:ss daemon_or_program_name: message
This section lists error messages encountered during a NetWorker backup. The messages are organized alphabetically by NetWorker daemon name and program name to make them easier to match to the NetWorker message displayed.
The flag file signifying the end of the first part of index compression is already in use by another instance of the nsrck program, or by the nsrindexd daemon. Since disaster will ensue if two processes access the same index at the same time, nsrck will refuse to act on the named file.
As the program finishes, this indicates some form of checking was accomplished.
more space needed to compress clientname index, size required
The nsrck program cannot find enough disk space to hold the temporary file db.CMP. The operator should free some disk space on any local filesystem and retry the command. The df command may be used to see how much free space is available on any filesystem.
After a reboot, if index compression completed its first copy, the compression is rolled forward.
WARNING no valid savetimes - cross-check not performed for clientname
During a cross-check, no save sets were found for this client. Since this situation can occur during disaster recovery, nsrck avoids deleting the entire contents of the client index and instead does nothing.
/ path /nsrexecd: Can't make pipe/ path /nsrexecd: Can't fork fork: No more processes
The specified client-side resource has been exceeded. There are too many other services running on the client while savegrp is running. Inspect the client and determine why it has run out of resources. The client may need to be rebooted. You should also consider rescheduling any jobs automatically started on the client (for example. via cron) that run while savegrp is running.
/ path /nsrexecd: Couldn't look up address for your host/ path /nsrexecd: Host address mismatch for server
The nsrexecd daemon on the client managed to look up the server in the client's host table, but the address listed there did not match the address of the server. Every interface of the server must have a unique name listed in the host table (possibly with non-unique aliases or CNAMEs), and each unique name must be listed as a valid server to nsrexecd.
/ path /nsrexecd: Host server cannot request command execution/ path /nsrexecd: Your host cannot request command execution
The server is not listed in nsrexecd's list of valid servers on the specified client. The list of valid servers is either on the nsrexecd command line (with one or more -s server options to nsrexecd), or in a file (with the -f file option to nsrexecd). It may also be the case that the server is not listed in one or more of /etc/hosts, NIS, or DNS, depending on the client, in which case nsrexecd cannot validate the server until the client's host naming configuration is fixed.
/ path /nsrexecd: Invalid authenticator/ path /nsrexecd: Invalid command
These two messages should never occur in a savegroup completion message. They mean that savegrp did not follow its protocol correctly.
These similar messages are generated by nsrexecd and rshd, respectively. In either case, the server does not have permission to execute commands on the client. In the case of the first message, make sure that the server is listed as a valid server on the client (see “/path/nsrexecd: Host server cannot request command execution” for details). In the case of the second message, which does not mention nsrexecd, make sure that “servername” is listed in the client's /.rhosts file (or, if you have set the remote user attribute for this client, the .rhosts file in the home directory for that user on the client).
The remote user attribute for the client is not set to a valid login on the client. Verify that the remote user attribute for the client is set to the correct login name. You may see this message even when running nsrexecd if nsrexecd has not been started (or was killed) on the client.
The client does not seem to support the TCP/IP protocol stack, or has not used a privileged port for setting up its connection. The latter could occur if you use nsrexecd but did not start it as root on the specified client. The nsrexecd daemon must run as root on each client.
The advisory lock that the daemon was waiting to clear has been cleared; see “waiting for lock” message.
Another program is accessing the same file that is required by the nsrindexd daemon. The daemon will wait for the advisory lock to be cleared.
Another copy of nsrmmdbd is currently running and has exclusive access to the media database. Only one nsrmmdbd process should be running on a given machine at a time. This can happen if the previous nsrmmdbd was not properly killed off. Use nsr_shutdown or ps and kill to identify and kill off all the NetWorker daemons before restarting nsrd again.
This is an internal error; check permissions on the /nsr/tmp and /nsr/mm directories.
The daemon is dumping its records to a temporary file while the database is being backed up. The service is unavailable while the database is dumping.
The nsrmmdbd daemon is reloading its database. The service is unavailable while the data is being reloaded.
Printed each time the daemon is restarted. On start-up, the daemon sanity checks its records before providing its service.
After any of the previous messages, this message is printed to indicate that the service is once again available.
This message, generated by the save command on client, means that save is not setuid root. Make sure that the save command on the client is owned by root and has its setuid bit set. If save is on an NFS mounted filesystem, make sure the filesystem was not mounted on that client using the –nosuid option.
While backing up the specified save set, save was unable to enter the named directory. This may mean that save is not setuid root on the specified client, or that the directory is actually an NFS mount point for which root is not allowed access. Check the permissions for save on the specified client (using ls) and make sure that save is owned by root and that the setuid bit is set.
RPC error, details...Cannot open save session with ' server '
The save command generates this message if it is unable to back up data to the NetWorker server. There are several possible detailed reasons. The most likely causes are: resources are exceeded on the server so nsrd cannot accept new save sessions, nsrd actually died since savegrp started (however, this is unlikely, since you cannot normally receive a savegrp completion message after nsrd dies, but you can see this when using the -p option), there are numerous network errors occurring and save cannot open a session to save its data (check this by running netstat -s and see how many network errors are occurring; you may need to do this several times a few minutes apart to get the change in errors). Save cannot tell which of these three causes are the real cause. If you see these errors frequently, and it looks like a server resource problem, you might consider increasing the value of the “client retries” attribute of the group resource having these problems. This won't decrease the resource utilization, but will make savegrp more robust (the trade-off is that increasing client retries will increase the load on the server even more).
This error occurs when the named client has more than one name, for example, a short name, client, and a fully-qualified domain name, client.xxx.com. When the client attempts to connect back to the NetWorker server to start a save, that client is calling itself by the name client, which matches the client resource name, but when the server looks up the client's network address, it is getting back the name client.xxx.com. If this is, in fact, correct, add the name client.xxx.com to the client's aliases attribute, and rerun the save.
This message can occur if you have a directory tree that is very deep, or directory names that are very long. This message can also occur if there are bad blocks in the specified filesystem, or if the filesystem is corrupt. NetWorker limits the full pathname to 1024 characters, which is the system imposed maximum on most systems. To save such directories, you need to rename or move the directories so that the full pathname is shorter than 1024 characters. If the filesystem appears to be corrupted (for example, a very long pathname that looks like it has a loop in the name), perform a filesystem check on the specified client.
/ path /savefs: Command not found / path /save: Not found / path /save: Command not found / path /savefs: Not found
The save or savefs command could not be found in the specified path. If you are using nsrexecd, this probably means that the save or savefs command is not in the same directory in which nsrexecd is installed (or that save or savefs was removed). If you are using rshd for remote execution, then you need to set the executable path attribute in the Client resource for this client to be the directory in which the NetWorker executables are installed on the client.
This message accompanies several other save or asm messages listed, and means that savefs has detected the failed save and has marked the save set as failed.
save : unknown host name: server savefs : unknown host name: server
The host table on the specified client (either /etc/hosts, NIS or DNS, depending on that client's configuration) does not include the server's name. You need to add the server's hostname to the specified client's host table. Note that if you use DNS but the server's Client resource name (in other words. the client resource for the server itself) is not fully qualified (i.e. it looks like “server,” not “server.domain,” and the server is in a different domain from the client, you will need to add the name server to the domain table for the domain containing the client. If you use NIS, this error means that either the NIS hosts map does not contain the server, the /etc/hosts file does not list the server, or the NIS master for the specified client is otherwise misconfigured (the server is a secondary server and there is no yppush from the primary; run ypwhich -m on the client to find out which NIS server is providing master translation).
The specified client is not listed in the host table on the server (similar to “Warning: `client' is not in the hosts table!”). Depending on your host configuration, this means the client is not listed in one (or more) of /etc/hosts, NIS, or the DNS. If you use fully qualified domain names, you may need to make a new client resource for this client, using that fully qualified domain name (i.e. name the client resource mars.acme.com, not mars).
This message is generated by a save or savefs command run on the specified client to save that client's filesystems. The client's hostname is not listed in the host table on the client (either /etc/hosts, NIS or DNS, depending on that client's configuration). This almost always results in a failed save. Fix the client's host table and rerun save.
This warning message is generated when save notices that the file's modification time changed while the file was being backed up. NetWorker does not attempt to lock files before saving them, since this would make backups run extremely slowly. You may wish to backup files that generate this message manually, to ensure that a consistent copy is saved. NetWorker does not reattempt backup automatically, so as to avoid trying forever on the same file.
This informational message is often generated when NetWorker backs up the message log files. It may also occur for other files. For files that you expect to grow while savegrp is running, you can use a directive specifying that the logasm (see the uasm(1M) reference page) should be used to back up the file. See also the nsr(4) and nsr_directive(4) reference pages.
The backup of the named filesystem was begun, but the connection to the NetWorker server closed part way through. This typically means that the server machine rebooted, or one or more save agents were killed by the system administrator or by the system itself (for example. due to overwriting the binary or a disk error in swap space). Restart save at a later time.
This informational message occurs only when you stop a running savegrp. The session for this save set may not disappear immediately, especially if the program's attempt to kill the save session fails. When you restart the savegrp command, it retries the discontinued save set.
The client's hostname and IP address are not correctly listed in one or more of /etc/hosts, NIS, or DNS on the server. You need to either change the appropriate host table (depending on which one(s) are in use on your server) to list the client's name as it is known to NetWorker, as that client's primary name, or you need to add the name listed at the end of the error message to the aliases attribute of the client's Client resource(s).
This message generally means that there are bad blocks on the disk(s) containing the specified file or directory. You should immediately run a filesystem check on the named client filesystem and check your client's system error log. If there are bad blocks, repair them if possible, or move the filesystem to a different disk.
asm : cannot stat / path : Stale NFS file handle asm : cannot stat / path : Missing file or filesystem
These informational messages (or variants of them for other operating systems) mean that the when save attempted to test the named directory to determine if it was a different filesystem from the one currently being saved, the filesystem was, in fact NFS mounted, but the mount point was bad. While this message does not affect the saved data, it does mean you have a network or NFS problem between the specified client and one or more of its fileservers. You may need to remount filesystems on the client, or perhaps reboot it, to correct the problem.
This message generally accompanies another message reporting a specific problem encountered while saving a file or directory on the named save set. The backup will attempt to continue and attempt to save other data, and generally, the backup will not be listed in the failed save sets section of the completion mail if any files on the save set are saved successfully, even if it only saves the top directory of the save set.
While savegrp was backing up the specified save set, an attempt to determine the current directory's name failed. This occurs on clients, generally running older versions of the NetWorker ClientPak, on which the getwd(3) library call is broken. You may want to contact Legato Technical Support to find out if there is a patch available for your client platform to work around this vendor-specific bug, or contact your operating system vendor to see if a more recent OS version addresses this problem.
A backed-up file had one or more hard links that were not found. The message is followed by a list of one or more filenames that were backed up minus some links. The message means that the files were either created (with multiple hard links) while the backup was occurring, so some of the links were missed due to the order of filesystem tree walking, or the file (or some links) was removed while the backup was occurring. Only those links that were found can be recovered; additional links will have been lost. You can do an additional incremental backup of the affected filesystem if a consistent state for the affected file is essential.
This message generally accompanies one or more other more-specific messages for the save set. The specified path within the current save set was not saved successfully. The backup will continue trying to back up other files and directories on the save set.
This error can be caused by several possible conditions (out of memory, buggy networking software in the operating system, an external ASM unexpectedly exiting, or a lost network connection). If it was due to a lost network connection, the NetWorker server most likely exited (due to nsr_shutdown). After restarting the server, rerun the group. If due to an ASM exiting unexpectedly (in this case, the message should be accompanied by a message describing which ASM exited unexpectedly), you may have found a bad block on the disk, or perhaps a bug. Check if the client ran out of memory (there may be console messages), and verify that there are no bad blocks on the save set's disk. If there were network errors, there may also have been messages logged by other programs on the system console (client or server), or to system log files.
connect to address AA.BB.CC.DD : messageTrying AA.BB.CC.DD ...
These informational messages are displayed only when the -v option is used. They mean that the connection to the client failed on the address specified in the first line of the message. If the client has more than one IP address, savegrp has attempted the address listed in the second line. Looking at subsequent lines of the savegroup completion notice may show if this second address succeeded. You may want to check and change your network routing tables to avoid getting these messages.
The client machine is up, but it is not accepting new network connections for nsrexecd (or rshd). This could mean the client was in the process of booting when savegrp attempted to connect, or that the client had exceeded some resource limit, and was not accepting any new connections. You should attempt to log into the client and verify that it is accepting remote connections.
This usually means the client has crashed or is hung. Make sure the client has rebooted, and that nsrexecd is running on it (if you are using nsrexecd).
This message is delivered by itself. It occurs when the named group has already been started or restarted (after a reboot, or when requested via the Group Control Window of nwadmin), either automatically by nsrd or manually from the command line. You can use ps to find out the process ID of a running savegrp. The existence of a running group is determined by looking for a file named /nsr/tmp/sg.groupname which, if existing and locked, means savegrp is running.
has been inactive for n minutes since time .client : saveset is being abandoned by savegrp.
A backup of the specified save set started, but after N minutes of no activity, savegrp gave up on the save set. Generally, this means that the client is hung waiting for an NFS partition. Unfortunately, NetWorker (or any other program) has no reliable way of telling if an NFS partition will hang until after it tries to access the partition. When the partition comes back on line, the save will complete, despite the fact that savegrp abandoned it. You should check the client, however, since you sometimes need to reboot the client to unhang NFS partitions. Non-UNIX clients also hang for other reasons, most notably, bugs in the operating system implementation of their network protocols.
The NetWorker server cannot make TCP/IP connections to the client. This generally means the network itself is not configured correctly; most commonly, one or more gateways or routers are down, or the network routes were not set up correctly. You should verify that the server can connect to the client. If the server cannot connect to the client, check your routers, gateways, or routing tables and reconfigure them if necessary.
This informational message is added by savegrp to any save set that is saved at the level full instead of the level found in the client's schedule. Due to timing problems, you can occasionally see this message when the clocks on the client and server are out of sync, or when savegrp starts before midnight and ends after midnight.
No 'NSR client' resource for client clienthostnamesavefs: cannot retrieve client resources
This pair of messages occurs if the client's hostname changed (in /etc/hosts, NIS or DNS). You may also have deleted the client's “Client” resource while savegrp was running. In the former case, you will need to add the client's new name to the aliases attribute of the client (this is a hidden attribute) using nsradmin (selecting the “Hidden” display option) or nwadmin (selecting the “Details View” option for the Client window). In the latter case, no additional action is required if this deletion was intentional (the next run of savegrp will not attempt to save the client). If it was accidental, and you did not want to delete the client, you should add the client back again and add the client back into the appropriate group(s). The next time savegrp runs, it will back up the client, just as if the client had been down the previous day.
The save set completed, but returned no status output. The most common reasons are that the client crashed or lost its network connection (in other words. a router between the client and server crashed) while the client was being backed up. Another is that the disk on which the client status was being logged filled up (perform a df /nsr/tmp to see if this was the case). To determine if the save set was saved, you can use mminfo. For example, run mminfo -v -c clientname -t '1 day ago' and look at the flags column for the completion status. An a flag means it aborted. Use a more distant time (the -t option) to look further back in time.
An explicit save set was named in the Client resource for the specified client, and that save set does not exist (or is not currently mounted) on the client. Make sure you spelled the save set name correctly (and that it is capitalized correctly), and log into the client and verify that the save set is mounted.
One of these informational messages is prepended to a save set's output if savegrp was unable to backup the data on the first try and if the client retries attribute for the group has a value greater than zero. In this case, the specified number of retries was performed before the backup of the save set succeeded or was finally marked as failed.
/ path : This data set is in use and cannot be accessed at this time
This message is generated by save sets on PC clients running DOS or NetWare. The NetWorker client software on these systems cannot back up files open for writing, due to the interface provided by the operating system. This message actually comes from Novell's TSA and is not changeable.
printer : unknown printer / path /savegrp: printing bootstrap information failed (reproduced below)/ path /savegrp: printing bootstrap information failed
These messages, or similar messages, accompany the bootstrap information when savegrp was unable to print the savegroup completion notice. You need to either specify a different printer in the printer attribute for the group, or configure your print server to recognize the printer (by default, your system's default printer is used). The bootstrap information is listed as part of the savegrp completion mail. You should print out this information immediately, in case your server has a disaster and loses a disk, and fix the printer name used by savegrp.
After the specified save set completed, savegrp was unable to read the log file of the output status from the save set. This generally means that someone, or an automated non-NetWorker administrative program or script, removed the log file. This message can also occur if the filesystem on which the client logs are stored has run out of space (use df /nsr/tmp to determine if this is the case). Verify that no scripts remove files from /nsr/tmp (which is where savegrp stores the save set log files).
This informational message is displayed only when the -v flag has been used for verbose information. This message means that nsrexecd is not running on the client, and that savegrp is attempting to use the rshd service instead, for backward compatibility with older versions of savegrp.
This error message normally accompanies another, more specific, error message. It
is generated when the attempt to run the specified command (usually save or savefs
with several command line parameters) failed on the specified save set. The
previous line of error output should include the more specific error message (look
for that message elsewhere in this section). Generally, the problem is a bad host table
configuration, or various permissions-denied errors (server not specified when
starting nsrexecd, or missing permissions in .rhosts if not using nsrexecd). If not, log
into the NetWorker server as root and run the command
Saving server index because server is not in an active group
This informational message, generated by savegrp, means that savegrp has noticed that the NetWorker server is not listed in any automatically started, enabled group. Since all the indexes are stored on the server, savegrp is saving the server's index and bootstrap information in case a disaster occurs. You should add the server to a group with autostart enabled, or enable one of the groups of which the server is already a member.
The NetWorker server has run out of socket descriptors. This means that you have exceeded the socket resource limit on your server. To avoid such future messages, you should determine what other network services are running while savegrp is running, and consider rescheduling either savegrp or the other services. You can also reduce the parallelism in the nsr_service(4) resource, to reduce the resource utilization.
This section lists error messages returned by the NetWorker recover program during an on–demand restore using ON-Bar. The messages are organized alphabetically to make them easier to match to the NetWorker message displayed.
This informative message explicitly states which NetWorker client's index is being browsed for interactive recovers that resolve to another machine.
Some problem was encountered connecting to the NetWorker server on the named machine.
The client invoking the recover command is not in the server's client list. See nsr_service(4) for details.
Message from server : other clones exist for failed save set
The recover command will be automatically resubmitted to the server, if any files remain to be recovered, because the request failed on a save set that had multiple clones. The server automatically picks a different clone on each attempt.
This informative message lets you know that the given pathname is mounted from a network file server and that the recovery will use the index for the named file server. If the machine is not a NetWorker client, then the -c option may be necessary.
The filename cannot be recovered because you are not root or in the group operator, and you don't have read permission for the file.
The filename cannot be recovered because you are not root or in the group operator, the file has an ACL (Access Control List), and you are not the owner of the file.
This informative message lets you know which NetWorker server was selected for the client's index.
During a backup or restore, NetWorker attempts to record messages generated by the XBSA library to the file assigned to the NSR_DEBUG_FILE environment variable. If the assigned location is invalid or unreachable, the message is written to one of the following locations:
the alternate messages directory created during installation, /nsr/applogs
the directory assigned to the TMPDIR environment variable
the /tmp directory, if TMPDIR is not set
See Appendix A, “XBSA Environment Variables” for descriptions of the NetWorker XBSA variables and values you can assign to them in the nsrdbmi script.
NetWorker XBSA error messages appear in the format
XBSA-1.0.1 dbmi-1.0 process_id day month date hh:mm:ss year function_name: BSA_RC_message_code: message
BSA_RC_ABORT_ACTIVE_NOT_FOUND No active object matched the name that was specified for a BSAMarkObjectInactive
This return code indicates that no active object matching the given search parameters was found in the NetWorker server being used by the NetWorker XBSA session.
BSA_RC_ABORT_SYSTEM_ERROR System detected error due to explanation . Operation aborted
This return code indicates that a general system error has occurred within a NetWorker XBSA function call. This error is returned for all NetWorker errors that do not map cleanly to XBSA errors.
BSA_RC_APP_OBJECTOWNER_TOO_LONG The appObjectOwner field contained too many characters ( n >= n )
This return code indicates that the appObjectOwner field of an ObjectOwner structure contains too many characters and may be corrupt.
BSA_RC_AUTHENTICATION_ERROR There was an authentication failure for ObjectOwner ownername
This return code indicates that the routine failed to authenticate a BSAObjectOwner with NetWorker server used by the NetWorker XBSA session. The code is returned by the routine BSASetEnvironment to allow for the possibility of changing NetWorker servers during a single session by changing the value of the NSR_SERVER environment option. See Appendix A, “XBSA Environment Variables” for more details on available settings. NetWorker permits all users to back up data and restore their files, without passwords, so this return code should not occur.
BSA_RC_BAD_CALL_SEQUENCE The sequence of API calls is incorrect. Must call item1 before item2
This return code indicates that an API call sequence was made that does not conform to the XBSA Data Movement API State Diagram document.
BSA_RC_BAD_HANDLE The handle used to associate this call with a previous BSAInit() call is invalid because explanation .
This return code indicates that the value passed into the function for bsaHandle contained a NULL pointer.
BSA_RC_BAD_PARAMETER received parameter parm with value value , which is invalid
This return code indicates that an invalid parameter was received.
BSA_RC_BSA_OBJECTOWNER_TOO_LONG The bsaObjectOwner field contained too many characters ( n >= n )
This return code indicates that the bsaObjectOwner field of an ObjectOwner structure contains too many characters and may be corrupt.
BSA_RC_BUFFER_TOO_SMALL Buffer is too small to hold the object entry to be returned. n bytes required for the object entry
This return code indicates that the buffer is too small to hold the object entry to be returned.
BSA_RC_COPYGPNAME_TOO_LONG The copyGpName field contained too many characters ( n >= n )
This return code indicates that the copyGpName field in one of the supplied structures contained more than BSA_MAX_COPYGPNAME characters and the structure could not be used for the requested operation.
BSA_RC_DESCRIPTION_TOO_LONG The description field contained too many characters ( n >= n )
This return code indicates that the Description field in one of the supplied structures contained more than BSA_MAX_DESC characters and the structure could not be used for the requested operation.
BSA_RC_INVALID_COPYTYPE the copyType field contained an unrecognized value of n
This return code indicates that the copyType field in one of the supplied structures has a value that is not in the NetWorker XBSA libraries implementation of this enumerated type.
BSA_RC_INVALID_DATABLOCK the dataBlock parameter contained inconsistent values: bufferLength: n , bufferPtr: n , numBytes: n
This return code indicates that the fields of a supplied DataBlock parameter are not internally consistent. This may occur when the bufferLength field is less than the numBytes field when data is being sent, or when the bufferLength field is nonzero and the bufferPtr field is NULL.
BSA_RC_INVALID_KEYWORD an entry in the environment structure is invalid ( variable = value )
This return code indicates that one of the environment strings passed into the function did not have a valid structure. The valid structure of a environment keyword is: KEYWORD=VALUE where KEYWORD is a white space delimited string and VALUE is a white space delimited string followed by a null terminator. This return code can indicate a number of possible errors:
The KEYWORD string was not in the reserved word list. This error is not returned by the NetWorker XBSA libraries as other environment variables may be passed into the library along with valid keywords.
The KEYWORD and VALUE strings were not separated by an equal (=) character. This type of error will also be used to detect environment vectors that are not properly terminated with a (char *)NULL entry as well as invalid KEYWORD VALUE pair formats.
The VALUE string was invalid.
The VALUE string could not be validated. For example, a hostname string that could not be found by the function gethostbyname().
BSA_RC_INVALID_OBJECTSTATUS the objectStatus field contained an unrecognized value of n
This return code indicates that the objectStatus field in one of the supplied structures has a value that is not in the NetWorker XBSA libraries implementation of this enumerated type.
This return code indicates that one of the object type parameters, either passed in directly, or contained in an ObjectDescriptor or QueryDescriptor structure, was not in the range of BSAObjectType_ANY to BSAObjectType_DIRECTORY.
BSA_RC_INVALID_TIME a time field contained an unrecognized value of n
This return code indicates that an invalid time value was received.
BSA_RC_INVALID_VERSION the version field contained an unrecognized value of n
This return code indicates that the version for a parameter passed into the function is not supported by this version of NetWorker XBSA. For routines that receive multiple parameters containing a version field, it does not indicate which parameter is not supported.
BSA_RC_LGNAME_TOO_LONG The LGName field contained too many characters ( n >= n )
This return code indicates that parameter LGName contained more than BSA_MAX_LGNAME_SIZE characters and may be corrupt. For routines that require multiple LGName parameters, it does not indicate which was invalid.
BSA_RC_MATCH_EXISTS object matching the specified predicate already exists
This return code indicates that the object already exists in the NetWorker server being used by the NetWorker XBSA session and the requested operation cannot be completed.
BSA_RC_MORE_DATA more data is available. Data can be obtained through BSAGetData() or BSAGetNextQueryObject()
This return code has two meanings in the XBSA Data Movement API:
Object Data Retrieval
There is more data available for an object being read from the NetWorker server being used by the NetWorker XBSA session. Use BSAGetData to retrieve the next DataBlock from the NetWorker server (see also BSA_RC_BUFFER_TOO_SMALL and BSA_RC_NO_MORE_DATA). This return code is not returned by the BSAGetObjectF function because all data for an object is written to a file descriptor by this function.
Query Result Retrieval
There are more objects matching the requested query descriptor from the NetWorker server being used by the NetWorker XBSA session. Use BSAGetNextQueryObject to retrieve the next object descriptor from Backup Services (see also BSA_RC_NO_MORE_DATA).
BSA_RC_NO_MATCH The variable predicate value of value does not match the reference value of variable
This return code indicates that no objects matching the specified query descriptor were found in the NetWorker server being used by the NetWorker XBSA session.
BSA_RC_NO_MORE_DATA there is no more data for the current object
This return code has two meanings in the XBSA Data Movement API:
Object Data Retrieval
This return code will be used when all the data for an object being retrieved from a NetWorker server was placed into the given DataBlock parameter for a function call (see also BSA_RC_MORE_DATA).
Query Result Retrieval
This return code will be used when the last (or only) object matching a query is returned to the caller (see also BSA_RC_MORE_DATA).
This return code indicates that a pointer to an ApiVersion structure passed into the function was NULL and is required as input.
This return code is not used by NetWorker XBSA. A null buffer when reading an object's data (BSAGetData, BSAGetObject) will result in no bytes being read and a BSA_RC_MORE_DATA code begin returned.
The DataBlock pointer parameter for the called function was NULL. The caller is responsible for allocating and passing in a DataBlock structure to the NetWorker XBSA library (see also BSA_RC_NULL_BUFFER and BSA_RC_INVALID_DATABLOCK).
This return code is not used by NetWorker XBSA. An environment vector parameter that is NULL will simply not be processed.
BSA_RC_NULL_NEWTOKEN a value must be entered for the new token. The old token has expired
This return code indicates that the securityToken parameter newToken was found to be NULL and is required as input. See also BSA_RC_NULL_SECURITYTOKEN.
BSA_RC_NULL_OBJECTDESCRIPTOR an ObjectDescriptor pointer is required
This return code indicates that the securityToken parameter newToken was found to be NULL and is required as input. See also BSA_RC_NULL_SECURITYTOKEN.
The ObjectName parameter passed into the called function was NULL
This return code indicates that a pointer to an ObjectOwner structure was NULL and is required as input.
The NetWorker XBSA library will not return this code. Instead, specific codes indicating that a required parameter was NULL are returned:
BSA_RC_NULL_SECURITYTOKEN a securityToken pointer is required
This return code indicates that a pointer to a securityToken parameter is NULL and is required as input. This return code is used internally by the NetWorker XBSA library and should not be seen in normal use. The more specific codes BSA_RC_NULL_NEWTOKEN and BSA_RC_NULL_OLDTOKEN are used as appropriate.
BSA_RC_OBJECTINFO_TOO_LONG The objectInfo field contained too many characters ( n >= n )
The ObjectInfo field passed to the function, either directly or in an ObjectDescriptor data structure, was found to have more than BSA_MAX_OBJINFO characters.
BSA_RC_OBJECTSPACENAME_TOO_LONG The objectSpaceName field contained too many characters ( n >= n )
This return code indicates that the string objectSpaceName contains more than BSA_MAX_OBJECTSPACENAME characters in an ObjectName structure.
BSA_RC_PATHNAME_TOO_LONG The pathName field contained too many characters ( n >= n )
This return code indicates that the string pathName contains more than BSA_MAX_PATHNAME characters in an ObjectName structure.
BSA_RC_RESOURCETYPE_TOO_LONG The resourceType field contained too many characters ( n >= n )
This return code indicates that the string resourceType contains more than BSA_MAX_RESOURCETYPE characters and may be corrupt.
BSA_RC_SECURITYTOKEN_TOO_LONG The securityToken field contained too many characters ( n >= n )
This return code indicates that a securityToken passed in to the function was contained more than BSA_MAX_SECURITYTOKEN characters and may be corrupt. For routines that require multiple tokens, it does not indicate which was invalid.
This return code indicates that the called function did not fail and is returned by all NetWorker XBSA function calls.
This return code indicates that the current transaction was aborted by the BSAEndTxn function call. A transaction may either be aborted by an internal error or by user request through the Vote parameter to this function.