Schedule

The schedule command starts the client scheduler on your workstation. The client scheduler must be running before scheduled work can start.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsAuthorized User: The schedule command starts the client scheduler on your workstation. The client scheduler must be running before scheduled work can start.

Note:
  1. The schedule command cannot be used if the managedservices option is set to schedule (does not apply to Mac OS X).
  2. Mac OS X operating systemsFor Mac OSX only, to use the schedule command, specify managedservices none in the dsm.sys file.
  3. This command is valid only on the initial command line. It is not valid in interactive mode or in a macro file.

Windows operating systemsIf the schedmode option is set to polling, the client scheduler contacts the server for scheduled events at the hourly interval you specified with the queryschedperiod option in your client options file (dsm.opt). If your administrator sets the queryschedperiod option for all nodes, that setting overrides the client setting.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsIf the schedmode option is set to polling, the client scheduler contacts the server for scheduled events at the hourly interval you specified with the queryschedperiod option in your client user-options file (dsm.opt). If your administrator sets the queryschedperiod option for all nodes, that setting overrides the client setting.

Windows operating systemsIf you are using TCP/IP communications, the server can prompt your workstation when it is time to run a scheduled event. To do so, set the schedmode option to prompted in the client options file (dsm.opt) or on the schedule command.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsIf you are using TCP/IP communications, the server can prompt your workstation when it is time to run a scheduled event. To do so, set the schedmode option to prompted in the client user-options file (dsm.opt) or on the schedule command.

Windows operating systemsAfter you start the client scheduler, it continues to run and to start scheduled events until you pressCtrl+Break , restart the workstation, or turn off the workstation to end it.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsMac OS X operating systemsYou can use the sessioninitiation option with the schedule command to control whether the server or client initiates sessions through a firewall.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsAfter you start the client scheduler, it continues to run and to start scheduled events until you press Ctrl+C, stop the scheduler process with the UNIX kill command, start the workstation again, or turn off the workstation to end it.

Mac OS X operating systemsAfter you start the client scheduler, it continues to run and to start scheduled events until you press Ctrl+C, press the Q key twice, start the workstation again, or turn off the workstation to end it.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsWindows operating systemsNote: You cannot enter this command in interactive mode.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsWindows operating systems

Supported Clients

This command is valid for all clients.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-SCHedule--+------------+------------------------------------><
             '- --options-'   

Parameters

Table 1. Schedule command: Related options
Option Where to use
Windows operating systemsmaxcmdretries Windows operating systemsClient options file (dsm.opt) or command line.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsmaxcmdretries AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsClient system options file (dsm.sys) or command line.
Windows operating systemspassword Windows operating systemsclient options file (dsm.opt)
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemspassword AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsclient user options file (dsm.opt)
Windows operating systemsqueryschedperiod Windows operating systemsClient options file (dsm.opt) or command line.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsqueryschedperiod AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsClient system options file (dsm.sys) or command line.
Windows operating systemsretryperiod Windows operating systemsClient options file (dsm.opt) or command line.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsretryperiod AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsClient system options file (dsm.sys) or command line.
Windows operating systemsschedlogname Windows operating systemsClient options file (dsm.opt) or command line.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsschedlogname AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsClient system options file (dsm.sys) or command line.
Windows operating systemsschedmode Windows operating systemsClient options file (dsm.opt) or command line.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsschedmode AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsClient system options file (dsm.sys) or command line.
Windows operating systemssessioninitiation Windows operating systemsClient options file (dsm.opt) or command line.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemssessioninitiation AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsClient system options file (dsm.sys) or command line.
Windows operating systemstcpclientport Windows operating systemsClient options file (dsm.opt) or command line.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemstcpclientport AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsClient system options file (dsm.sys) or command line.

Examples

Mac OS X operating systemsWindows operating systemsTask
Mac OS X operating systemsWindows operating systemsStart the client scheduler.

Command: dsmc sch –password=notell

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsTask
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsFor AIX®: Start the scheduler at system bootup time by entering this command in the /etc/inittab file. Ensure that the passwordaccess option is set to generate.

Command: tsm::once:/usr/bin/dsmc sched > /dev/null 2>&1 #TSM

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsTask
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsInteractively start the scheduler and keep it running in the background.

Command: nohup dsmc sched 2> /dev/null &

Windows operating systemsWhen you run the schedule command, all messages that regard scheduled work are sent to the dsmsched.log file or to the file you specify with the schedlogname option in your client options file (dsm.opt). If you do not specify a directory path with the file name in the schedlogname option, the dsmsched.log resides in the current working directory.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsWhen you run the schedule command, all messages that regard scheduled work are sent to the dsmsched.log file or to the file you specify with the schedlogname option in your client system-options file (dsm.sys). If you do not specify a directory path with the file name in the schedlogname option, the dsmsched.log resides in the current working directory, except for Mac OS X. For Mac OS X, the dsmsched.log resides in the /Library/Logs/tivoli/tsm/ directory.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsWindows operating systemsImportant: To prevent log write failures and process termination in certain cases, set the DSM_LOG environment variable to name a directory where default permissions allow the required access.