Commands › CA IDMS DML SCRATCH/QUEUE Processing › Default Data and Length Assignment

Default Data and Length Assignment

You may omit specification of data area and/or length for a GET or PUT command. CA IDMS DMLO attempt to establish a logical value for the omitted parameter. The rules for establishing such values are as follows:

• If you specify a record name as a data area, the default length will be the record length.
• If you specify a field name as a data area, the default length will be from the start of that field to the end of its record.
• If you omit the data area from a PUTSCR request, the default will be the area and length used in a prior PUT for the same scratch area ID.
• If you omit the data area from a GETSCR request, the default area and length will be selected from:
  • Prior GETSCR request for the same scratch area ID
  • Prior PUTSCR request for the same scratch area ID
  • Unused SBUFn default buffer name
• If you omit the data area from a PUTQUE request, the default will be the area and length used in a prior PUT for the same queue ID.
• If you omit the data area from a GETQUE request, the default area and length will be selected from:
  • Prior GETQUE request for the same queue ID
  • Prior PUTQUE request for the same queue ID
  • Unused QBUFn default buffer name

    GET SCRatch
     [[AREA] [ID] scratch-area]
    
     ┌ / Next◄                \ ┐
     │ │ First                │ │
     │ < Last                 > │
     │ │ Prior                │ │
     │ │ Current              │ │
     └ \ RECord ID scr-rec-id / ┘
    
     /         \
     < Delete◄ >
     \ Keep    /
    
     ┌                 ┌/                       \┐┐
     │ INto buff-start │<  TO buff-end          >││
     └                 └\ MAX Length max-reclen /┘┘
    
      [RETurn LENgth [INto] len-field]
    PUT SCRatch
     [[AREA] [ID] scratch-area]
    
     ┌                 ┌/                    \┐┐
     │ FROM buff-start │<  TO buff-end       >││
     └                 └\  Length scr-reclen /┘┘
    
     [RECord ID scr-rec-id [REPlace]]
    
     [RETurn RECord ID [INto] rid-field]
    DELETE SCRatch
     [[AREA] [ID] scratch-area]
    
     ┌ / Next                 \ ┐
     │ │ First                │ │
     │ < Last                 > │
     │ │ Prior                │ │
     │ │ Current◄             │ │
     └ \ RECord ID scr-rec-id / ┘
    
     [RETurn RECord ID [INto] rid-field]
    

GET QUEUE
 [[ID] queue-area]

 ┌ / Next◄                \ ┐
 │ │ First                │ │
 │ < Last                 > │
 │ │ Prior                │ │
 │ │ N th                 │ │
 └ \ RECord ID scr-rec-id / ┘

 /         \
 < Delete◄ >
 \ Keep    /

 /        \
 < LOck◄  >
 \ NOLock /

 /         \
 < Wait    >
 \ NOWait◄ /
 ┌                 ┌/                       \┐┐
 │ INto buff-start │< TO buff-end           >││
 └                 └\ MAX Length max-reclen /┘┘

 [RETurn LENgth [INto] len-field]
PUT QUEUE
 [[ID] queue-area]

 /       \
 < FIrst >
 \ Last  /

 ┌                 ┌/                   \┐┐
 │ FROM buff-start │< TO buff-end       >││
 └                 └\ Length scr-reclen /┘┘

 [RETurn RECord ID [INto] rid-field]

 [RETENtion retn-days]
DELETE QUEUE
 [[ID] queue-area]
 
 /          \
 < Current◄ >
 \ All      /