Previous Topic: #GETSCR—retrieves a scratch recordNext Topic: #GETSCR Parameters


#GETSCR Syntax

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

 ►─── #GETSCR RECORD=return-scratch-data-location-pointer ────────────────────►

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

 ►─┬─────────────────────────────────┬────────────────────────────────────────►
   └─ ,SAID=scratch-area-id-pointer ─┘

 ►─┬───────────────────────────────────────┬──────────────────────────────────►
   └─ ,LOC= ─┬─ Next ◄ ───────────────────┬┘
             ├─ First ────────────────────┤
             ├─ Last ─────────────────────┤
             ├─ Current ──────────────────┤
             ├─ Prior ────────────────────┤
             └─ (SRID,scratch-record-id) ─┘
 ►─┬───────────────────────┬──────────────────────────────────────────────────►
   └─ ,DISP= ─┬─ DELETE ◄ ┬┘
              └─ KEEP ────┘

 ►─┬───────────────────────────────────────────┬──────────────────────────────►
   └─ ,RTNSRID= ─┬─ (1) ◄ ────────────────────┬┘
                 └─ return-scratch-record-id ─┘

 ►─┬───────────────────────────────┬──────────────────────────────────────────►
   └─ ,COND= ─┬── NO ◄ ───────────┬┘
              ├── ALL ────────────┤
              │   ┌─── , ─────┐   │
              └─(─▼─┬─ NAID ─┬┴─)─┘
                    ├─ NRID ─┤
                    ├─ IOER ─┤
                    └─ INVP ─┘
 ►─┬─────────────────────────────────────┬────────────────────────────────────►
   └─ ,NAIDXIT=no-scratch-area-id-label ─┘

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

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

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

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