NET/MASTER RMS Management and Operations Guide

RMS XFER
RMS Commands
115415 NonStop NET/MASTER RMS Management and Operations Guide B–15
RULESET= ruleset2
specifies the new name for the transferred ruleset. If no ruleset name is specified,
the ruleset name defaults to the name of the ruleset being transferred.
OPTION={ M | R }
specifies whether the ruleset from the source database entirely replaces the target
ruleset in the destination database, or whether the source ruleset merges with the
target ruleset in the destination database.
To replace the target ruleset, specify R; to merge the rulesets, specify M.
ACTIVATE={ I | D }
specifies whether the transferred ruleset is immediately available to the message
handler, or whether activation of the ruleset is deferred until the next time the
message handler is started using the ruleset.
To immediately activate the ruleset, specify I; to defer the activation of the ruleset,
specify D.
Considerations
The following syntax is compatible with the RMS XFER command:
ZRMSXFRN FROM { FNAME= filename1 | FID= fileid1 }
RULESET= ruleset1
TO { FNAME= filename2 | FID= fileid2 }
[ RULESET= ruleset2 ]
[ OPTION=M | R ]
[ ACTIVATE=I | D ]
If the target ruleset does not exist on the destination database, a new ruleset is
created with the specified ruleset name. Records belonging to the source ruleset
are also transferred to the new ruleset in the destination database.
Record locking occurs automatically during the transfer of the ruleset if the
specified UDB file ID to which the ruleset is to be transferred is the current RMS
database ZRMSDB; this is to ensure that the transferred data is consistent.
If the Merge option is specified, records contained in the source ruleset that are not
yet in the target ruleset are transferred to the target ruleset. All records with the
same names remain unchanged. The control options record of the target ruleset (if
it exists) is not updated.
If the Replace option is specified, the target ruleset is removed and replaced by the
source ruleset. The target ruleset adopts all records of the source ruleset.