NET/MASTER RMS Management and Operations Guide

ZRMSAPIN ( GETQUEUED )
RMS Procedure Calls
115415 NonStop NET/MASTER RMS Management and Operations Guide C–13
After the ZRMSAPIN ( GETQUEUED ) procedure call completes, the following
variables contain additional information:
Variable Contains
&RMS.QUEUED.ACTION.n NCL procedure or command, and arguments for rule action n.
&RMS.QUEUED.MANAGER Manager of action queue subject.
&RMS.QUEUED.MHNCLID.n NCL ID of message handler for rule action n.
&RMS.QUEUED.MSGTEXT.n Message text for rule action n.
&RMS.QUEUED.MSGTIME.n Message time for rule action n.
&RMS.QUEUED.NCLID.n NCL ID of rule action n.
&RMS.QUEUED.NCLQUEUE.n NCL queue of execution for rule action n.
&RMS.QUEUED.NUM Number of rule action entries found.
&RMS.QUEUED.REGION.n Region of execution for rule action n.
&RMS.QUEUED.RULEID.n Rule ID for rule action n.
&RMS.QUEUED.RULESET.n Ruleset name for rule action n.
&RMS.QUEUED.STATUS.n Status of rule action n: ACTIVE or QUEUED.
&RMS.QUEUED.SUBJECT Subject of action queue.
&RMS.QUEUED.TYPE.n Type of rule action n: NCLPROC or COMMAND.
n A number from 1 through &RMS.QUEUED.NUM
Examples
1. The following example illustrates a user NCL procedure that retrieves information
about all rule actions queued to the subject $LINE1:
SAMPLE: PROCEDURE
&SUB=“$LINE1”
ZRMSAPIN (GETQUEUED,&SUB) SHARE &RMS.,&SYSMSG
END SAMPLE
2. The following example illustrates a user NCL procedure that retrieves information
about all rule actions queued to the subject TERM1 under the manager $XXPM:
SAMPLE: PROCEDURE
&SUB=“TERM1”
&MGR=“$XXPM”
ZRMSAPIN (GETQUEUED,&SUB,&MGR) SHARE &RMS.,&SYSMSG
END SAMPLE