MAGVA PEEK Q MSG (3206)    REMOTE PROCEDURE (8994)

Name Value
NAME MAGVA PEEK Q MSG
TAG PEEKQM
ROUTINE MAGVAQ01
RETURN VALUE TYPE ARRAY
AVAILABILITY RESTRICTED
INACTIVE ACTIVE
DESCRIPTION
 Get a queue message from the QUEUE MESSAGE file (#2006.928)
 by QUEUE - 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 file (#2006.927)
    MAGPARAM("MESSAGE GROUP ID") = value of the field "MESSAGE GROUP ID"
                                                                       in 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