Previous Topic: #GETQUE—retrieves a queue recordNext Topic: #GETQUE Parameters


#GETQUE Syntax

►►─┬─────────┬────────────────────────────────────────────────────────────────►
   └─ label ─┘

 ►─── #GETQUE RECORD=return-queue-data-location-pointer ──────────────────────►

 ►─── ,RECLEN= ─┬─ queue-data-max-length ─┬───────────────────────────────────►
                └─ queue-data-length ─────┘
 ►─┬─────────────────────────────────────────────┬────────────────────────────►
   └─ ,PLIST= ─┬─ SYSPLIST ◄ ───────────────────┬┘
               └─ parameter-value-list-pointer ─┘

 ►─┬───────────────────────────┬──────────────────────────────────────────────►
   └─ ,QUEID=queue-id-pointer ─┘

 ►─┬──────────────────────────────────────────────┬───────────────────────────►
   └─ ,LOC= ─┬─ Next ◄ ──────────────────────────┬┘
             ├─ First ───────────────────────────┤
             ├─ Last ────────────────────────────┤
             ├─ Prior ───────────────────────────┤
             ├─ (NTH, sequence-pointer) ─────────┤
             └─ (QRID, queue-record-id-pointer) ─┘
 ►─┬───────────────────────────┬──────────────────────────────────────────────►
   └─ ,DISP= ─┬─ DELETE ◄ ────┬┘
              └─ KEEP ────────┘

 ►─┬─────────────────────────────────────────┬────────────────────────────────►
   └─ ,RTNQRID= ─┬─ (1) ◄ ──────────────────┬┘
                 └─ return-queue-record-id ─┘

 ►─┬──────────────────────────────────────┬───────────────────────────────────►
   │                ┌────────────────┐    │
   └─ ,OPTION= ──(──▼─┬┬─ LOCK ◄ ─┬─┬┴─)──┘
                      │└─ NOLOCK ─┘ │
                      └┬─ NOWAIT ◄ ┬┘
                       └─ WAIT ────┘

 ►─┬───────────────────────────────┬──────────────────────────────────────────►
   └─ ,COND= ─┬── NO ◄ ───────────┬┘
              ├── ALL ────────────┤
              │   ┌─── , ─────┐   │
              └─(─▼─┬─ NQID ─┬┴─)─┘
                    ├─ NRID ─┤
                    ├─ INVP ─┤
                    └─ IOER ─┘
 ►─┬──────────────────────────────┬───────────────────────────────────────────►
   └─ ,NQIDXIT=no-queue-id-label ─┘

 ►─┬─────────────────────────────────────┬────────────────────────────────────►
   └─ ,NRIDXIT=no-queue-record-id-label ─┘

 ►─┬────────────────────────────┬─────────────────────────────────────────────►
   └─ ,IOERXIT=i/o-error-label ─┘

 ►─┬─────────────────────────────────────────┬────────────────────────────────►
   └─ ,INVPXIT=invalid-parameter-list-label ─┘

 ►─┬──────────────────────┬───────────────────────────────────────────────────►◄
   └─ ,ERROR=error-label ─┘