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

useful if you want to use specific options for a scheduled action that differ fromthe option settings normally used by the client node, or are different for eachschedule the node will execute.|||The schedmode option controls the communication interaction between the TivoliStorage Manager client and server. There are two variations on the schedule mode:client polling and server prompted.Handling return codes from preschedulecmd andpostschedulecmdscriptsBeginning with Tivoli Storage Manager Version 5.1, the scheduler exhibits thefollowing behavior when the preschedulecmd and postschedulecmd options areused:v If the command specified by the preschedulecmd option ends with a nonzeroreturn code, Tivoli Storage Manager considers the command to have failed. Inthis case, neither the scheduled event nor any postschedulecmd orpostnschedulecmd command will run. The administrative query event commandwith format=detailed option will show that the event failed with return code 12.v If the command specified by the postschedulecmd option ends with a nonzeroreturn code, Tivoli Storage Manager considers the command to have failed. Theadministrative query event command with format=detailed option will show thatthe event completed with return code 8, unless the scheduled operationcompleted with a higher return code, in which case the higher return codeprevails. Therefore, if the scheduled operation completes with return code 0 or 4and the postschedulecmd command fails, the administrative query eventcommand will show that the event completed with return code 8. If thescheduled operation completes with return code 12, that return code prevails,and query event will show that the event failed with return code 12.When interpreting the return code from a command, Tivoli Storage Managerconsiders 0 to mean success, and anything else to mean failure. While this behavioris widely accepted in the industry, it is not 100% guaranteed. For example, thedeveloper of the widget command might exit with return code 3, if widget ransuccessfully. Therefore, it is possible that the preschedulecmd or postschedulecmdcommand might end with a nonzero return code and be successful. To preventTivoli Storage Manager from treating such commands as failed, you should wrapthese commands in a script, and code the script so that it interprets the commandreturn codes correctly. The script should exit with return code 0 if the commandwas successful; otherwise it should exit with a nonzero return code. The logic for ascript running widget might look like this:run ’widget’if lastcc == 3exit 0elseexit 1See the following references for more information:v “Postschedulecmd/Postnschedulecmd” on page 311v “Preschedulecmd/Prenschedulecmd” on page 314v “Client return codes” on page 155502 IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide