NET/MASTER RMS Management and Operations Guide

RMS FREEZE
RMS Commands
115415 NonStop NET/MASTER RMS Management and Operations Guide B–11
RMS FREEZE The RMS FREEZE command enables you to freeze a subject so that when a message
handler receives a message containing that subject, the message cannot trigger any
rules.
RMS FREEZE SUBJECT= subject [ MANAGER= manager ]
SUBJECT= subject
specifies the name of the subject. You can specify a subject from 1 through 34
characters long.
When you specify only a subject, only messages containing a subject of that name
(irrespective of the manager) are frozen.
MANAGER= manager
specifies the name of the manager. You can specify a manager from 1 through 32
characters long.
If you specify a manager, only the subjects (as determined by the value of the
subject) under the specified manager are frozen.
If you specify a manager, you can use the wild-card character asterisk (*) for the
subject name so that all subjects for the specified manager are frozen.
Considerations
The following syntax is compatible with the RMS FREEZE command:
ZRMSFRZN SUBJECT= subject [ MANAGER= manager ]
You can use the EQUATE command to assign a lengthy command string to a
single character or sequence of characters. For example:
EQUATE FREEZE RMS FREEZE
Examples
1. The following example freezes the subject named $LINE1:
RMS FREEZE SUBJECT=$LINE1
2. The following example freezes the subject named TERM1 under the manager
$XXPM:
RMS FREEZE SUBJECT=TERM1 MANAGER=$XXPM
3. The following example freezes all subjects under the manager $XXPM:
RMS FREEZE SUBJECT=* MANAGER=$XXPM