NET/MASTER RMS Management and Operations Guide

ZRMSAPIN ( DELACTIVE )
RMS Procedure Calls
C–2 115415 NonStop NET/MASTER RMS Management and Operations Guide
ZRMSAPIN ( DELACTIVE )
The ZRMSAPIN ( DELACTIVE ) procedure call deletes active subjects.
CALL ZRMSAPIN ( DELACTIVE, subject [, manager ] )
SHARE &SYSMSG
subject
specifies the name of a subject. You can specify a subject from 1 through 34
characters long.
manager
specifies the name of the manager. You can specify a manager from 1 through 32
characters long.
If there is a manager associated with the specified subject, you must specify the
manager. If you specify a manager, only the subject (as determined by the value
of the subject) under the specified manager is deleted.
Consideration
After the ZRMSAPIN ( DELACTIVE) 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.
Examples
1. The following example illustrates a user NCL procedure that deletes the active
subject named $LINE1:
SAMPLE: PROCEDURE
&SUB=“$LINE1”
CALL ZRMSAPIN (DELACTIVE,&SUB) SHARE &SYSMSG
END SAMPLE
2. The following example illustrates a user NCL procedure that deletes the active
subject named TERM1 under the manager $XXPM:
SAMPLE: PROCEDURE
&SUB=“TERM1”
&MGR=“$XXPM”
CALL ZRMSAPIN (DELACTIVE,&SUB,&MGR) SHARE &SYSMSG
END SAMPLE