NET/MASTER RMS Management and Operations Guide

ZRMSAPIN ( GETFROZEN )
RMS Procedure Calls
C–10 115415 NonStop NET/MASTER RMS Management and Operations Guide
ZRMSAPIN ( GETFROZEN )
The ZRMSAPIN ( GETFROZEN ) procedure call retrieves information about frozen
subjects. If you do not specify a subject or a manager, information about all frozen
subjects under all managers is retrieved.
CALL ZRMSAPIN ( GETFROZEN [, subject [, manager ] ] )
SHARE &RMS., &SYSMSG
SUBJECT= subject
specifies the name of a subject and, additionally, names beginning with subject .
You can specify a subject from 1 through 34 characters long.
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 information about the frozen subjects (as
determined by the value of the subject) under the specified manager is retrieved.
Considerations
After the ZRMSAPIN ( GETFROZEN ) 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 not found.
16 Any other internal error; more information available in &SYSMSG.
After the ZRMSAPIN ( GETFROZEN ) procedure call completes, the following
variables contain additional information:
Variable Contains
&RMS.FROZEN.MANAGER.n Manager of frozen subject n.
&RMS.FROZEN.NUM Number of frozen subject entries found.
&RMS.FROZEN.SUBJECT.n Frozen subject n.
&RMS.FROZEN.TIME.n Date/time subject n was frozen.
&RMS.FROZEN.USER.n User who froze subject n.
n A number from 1 through &RMS.FROZEN.NUM