Normal syntax for LOB fields: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<var class="product">Sirius Mods</var> with [[Longstrings]] support allows use of most "normal" <var class="product">User Language</var> syntax to access <var>BLOB</var> and <var>CLOB</var> fields. This feature is generally available as of version V7R5 of <var class="product">Model 204</var>.
Starting with version 7.5 of Model 204, most "normal field reference syntax" can be used to access <var>BLOB</var> and <var>CLOB</var> fields.


For example:
For example:
Line 16: Line 16:
In this request, notice how the LOB field is updated directly (in the <var>Store Record</var> block) and retrieved directly (in the <var>Print</var> statement).  In general, references to LOB fields can be made in this direct fashion, without utilizing the Universal Buffer.
In this request, notice how the LOB field is updated directly (in the <var>Store Record</var> block) and retrieved directly (in the <var>Print</var> statement).  In general, references to LOB fields can be made in this direct fashion, without utilizing the Universal Buffer.


There are a few exceptions to this; the following constructs do not allow such direct reference to the value of a LOB field:
The only construct which does not allow such direct reference to the value of a LOB field is the <var>[[Note statement|Note]]</var> statement.
<ul>
<li>The <var>Note</var> statement
<!-- need to research .. references to SIRLSAV, e.g., precluding Note is done in CMPJ. -->
</ul>


This feature is disabled by setting the <var>LSTRLOB</var> system parameter to 0 (the default is 1). See the <var>[[LSTRLOB parameter#Description|LSTRLOB]]</var> description for further details.
This feature is disabled by setting the <var>[[LSTRLOB parameter|LSTRLOB]]</var> system parameter to 0 (the default is 1). The [[LSTRLOB parameter#Description|LSTRLOB description]] also illustrates examples of "normal field reference syntax."
==Authorizing products==
 
==Access to LOB fields prior to Model 204 version 7.5==
Normal syntax for LOB fields is available to any customer who owns any of the following products:
Prior to version 7.5 of Model 204, access to LOB fields required the [[Sirius Mods]], with one of the following products:
* ''Fast/Unload User Language Interface''
* [[Fast/Unload User Language Interface]]
*'' Janus SOAP''
* [[Janus SOAP]]
* ''Janus Sockets''
* [[Janus Sockets]]
* ''Janus Web Server''
* [[Janus Web Server]]
* ''Sirius Functions''
* [[Sirius Functions]]
   
   
[[Category:User Language syntax enhancements]]
[[Category:User Language syntax enhancements]]

Latest revision as of 19:35, 20 July 2018

Starting with version 7.5 of Model 204, most "normal field reference syntax" can be used to access BLOB and CLOB fields.

For example:

DEFINE FIELD LONGSTUFF WITH BLOB ... begin store record LONGSTUFF = 'How now, brown cow?' end store fr print LONGSTUFF end for end

In this request, notice how the LOB field is updated directly (in the Store Record block) and retrieved directly (in the Print statement). In general, references to LOB fields can be made in this direct fashion, without utilizing the Universal Buffer.

The only construct which does not allow such direct reference to the value of a LOB field is the Note statement.

This feature is disabled by setting the LSTRLOB system parameter to 0 (the default is 1). The LSTRLOB description also illustrates examples of "normal field reference syntax."

Access to LOB fields prior to Model 204 version 7.5

Prior to version 7.5 of Model 204, access to LOB fields required the Sirius Mods, with one of the following products: