Administrator's Reference
Use this command to initialize the server database and recovery log.
No other server activity is allowed while initializing the database and
recovery log.
Attention:
- In ADSM Version 2, this was the DSMSERV INSTALL command.
- Do not use this command to install an ADSM Version 3 or TSM server over an
ADSM Version 1 or Version 2 server. Any data that exists in the files
you specify will be lost.
- The installation program creates a set of registry keys. One of
these keys points to the directory where a default server, named Server1, is
created. When you issue the DSMSERV FORMAT command, a file named
dsmserv.dsk is created. This file points to the directory that
contains the database and recovery log.
To install an additional server, create a new directory and issue the
DSMSERV FORMAT command, with the -k parameter, from that directory.
That directory becomes the location of the server. The registry tracks
the installed servers.
Syntax
.- -k--Server1---.
>>-dsmserv----+----------------+--format--number_of_log_files--->
'- -k--key_name--'
.---------------------------.
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 name of a Windows NT registry key used to store information
about this server. Use this parameter only to install additional
servers on the same system. After you install a server by using this
parameter, you must always start it with the value of this parameter.
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 1:
To manually install the first server on a Windows NT system, change to that
directory that contains the server executable and issue the DSMSERV FORMAT
command. For example, from a Windows NT prompt, enter the following
commands:
- cd:\"program
files"\ibm\adsm\server
- dsmserv format 1 log1.dsm 9 1 db1.dsm 13
Because the -k parameter is not specified, TSM creates an NT registry key
of Server1. When this command is run without specifying a -k parameter,
it uses information stored in the system registry under the key
SERVER1.
Use the following example to install an additional server on a Windows NT
machine. The server is installed in the c:\"program
files"\ibm\adsm\server directory and TCP/IP is the
communications method used.
Note: | If you have installed TSM in a different location, substitute that location
for the one listed in the example below.
|
- From the c:\"program files"\ibm\adsm
directory, enter the following commands to create a new directory and change
into that directory:
md server2
cd server2
- From the c:\"program
files"\ibm\adsm\server2 directory, enter the
following commands:
..\utils\dsmfmt -data data1.dsm 4
..\server\dsmserv -k server2 format 1 log1.dsm 9 1 db1.dsm 13
..\server\dsmserv -k server2 runfile ..\server\initnode.dat
..\server\dsmserv -k server2 runfile ..\server\dsmserv.idl
Copy ..\server\dsmserv.opt
..\utils\adsm
- From the Main Menu, select Options, Options Files, Select Options
File.
- From the list, select Server2.
- Select File, Open.
- Select Options, TCP/IP, Port Address.
- Change the value for the Port Address to 1501.
- 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.
- Select File and then Save.
- Enter ..\server\dsmserv -k server2
to start the new server.
Task 2:
Initialize the recovery log and database volumes by specifying files
containing the volume names and sizes (in megabytes):
- File c:\"program
files"\ibm\adsm\server2\log.vols
contains the volume names, each with 9 megabytes of storage:
- File c:\"program
files"\ibm\adsm\server2\db.vols
contains the volume name with 5 megabytes of storage:
- Command:
-
c:\"program files"\ibm\adsm\server2>dsmserv -k server2 in
file:log.vols 1 file:db.vols
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]