NET/MASTER RMS Management and Operations Guide

ZRMSAPIN ( FREEZE )
RMS Procedure Calls
C–14 115415 NonStop NET/MASTER RMS Management and Operations Guide
ZRMSAPIN ( FREEZE ) The ZRMSAPIN ( FREEZE ) NCL procedure call enables you to freeze a subject so that
when a message handler receives a message containing that subject, the message
cannot trigger any rules.
CALL ZRMSAPIN ( FREEZE, subject [, manager ] )
SHARE &SYSMSG
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 ) procedure call:
CALL ZRMSFRZN ( subject [, manager ] ) SHARE &SYSMSG
After the ZRMSAPIN ( FREEZE ) 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 No action—the subject was already in a frozen state.
8 No action—wild card was specified for the subject without manager.
16 Any other internal error.