DSMSERV (Start the server)

Use this utility to start the Tivoli® Storage Manager server. You might be asked to specify the RUNFILE parameter after you install a new release of Tivoli Storage Manager.

Tip: You cannot enter more than 1022 characters in the DSMSERV console command-line interface. Text that exceeds 1022 characters is truncated.

Syntax


>>-DSMSERV--+----------------------+---------------------------->
            |  (1)                 |   
            '------- -u--user_name-'   

                                 (2).- -k--Server1--.   
>--+-------------------------+------+---------------+----------->
   |  (1)                    |      '- -k--key_name-'   
   '------- -i--instance_dir-'                          

>--+------------+--+-------------------+--+---------+----------->
   '- -noexpire-'  '- -o--options_file-'  '- -quiet-'   

>--+--------------------+--------------------------------------><
   +-RUNFILE--file_name-+   
   |             (3)    |   
   '-MAINTenance--------'

Notes:

This parameter applies only to AIX®, HP-UX, Linux, and Solaris servers.
This parameter applies only to Windows servers.
This parameter applies only to AIX, Linux, Solaris, and Windows servers.

Parameters

-u user_name: Specifies a user name to switch to before you start the server. To start the server from the root user ID, you must specify the -u parameter and follow the instructions in Starting the server from the root user ID.
-i instance_dir: Specifies an instance directory to use. The instance directory becomes the current working directory of the server.
-k key_name: Specifies the name of the Windows registry key from which to retrieve information about the server. The default is Server1.
-noexpire: Specifies that expiration processing is suppressed when you start the server.
-o options_file: Specifies an options file to use.
-quiet: Specifies that messages to the console are suppressed.
MAINTenance: Specifies that the server is started in maintenance mode, and that administrative command schedules, client schedules, client sessions, storage-space reclamation, inventory expiration, and storage-pool migration are disabled.
Tip: Maintenance mode is the preferred method for running the server during maintenance or reconfiguration tasks. When you run the server in maintenance mode, operations that might disrupt maintenance or reconfiguration tasks are disabled automatically.
RUNFILE file_name: Specifies the name of a text file to be run on the server. The file contains a list of Tivoli Storage Manager server commands.
Attention: Whenever the RUNFILE parameter is used, the server halts when processing is complete. You must restart the server by using the DSMSERV utility.

Example: Start the server

Start the server for normal operation. Issue the following command on one line:

LDR_CNTRL=TEXTPSIZE=64K@DATAPSIZE=64K@STACKPSIZE=64K@SHMPSIZE=64K 
usr/bin/dsmserv

AIX operating systems Ensure that you include a space after SHMPSIZE=64K. By starting the server with this command, you enable 64 KB memory pages for the server. This setting helps you optimize server performance.

/opt/tivoli/tsm/server/bin/dsmserv

C:\Program Files\Tivoli\TSM\bin\dsmserv -k server2

Example: Start an additional server

Start an additional server by using the registry key named SERVER2.

dsmserv -k server2

Example: Load the sample script

Load the sample script file that is provided with the server.

dsmserv runfile scripts.smp

Example: Start the server in maintenance mode

Before you begin maintenance or reconfiguration tasks, start the server in maintenance mode.

dsmserv maintenance