Schedule

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

Linux operating systemsOracle Solaris operating
systemsAIX 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.
  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.

Linux operating systemsOracle Solaris operating
systemsAIX 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.

Linux operating systemsOracle Solaris operating
systemsAIX 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.

Linux operating systemsOracle Solaris operating
systemsAIX 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.

Linux operating systemsOracle Solaris operating
systemsAIX 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.

Windows operating systemsLinux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsNote: You cannot enter this command in interactive mode.
Windows operating systemsLinux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systems

Supported Clients

This command is valid for all clients.

Syntax

Read syntax diagramSkip visual syntax diagramSCHedule 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.
Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsmaxcmdretries Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsClient system options file (dsm.sys) or command line.
Windows operating systemspassword Windows operating systemsclient options file (dsm.opt)
Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemspassword Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsclient user options file (dsm.opt)
Windows operating systemsqueryschedperiod Windows operating systemsClient options file (dsm.opt) or command line.
Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsqueryschedperiod Linux operating systemsOracle Solaris operating
systemsAIX 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.
Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsretryperiod Linux operating systemsOracle Solaris operating
systemsAIX 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.
Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsschedlogname Linux operating systemsOracle Solaris operating
systemsAIX 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.
Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsschedmode Linux operating systemsOracle Solaris operating
systemsAIX 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.
Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemssessioninitiation Linux operating systemsOracle Solaris operating
systemsAIX 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.
Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemstcpclientport Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsClient system options file (dsm.sys) or command line.

Examples

Windows operating systemsMac OS X operating
systemsTask
Windows operating systemsMac OS X operating
systemsStart the client scheduler.

Command: dsmc sch -password=notell

Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsTask
Linux operating systemsOracle Solaris operating
systemsAIX 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

Linux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X operating
systemsTask
Linux operating systemsOracle Solaris operating
systemsAIX 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.

Linux operating systemsOracle Solaris operating
systemsAIX 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.

Windows operating systemsLinux operating systemsOracle Solaris operating
systemsAIX operating systemsMac OS X 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.