Scheduling events using the command-line client

If you include files for encryption processing, ensure that you select the Save Encryption Key Password Locally option in the Authorization Preferences window so that the client scheduler can perform unattended scheduled services without prompting the user for the encryption key. If the encryption key has not been previously saved, you must perform an attended backup of at least one file so that the encryption prompt is given and the key is saved.

To start the client scheduler on your client node and connect to the server schedule:

1. Change to the Tivoli Storage Manager installation directory and enter the following command:

   dsmc schedule

   When you start the client scheduler, it runs continuously until you close the window, end the process, or log off your system.

2. If the Tivoli Storage Manager client executable directory is not in your PATH environment variable, change to the installation directory and enter the following command:

   ./dsmc schedule

3. To run the schedule command in the background and to keep the client scheduler running, even if you log off your system, enter the following:

   nohup dsmc schedule 2> /dev/null &

If a Tivoli Storage Manager password is required for your workstation and you want to run the schedule command in the background, enter the password with the command.

Root User: To start the client scheduler automatically, ensure that the passwordaccess option is set to generate in dsm.sys, then follow the procedure for your operating system:

To start each client scheduler automatically, add an entry to the /etc/inittab file. Typically, the run level to use is 2, 3, 4, 5, or 6, depending on the operating system and its configuration. Consult documentation for your operating system for details on run levels.

Verify the correct syntax for the entry by consulting documentation for your operating system.

Here are some examples:

For AIX®, add the following entry to the /etc/inittab file:

itsm:2:once:/usr/bin/dsmc sched > /dev/null 2>&1 # TSM scheduler

In this example, the run level is set to 2.

For HP-UX, add the following entry to the /etc/inittab file:

itsm:3456:once:/usr/bin/dsmc sched > /dev/null 2>&1 # TSM scheduler

In this example, the run level is set to 3, 4, 5, and 6.

For Solaris, add the following entry to the /etc/inittab file:

itsm:23:once:/usr/bin/dsmc sched > /dev/null 2>&1 # TSM scheduler

In this example, the run level is set to 2 and 3.

For Mac OS X:

The system administrator must generate a password so that Tivoli Storage Manager can store the password in the TSM.PWD file. This can be done either with TSM Tools for Administrators or with the command line.

A system administrator must use either of the following methods to enable the Tivoli Storage Manager client acceptor daemon to launch the command-line client in schedule mode to handle scheduled events when you start the system.

Method 1 (preferred)

• Use TSM Tools for Administrators and Start the TSM Connect Agent applications. This installs the client acceptor daemon as a system startup item so the client acceptor daemon starts after system restarts. The client acceptor daemon is also started immediately, so you do not need to restart the system to handle scheduled events.

Method 2

• Use the shell script in "/Library/Application Support/tivoli/tsm/client/ba/bin" to install the client acceptor daemon as a startup item. The script name is StartCad.sh.

Complete the following steps to start the client acceptor daemon manually, and to check that it is running.

1. To check whether the client acceptor daemon is running, enter the following command:

     sudo ps -x | grep dsmcad

   If the client acceptor daemon is running, one of the processes listed has the path /usr/bin/dsmcad.

2. To start the client acceptor daemon manually, enter the following command in a terminal window:

     sudo /sbin/SystemStarter start dsmcad

The client scheduler can fail to properly initialize at system startup because TCP/IP is not fully initialized. You might need to delay the scheduler service start up to allow time for TCP/IP to initialize.

Tivoli Storage Manager does not recognize changes made to the dsm.opt or the dsm.sys file while the client scheduler is running. If you make changes to these files while the client scheduler is running, and you want to use the new values immediately, stop the client scheduler and restart it. For example, if you change the inclexcl option in your dsm.sys file to point to a different include-exclude options file, you must stop the client scheduler and restart it before Tivoli Storage Manager uses the new file.

To manually stop the client scheduler, use the kill command if the client scheduler is running in the background, or press q or Ctrl+C if it is running in the foreground. To restart the client scheduler, enter the schedule command again.

Tape prompting does not occur during a scheduled event regardless of the tapeprompt option setting in your options file.