IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive ...

Table 47. Client return codes and their meanings (continued)CodeotherExplanationFor scheduled operations where the scheduled action is COMMAND, thereturn code will be the return code from the command that was executed. Ifthe return code is 0, the status of the scheduled operation will be Completed. Ifthe return code is nonzero, then the status will be Failed.Some commands might issue a nonzero return code to indicate success. Forthese commands, you can avoid a Failed status by wrapping the command in ascript that invokes the command, interprets the results, and exits with returncode 0 if the command was successful (the script should exit with a nonzeroreturn code if the command failed). Then ask your Tivoli Storage managerserver administrator to modify the schedule definition to invoke your scriptinstead of the command.The return code for a client macro will be the highest return code issued amongthe individual commands that comprise the macro. For example, suppose a macroconsists of these commands:selective "/home/devel/*" -subdir=yesincremental "/home/devel/TestDriver/*" -subdir=yesarchive "/home/plan/proj1/*" -subdir=yesIf the first command completes with return code 0; the second commandcompleted with return code 8; and the third command completed with return code4, the return code for the macro will be 8.See the IBM Tivoli Storage Manager Administrator’s Reference for your operatingsystem for more information about QUERY EVENT.Related concepts“Scheduling options for commands” on page 218The scheduler executes commands under a user ID of 0 (root); however, somecommands might need to be executed under a user ID other than 0. In this case,your Tivoli Storage Manager administrator can define schedules for commandsthat will be executed under a user ID different from the scheduler user ID usingthe schedcmduser server option.228 IBM Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients Version 6.1: Installation and User’s Guide