Owner's manual

Nomadic Disk Manager Interface
ServerNet Nomadic Disk User’s Guide—425485-001
7-8
GIVE Command
GIVE Command
Use the GIVE command to change the status of a segment to NOT OWNED. The prior
status of the segment can be anything, that is, it need not be OWNED.
SEGMENT segname
specifies which segments to give away. If a data segment is specified, all data
segments are given away. If segname is not specified, the GIVE command
operates on the current segment.
DATA
specifies all data segments are given away. ONLY and DATA cannot be used in the
same command. If the DATA parameter is not specified, the SEGMENT parameter
is assumed.
LOCALTMF
do not use this parameter.
START
do not use this parameter.
ONLY
specifies that only the named segment is to be given away, regardless of its type.
This parameter is intended only for emergencies and cannot be used with the DATA
parameter.
Considerations
•
If a GIVE command does not contain the SEGMENT option, nor the DATA option,
it works on the current segment. If a current segment has not been set with the
ASSUME command, the last segment defined in the configuration file becomes the
assumed segment. If that segment is a DATA segment, issuing a GIVE command
has the same effect as issuing a GIVE DATA command. If that segment is a SPARE
segment, the GIVE command works only on that segment. Even though SPARE
segments are not directly supported, the code still allows them. Therefore, you
should always issue a GIVE DATA command rather than a simple GIVE command.
•
In a planned switchover, you should issue the GIVE command on the owning node
before issuing a TAKE command on the destination node. The GIVE command
allows a smooth switchover. However, a GIVE command is not strictly necessary
and might not always be possible in an emergency; for example, if the giving node
is down. A TAKE command is always necessary, even if the GIVE command
finishes properly.
GIVE [ SEGMENT segname | DATA ] [ , LOCALTMF ]
[ , START ]
[ , ONLY ]