NET/MASTER RMS Management and Operations Guide

ZRMSAPIN ( XFER )
RMS Procedure Calls
115415 NonStop NET/MASTER RMS Management and Operations Guide C–19
The file name is in the following format:
[ \ sys . ][ $ volume . ][ subvolume . ] filename
If you specify the UDB file ID, you must specify a file ID that is one through eight
characters long, beginning with a character other than a digit. If you are
transferring to the current database, specify ZRMSDB.
to-ruleset
specifies the new name for the transferred ruleset. If no ruleset name is specified,
the ruleset name defaults to the name of the source ruleset being transferred.
option
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 two rulesets, specify M. This
is optional, and the default is M.
activate
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. The activate is optional, and the default is D.
Considerations
The following syntax is compatible with the RMS ( XFER ) procedure call:
CALL ZRMSXFRN ( from-db-type , from-db , from-ruleset ,
to-db-type , to-db [, to-ruleset ] [, option ]
[, activate ] ) SHARE &SYSMSG
After the ZRMSAPIN ( XFER ) procedure call completes, the system variable
&SYS.RETCODE is set to one of the following values:
Return Code Description
0 The request was completed successfully.
4 The ruleset was not found in the RMS database.
8 One or both databases could not be opened.
16 Any other internal error.
If the system variable &SYSMSG is shared between the ZRMSAPIN ( XFER )
procedure call and the user NCL procedure, and if no errors occur, the system
variable is assigned more information, such as the number of records transferred.