$Buffer Position: Difference between revisions
Jump to navigation
Jump to search
m (Mlarocca moved page $BUFFER POSITION to $Buffer Position: Lower case change) |
No edit summary |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:$ | {{DISPLAYTITLE:$Buffer_Position}} | ||
<b>Function</b> | <b>Function</b> | ||
<p>Returns the current Universal Buffer position</p> | <p>Returns the current Universal Buffer position</p> | ||
<b>Syntax</b> | <b>Syntax</b> | ||
<p class="code">$ | <p class="code">$Buffer_Position | ||
</p> | </p> | ||
<b>Where</b> | <b>Where</b> | ||
<p>The $ | <p>The $Buffer_Position function, which takes no arguments, returns numeric results for the following circumstances:</p> | ||
<table> | <table> | ||
<tr class="head"> | <tr class="head"> | ||
Revision as of 13:46, 8 July 2014
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 |