RETRVOPT parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Template:RETRVOPT parameter subtitle}}
==Summary==
==Summary==
<dl>
<dl>
Line 10: Line 11:
<dd>All
<dd>All
<dt>Introduced
<dt>Introduced
<dd><var class="product">Sirius Mods</var> 7.3
<dd><var class="product">[[Sirius Mods]]</var> 7.3
</dl>
</dl>
==Description==
==Description==
Line 20: Line 21:
<dl>
<dl>
<dt>X'01'
<dt>X'01'
<dd>The PF key that is 1 higher than the <var>RETRVKEY</var> setting is mapped
<dd>The PF key that is 1 higher than the <var>[[RETRVKEY parameter|RETRVKEY]]</var> setting is mapped
to a forward retrieval operation, which
to a forward retrieval operation, which
returns the command in the retrieve buffer that follows the one that is currently displayed.
returns the command in the retrieve buffer that follows the one that is currently displayed.
Line 48: Line 49:


A command you enter when on the
A command you enter when on the
penultimate page of a multi-page output (like from a <var>VIEW</var> command) that
penultimate page of a multi-page output (like from a <var>[[VIEW_command|VIEW]]</var> command) that
gets processed after the next page of data is '''not''' saved in the retrieve buffer.
gets processed after the next page of data is '''not''' saved in the retrieve buffer.



Latest revision as of 09:31, 24 May 2017

Retrieve key options

Summary

Default value
X'00'
Parameter type
User
Where set
User resettable
Related products
All
Introduced
Sirius Mods 7.3

Description

This is a bitmask parameter that controls some characteristics of the Model 204 retrieve key, the 3270 terminal PF key that retrieves previously input command lines.

The meaning of the RETRVOPT bits are:

X'01'
The PF key that is 1 higher than the RETRVKEY setting is mapped to a forward retrieval operation, which returns the command in the retrieve buffer that follows the one that is currently displayed. For example, if this X'01' bit is set, and RETRVKEY is set to 6, PF7 will be a forward retrieve key. If the RETRVKEY setting is 24, specifying this X'01' bit maps the forward operation to the PF1 key.
X'02'
The forward and backward retrieve keys will not wrap. With this bit set, if you retrieve all the commands stored in the retrieve buffer, your next retrieval is a blank (instead of wrapping to the beginning of the retrieval ring, as was the behavior prior to the availability of the RETRVOPT parameter). The retrieve buffer is a virtual storage area allocated for any full screen thread that has a retrieve key set, and its size is controlled by the RETRVBUF. It is recommended that you set RETRVOPT X'02' in tandem with RETRVOPT X'01'. Otherwise, once you reach the end of the retrieve buffer, you will be unable to get at the retrieved data until you press the Enter key or some other PF key.
X'04'
Do not add to the retrieve buffer any text typed in response to a screen-full prompt. For example, if you issue a VIEW, then type C or K to stop the output, the C or K is added to the retrieve buffer — unless RETRVOPT X'04' is set. A command you enter when on the penultimate page of a multi-page output (like from a VIEW command) that gets processed after the next page of data is not saved in the retrieve buffer. RETRVOPT X'04' also prevents N, NP, or NEW commands (which clear the screen) from being added to the retrieve buffer.
X'10'
If the X'01' bit is also set, RETRVOPT X'10' maps the forward retrieve key to the PF key that is 12 greater than the current retrieve key (setting of RETRVKEY). This will be the shifted version of the current retrieve key if that current key is less than PF13, and it will be the non-shifted version if that key is greater than PF12. For example, if RETRVOPT is set to X'17' and RETRVKEY is 12, the forward retrieve key is PF24. And if RETRVOPT is set to X'17' and RETRVKEY is 21 (Shift+PF9), the forward retrieve key is PF9.