SET RETRIEVE

Read syntax diagramSkip visual syntax diagram Set RETrieve MAXimummmm1nnn
Notes:
  • 1 The mmm value may be specified only by class C or E users.

Authorization

Privilege Class: C, E, G

Purpose

Use SET RETRIEVE to allocate a specific number of program function key retrieve buffers for your virtual machine and to change the maximum number of program function key retrieve buffers that users may request.

Operands

MAXimum
sets the number of program function key retrieve buffers available to your virtual machine to the maximum allowed. To set the maximum allowed, you can either use the class C and E SET RETRIEVE command or enter the information in the system configuration file using the FEATURES statement.
mmm
sets the maximum number of program function key retrieve buffers available to any virtual machine on the system to mmm. The value of mmm cannot exceed 255.
nnn
sets the number of program function key retrieve buffers available to your virtual machine to nnn. The value of nnn cannot exceed the previously defined maximum, which was set either with the FEATURES statement in the system configuration file or with the privileged version of the SET RETRIEVE command.

Usage Notes

  1. Reducing the maximum value mmm for program function key retrieve buffers does not affect the current program function key retrieve definitions for any user. Retrieve buffers are not deleted from users that exceed any newly established maximum.
  2. After a Class C or Class E user has increased the maximum possible number of retrieve buffers, users do not have to log off to increase the number of program function key retrieve buffers available to their own virtual machines. A new SET RETRIEVE command can be used to increase the number of program function key retrieve buffers without affecting the contents of the existing buffers.
  3. For more information on displaying the current number of program function key retrieve buffers available to your virtual machine and the maximum number of buffers that any user may request, see the QUERY RETRIEVE command.

Examples

If you issue a SET PFn with no parameters (for the PF key you had assigned to RETRIEVE), the number of buffers is set to zero, making your RETRIEVE ineffective. 
 q pf1
 PF01 RETRIEVE BACKWARD
 q retrieve
 7 buffers available.  Maximum of 20 buffers may be selected.
 Ready; T=0.01/0.01 16:06:56
 set pf1
 Ready; T=0.01/0.01 16:07:04
 q retrieve
 0 buffers available.  Maximum of 20 buffers may be selected.
 Ready; T=0.01/0.01 16:07:08
If you have two pf keys set for RETRIEVE, for example PF1 and PF12 and you set PF12 to undefined: 
q pf1
PF01 RETRIEVE BACKWARD
Ready; T=0.01/0.01 16:18:52
q pf12
PF12 RETRIEVE BACKWARD
Ready; T=0.01/0.01 16:18:58
q retrieve
7 buffers available.  Maximum of 20 buffers may be selected.
Ready; T=0.01/0.01 16:19:08
set pf12
Ready; T=0.01/0.01 16:19:15
q retrieve
7 buffers available.  Maximum of 20 buffers may be selected.
Ready; T=0.01/0.01 16:19:20
then it does NOT set the buffer to zero.
SET RETRIEVE works to set a number of buffers for you even if you have no pf keys set to retrieve. However, if you then set your all your pf keys to null, the retrieve buffer is set to zero. Suppose you have only two pf keys set, PF3 and PF5: 
q pf
PF01 UNDEFINED
PF02 UNDEFINED
PF03 IMMED INFOLIST
PF04 UNDEFINED
PF05 IMMED EXEC MAILBOX
PF06 UNDEFINED
      .
     .
PF24 UNDEFINED
Ready; T=0.01/0.01 17:05:03
and you set retrieve but then set PF3 and PF5 to null: 
set retrieve 12
Ready; T=0.01/0.01 17:01:10
q retrieve
12 buffers available.  Maximum of 20 buffers may be selected.
Ready; T=0.01/0.01 17:01:14
set pf3
Ready; T=0.01/0.01 17:01:25
set pf5
Ready; T=0.01/0.01 17:01:29
q retrieve
0 buffers available.  Maximum of 20 buffers may be selected.
Ready; T=0.01/0.01 17:01:33
Your buffer is set to zero.

Messages

  • HCP002E Invalid operand - operand
  • HCP003E Invalid option - command contains extra option(s) starting with operand
  • HCP6704E Missing token at end of line