Tivoli Header

Tivoli Storage Manager for Macintosh Backup-Archive Client Installation and User's Guide

Preschedulecmd/Prenschedulecmd

System Administrator

The preschedulecmd option specifies a command that the client program processes before it runs a schedule. The client program waits for the command to complete before it starts the schedule.

If you do not want it to wait, specify prenschedulecmd.

Notes:

  1. Successful completion of the preschedulecmd command is considered to be a prerequisite to running the scheduled operation. If the preschedulecmd command does not complete with return code 0, the scheduled operation and any postschedulecmd and postnschedulecmd commands will not run. The client will report that the scheduled event failed, and the return code will be 12. If you do not want the preschedulecmd command to be governed by this rule, you can create a script or batch file that invokes the command and exits with return code 0. Then configure preschedulecmd to invoke the script or batch file. The return code for the preschedulecmd command is not tracked, and does not influence the return code of the scheduled event.

  2. The Tivoli Storage Manager Client API does not support this option.

  3. The server can also define the preschedulecmd option (and the prenschedulecmd option).

Preferences File

Place this option in the TSM System Preferences file.

Syntax

>>-+-PRESchedulecmd--+-- "cmdstring"---------------------------><
   '-PRENSchedulecmd-'
 
 

Parameters

"cmdstring"
Specifies the command to process. Use only one preschedulecmd option. You can enter a command to be executed before a schedule using this option.

Use a blank or null string for cmdstring if you want to prevent any commands from running that the administrator uses for postschedulecmd and preschedulecmd. If you specify a blank or null string on either option, it prevents the administrator from using a command on both options.

If your administrator uses a blank or null string on the preschedulecmd option, you cannot run a pre-schedule command.

If the command string contains blanks, enclose the command string in double quotes. If you placed double quotes within the command string, then enclose the entire command string in single quotes.

The command string should specify an AppleScript to launch. If it is only a file name, such as "Database Script", the client program searches for this file in the Scripts folder inside the Tivoli Storage Manager folder. Otherwise, the command string should contain the full path of the file, such as:

   "La Pomme:Scripting:Database Script"
    
    preschedulecmd stopdb.cmd
    
    preschedulecmd "rename c:\myapp\logfile.log logfile.old"
    
    preschedulecmd 'net stop "simple service"'
    
    preschedulecmd 'rename "c:\program files\myapp\log file.log" "log file.old"'
 

Examples

TSM System Preferences:
preschedulecmd "quiesce database"

The command string is a valid command for quiescing your database.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]