Tivoli Header

Administrator's Reference

DSMSERV LOADFORMAT (Format the Database and Log For Load)

Use this command to format the database and recovery log for a subsequent DSMSERV LOADDB or DSMSERV RESTORE DB.

You must run a DSMSERV LOADFORMAT before you run a DSMSERV LOADDB. After you run a DSMSERV LOADFORMAT, you must run a DSMSERV LOADDB or DSMSERV RESTORE DB before the server will start.

Notes:

  1. If a DSMSERV LOADFORMAT was run, and a DSMSERV LOADDB cannot be run, you can restore the database to a point in time with a DSMSERV RESTORE DB. See DSMSERV RESTORE DB (Restore the Database) for additional information.

  2. When a database is loaded or restored, the server-to-server communication verification token is changed. The verification token is an attribute of the database and is not stored in the database itself. Part of the token is the install date and time for the database. For servers that have been defined for server-to-server communications, you must issue an UPDATE SERVER command with FORCESYNC=YES.

Syntax

            .- -k--server1--.
>>-dsmserv--+---------------+----------------------------------->
            '- -k--key_name-'
 
>--loadformat--number_of_log_files------------------------------>
 
     .-------------------------.
     V                         |
>--+---log_file_name--log_size-+-+--number_of_db_files---------->
   '-file:log_file_name----------'
 
     .------------------.
     V                  |
>--+---db_name--db_size-+-+------------------------------------><
   '-file:db_file_name----'
 
 

Parameters

-k key_name
Specifies the server instance. The default is SERVER1.

number_of_log_files (Required)
Specifies the number of recovery log files.

log_file_name
Specifies one or more recovery log file names. The files must not exist before you issue the command, or the command fails.

The number of names must match the number specified by the number_of_log_files parameter. The minimum size for the log is 9MB.

log_size (Required)
Specifies the size of the recovery log file in megabytes. The minimum size is 9MB.

file:log_file_name
Specifies the name of a file that contains a list of recovery log volume names and sizes (one name and size per line) used to format the recovery log. If the files exist before you issue the command, the command fails.

It is recommended that you specify a fully-qualified name enclosed in single quotes so that you will not be affected by data set name qualification rules that depend on your operating environment.

The number of names must match the number specified by the number_of_log_files parameter. You must list the volumes in the order in which they are to be used. The minimum size for the log is 9MB.

number_of_db_files (Required)
Specifies the number of database files.

db_file_name
Specifies one or more database file names. If the files exist before you issue the command, the command fails.

The number of names must match the number specified by the number_of_db_files parameter. The minimum size for the database is 5MB.

db_size (Required)
Specifies the size of the database in megabytes. The minimum size is 5MB.

file:db_file_name
Specifies the name of a file that contains a list of database volume names and sizes (one name and size per line). The files must not exist before you issue the command or the command fails.

The number of names must match the number specified by the number_of_db_files parameter. You must list the volumes in the order they are to be used. The minimum size for the database is 5MB.

Examples

Task:

To prepare to recover the first server on a Windows NT system, change to the directory that contains the server executable and issue the DSMSERV LOADFORMAT command. For example, from a Windows NT prompt, enter the following commands:

  1. cd c:\program files\tivoli\tsm\server
  2. dsmserv loadformat 1 log1.dsm 9 1 db1.dsm 13

Because the -k parameter is not specified, Tivoli Storage Manager creates an NT registry key named Server1.

Use the following example to prepare to recover an additional server on a Windows NT machine. The server is installed in the c:\"program files"\tivoli\tsm\server directory and TCP/IP is the communications method used.

Note:
If you have installed Tivoli Storage Manager in a different location, substitute that location for the one listed in the example below.
  1. From the c:\"program files"\tivoli\tsm directory, enter the following commands to create a new directory and change into that directory:
    md server2
    cd server2
    
  2. From the c:\"program files"\tivoli\tsm\server2 directory, enter the following commands:
    ..\utils\dsmloadformat -data data1.dsm 4
    ..\server\dsmserv -k server2 loadformat 1 log1.dsm 9 1 db1.dsm 13
    ..\server\dsmserv -k server2 runfile ..\server\initnode.dat
    ..\server\dsmserv -k server2 runfile ..\server\dsmserv.idl
    ..\utils\adsm
    
  3. From the tree view, select Server Options.
  4. From the list, select Server2.
  5. Click Edit.
  6. Select TCP/IP and Port Address.
  7. Change the value for the Port Address to 1501.
  8. Click on the Client Settings button to view the parameters the clients must use in the Client Options File to connect to the new server.
  9. Click OK .
  10. Enter ..\server\dsmserv -k server2 to start the new server.
  11. Install the server


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]