$Buffer_Position

From m204wiki
Revision as of 14:11, 11 January 2018 by DCameron (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Function

Returns the current Universal Buffer position

Syntax

$Buffer_Position

Where

The $Buffer_Position function, which takes no arguments, returns numeric results for the following circumstances:

If the most recent statement was... System returns... Signifying...
MODIFY BUFFER NOPRESERVE 1  
MODIFY BUFFER PRESERVE Position is unchanged. If the new BUFFER size is less than this value, then it is set to the byte after the last byte in the BUFFER area.
MQGET {image | %variable} Byte after the last byte copied into the %variable or image.  
MQGET, running in an APSY subsystem with AUTOCOMMIT=NO Position after the last byte of the previous request  
MQGET BUFFER 1 Beginning of the buffer.
MQPUT or MQPUT1 1 Beginning of the buffer.
READ FROM BUFFER Position after the last byte read from the buffer. First byte read by a subsequent READ from BUFFER area without POSITION specified.
WRITE ON BUFFER Position after the last byte written to the buffer. First byte written by a subsequent WRITE to BUFFER area without POSITION specified.
All other User Language statements--including when MQ/204 is not linked in -1