$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 |