$Buffer Position: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 42: Line 42:
</tr>
</tr>
<tr>
<tr>
<td>[[MQ/204_and_SOUL_statements#MQPUT_statement|MQPUT]] or MQPUT1</td>
<td>[[MQ/204_and_SOUL_statements#MQPUT_statement|MQPUT]] or [[MQ/204_and_SOUL_statements#MQPUT1_statement|MQPUT1]]</td>
<td>1</td>
<td>1</td>
<td>Beginning of the buffer.</td>
<td>Beginning of the buffer.</td>

Revision as of 13:49, 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