SRSPARM parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
 
Line 23: Line 23:
<dl>
<dl>
<dt>X'01'
<dt>X'01'
<dd>Make default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST &ldquo;ERROR&rdquo;.
<dd>Make &ldquo;ERROR&rdquo; the default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST.
<dt>X'02'
<dt>X'02'
<dd>Make default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST &ldquo;CANCEL&rdquo;.
<dd>Make &ldquo;CANCEL&rdquo; the default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST.
If this bit is set, the X'01' bit is irrelevant.
If this bit is set, the X'01' bit is irrelevant.
<dt>X'04'
<dt>X'04'
<dd>Make default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST &ldquo;UERROR&rdquo;.
<dd>Make &ldquo;UERROR&rdquo; the default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST.
<dt>X'08'
<dt>X'08'
<dd>Make default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST &ldquo;UCANCEL&rdquo;.
<dd>Make &ldquo;UCANCEL&rdquo; the default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST.
If this bit is set, the X'04' bit is irrelevant.
If this bit is set, the X'04' bit is irrelevant.
<dt>X'10'
<dt>X'10'
<dd>Make default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST &ldquo;COPY&rdquo;.
<dd>Make &ldquo;COPY&rdquo; the default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST.
<dt>X'20'
<dt>X'20'
<dd>CANCEL request on a COPY style $WEB_SAVE_RECSET for an exclusively locked
<dd>CANCEL request on a COPY style $WEB_SAVE_RECSET for an exclusively locked record set.
record set.
If this bit is not set, this error would simply be reflected with an error code of 7.
If this bit is not set, this error would simply be reflected with an error
code of 7.
This operation is not allowed, because there cannot be two threads that
This operation is not allowed, because there cannot be two threads that
have the same records locked in exclusive mode, which is what would be
have the same records locked in exclusive mode, which is what would be
the case after a COPY type save of an exclusively locked record set.
the case after a COPY type save of an exclusively locked record set.
<dt>X'40'
<dt>X'40'
<dd>Make default for $WEB_REST_RECSET and $WEB_REST_LIST &ldquo;COPY&rdquo;.
<dd>Make &ldquo;COPY&rdquo; the default for $WEB_REST_RECSET and $WEB_REST_LIST.
<dt>X'80'
<dt>X'80'
<dd>CANCEL request on a COPY style $WEB_REST_RECSET for an exclusively locked
<dd>CANCEL request on a COPY style $WEB_REST_RECSET for an exclusively locked record set.
record set.
If this bit is not set, this error would simply be reflected with an error code of 7.
If this bit is not set, this error would simply be reflected with an error
code of 7.
This operation is not allowed, because there cannot be two threads that
This operation is not allowed, because there cannot be two threads that
have the same records locked in exclusive mode, which is what would be
have the same records locked in exclusive mode, which is what would be

Revision as of 15:45, 13 March 2012

Summary

Default value
X'00'
Parameter type
User
Where set
User and $RESETN resettable
Related products
All
Introduced
Before Sirius Mods 6.7

Description

This bitmask parameter makes it possible to change the default behavior of the $Web_Restore_Recset and $Web_Restore_List functions. By default, they act as if MOVE were specified. The default behavior of all of these functions can, however, be changed on a thread basis by setting the SRSPARM parameter (which can be reset with $RESETN).

SRSPARM is a bitmask user parameter where the bits mean:

X'01'
Make “ERROR” the default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST.
X'02'
Make “CANCEL” the default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST. If this bit is set, the X'01' bit is irrelevant.
X'04'
Make “UERROR” the default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST.
X'08'
Make “UCANCEL” the default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST. If this bit is set, the X'04' bit is irrelevant.
X'10'
Make “COPY” the default for $WEB_SAVE_RECSET and $WEB_SAVE_LIST.
X'20'
CANCEL request on a COPY style $WEB_SAVE_RECSET for an exclusively locked record set. If this bit is not set, this error would simply be reflected with an error code of 7. This operation is not allowed, because there cannot be two threads that have the same records locked in exclusive mode, which is what would be the case after a COPY type save of an exclusively locked record set.
X'40'
Make “COPY” the default for $WEB_REST_RECSET and $WEB_REST_LIST.
X'80'
CANCEL request on a COPY style $WEB_REST_RECSET for an exclusively locked record set. If this bit is not set, this error would simply be reflected with an error code of 7. This operation is not allowed, because there cannot be two threads that have the same records locked in exclusive mode, which is what would be the case after a COPY type restore of an exclusively locked record set.

In general, table full problems with saved record sets are best handled (as are most system-wide resource shortages) with request cancellation, because it does not make sense to code applications in a way that would be able to detect and correct for these shortages.