MAGVA DEQUEUE Q MSG (3187)    REMOTE PROCEDURE (8994)

Name Value
NAME MAGVA DEQUEUE Q MSG
TAG DEQM
ROUTINE MAGVAQ01
RETURN VALUE TYPE ARRAY
AVAILABILITY RESTRICTED
INACTIVE ACTIVE
DESCRIPTION
 Find, return and remove a message from the QUEUE MESSAGE file (#2006.928)
 by QUEUE FK - IEN of record in QUEUE file (#2006.927)
 and by MESSAGE GROUP ID.
 If "MESSAGE GROUP ID" equals "*" it ignores "MESSAGE GROUP ID".
 If "MESSAGE GROUP ID" equals "" it looks only at queue messages with blank "MESSAGE GROUP ID".
 Otherwise looks at queue messages with MESSAGE GROUP ID
INPUT PARAMETER
  • MAGPARAM
    PARAMETER TYPE:   LIST
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    MAGPARAM("QUEUE") = IEN in QUEUE file (#2006.927)
    MAGPARAM("MESSAGE GROUP ID") = value of the field "MESSAGE GROUP ID"
                                   in QUEUE file (#2006.927) or "*" or ""
    
RETURN PARAMETER DESCRIPTION
 if error MAGRY(0) = Failure status ^ Error message
 if success MAGRY(0) = Success status ^^IEN
            MAGRY(1..n) = The QUEUE MESSAGE
            
            if IEN equals 0 that means nothing was found