$Buffer Position: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 27: | Line 27: | ||
</tr> | </tr> | ||
<tr> | <tr> | ||
<td>MQGET {image | %variable}</td> | <td>[[MQ/204_and_SOUL_statements#MQGET_statement|MQGET]] {image | %variable}</td> | ||
<td>Byte after the last byte copied into the %variable or image. </td> | <td>Byte after the last byte copied into the %variable or image. </td> | ||
<td> </td> | <td> </td> | ||
Revision as of 13:45, 11 January 2018
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 |