DSMSERV (Start the server)

Use this utility to start the IBM Spectrum Protect™ server.

Restrictions:

Do not enter more than 1022 characters in the DSMSERV console command-line interface. Text that exceeds 1022 characters is truncated.
The following parameters are mutually exclusive:
- NOEXPIRE
- RUNFILE
- MAINTENANCE

Syntax


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

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

>--+------------------+--+----------------+--------------------->
   |  (1)             |  |  (3)           |   
   '------- -noexpire-'  '-------NOEXPIRE-'   

>--+-------------------+--+---------------+--------------------->
   '- -o--options_file-'  |  (1)          |   
                          '------- -quiet-'   

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

Notes:

This parameter applies only to AIX® and Linux servers.
This parameter applies only to Windows servers.
This parameter applies only to Windows servers.
This parameter applies only to AIX, Linux, 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 the server does not remove expired files from the server database. The files are not deleted from server storage when you start the server.
NOEXPIRE: Specifies that the server does not remove expired files from the server database. The files are not deleted from server storage 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 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