$Lstr Set UserBuffer: Difference between revisions
Jump to navigation
Jump to search
m (misc formatting) |
m (add link) |
||
| (5 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
<span class="pageSubtitle">Set user buffer to longstring value</span> | <span class="pageSubtitle">Set user buffer to longstring value</span> | ||
<p class="warn"><b>Note: </b> | <p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the <var>$Lstr_Set_UserBuffer</var> function.</p> | ||
This [[Notation conventions for methods#Callable functions|callable]] function sets the contents of the current user buffer to the <var>[[Longstrings|Longstring]]</var> argument value. Such a user buffer is a Universal Buffer or an [[MQ/204]] user buffer, both of which, as of <var class="product">Model 204</var> V6R1, may transfer Large Object (LOB) data. For | This [[Notation conventions for methods#Callable functions|callable]] function sets the contents of the current user buffer to the <var>[[Longstrings|Longstring]]</var> argument value. Such a user buffer is a Universal Buffer or an [[MQ/204]] user buffer, both of which, as of <var class="product">Model 204</var> V6R1, may transfer [[Large Object fields#BLOB.2C CLOB.2C and MINLOBE attributes|Large Object (LOB) data]]. For versions of <var class="product">Model 204</var> prior to 6.1, this function applies only to the MQ user buffer and requires the MQ/204 feature. | ||
==Syntax== | ==Syntax== | ||
| Line 20: | Line 20: | ||
==Usage notes== | ==Usage notes== | ||
<ul> | <ul> | ||
<li>The Universal Buffer is a one-per-user, temporary storage area that, like the MQ buffer, automatically expands to accommodate its data contents. Unlike prior | <li>The Universal Buffer is a one-per-user, temporary storage area that, like the [[MQ/204 data conversion and handling#Data handling|MQ buffer]], automatically expands to accommodate its data contents. Unlike prior versions, the MQ buffer in <var class="product">Model 204</var> 6.1 also becomes a one-per-user buffer. | ||
<p> | <p> | ||
If the user buffer has to be expanded to accommodate the <var class="term">longstring</var> value, its length is increased in increments of 4096 bytes (one page). </p></li> | If the user buffer has to be expanded to accommodate the <var class="term">longstring</var> value, its length is increased in increments of 4096 bytes (one page). </p></li> | ||
<li>Any errors during the transfer of the longstring result in request cancellation. </li> | <li>Any errors during the transfer of the <var class="term">longstring</var> value result in request cancellation. </li> | ||
<li>Additional functions specifically for working with Large Object data are: | <li>Additional functions specifically for working with Large Object data are: | ||
Latest revision as of 20:40, 1 September 2016
Set user buffer to longstring value
Note: Many $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $Lstr_Set_UserBuffer function.
This callable function sets the contents of the current user buffer to the Longstring argument value. Such a user buffer is a Universal Buffer or an MQ/204 user buffer, both of which, as of Model 204 V6R1, may transfer Large Object (LOB) data. For versions of Model 204 prior to 6.1, this function applies only to the MQ user buffer and requires the MQ/204 feature.
Syntax
[%len =] $Lstr_Set_UserBuffer(longstring)
| %len | The length in bytes of the user buffer contents, or it is -1 to indicate an error. |
|---|---|
| longstring | The String or Longstring to be copied to the user buffer. |
Usage notes
- The Universal Buffer is a one-per-user, temporary storage area that, like the MQ buffer, automatically expands to accommodate its data contents. Unlike prior versions, the MQ buffer in Model 204 6.1 also becomes a one-per-user buffer.
If the user buffer has to be expanded to accommodate the longstring value, its length is increased in increments of 4096 bytes (one page).
- Any errors during the transfer of the longstring value result in request cancellation.
- Additional functions specifically for working with Large Object data are: