$Buffer Position

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