User`s guide

4-51
Printer, Plotter, and Spooler Subsystem Programming
M Specifies a multi–select list which allows users to select more than one value
from a given list of options. The M operator works exactly like the L operator list
except that the multi–select field must be set to an m value.
An example of a multi–select list operator entry is:
:100:_l:M[print ”50\n55\n60\n65”]:60
R Specifies an option ring type of list. The op_type field is set to r . A ring list
differs from a regular list in that the user can continue to display list options by
pressing either the tab (forward) or backtab (reverse) keys. When a ring list
reaches the bottom of the options, it recycles to the top of the list. The ring list
recycles in forward or reverse. A ring list becomes a regular list when the F4 key
is pressed.
The option ring operator can control the disp_values , aix_values ,
values_msg_file , values_msg_set , and value_smg_id fields. The no
message ID, just a message ID, message set and ID, or message set, catalog
and ID are valid in a ring option list.
Validity checking is done if direct entry by the user is prohibited with the entry type
value set to n. The ring has hardcoded values that are either stand–alone or are
mapped to AIX values.
An example of stand–alone values would include a list of possible baud rates (
’1200,2400,9600,19200’ ) where the rate values themselves are used as
the flag arguments.
An example of mapped values would be an attribute to designate which paper
drawer on the printer is to be used. In this example, the three possible display
values are lower drawer, upper drawer, and envelope feed. These possibilities are
mapped to AIX flag operands ’0,1,2’ . The AIX values are passed to the
executed command.
Validity checking verifies that the attribute value is within the set of hardcoded
values. The following examples illustrate several types of option ring lists:
:100:_l:R[0,1,2]:0
:100:_l:R[none,full,emulator=0,1,2]:0
:100:_l:R[;none,full,emulator=0,1,2]:0
:100:_l:R[21,none,full,emulator=0,1,2]:0
:100:_l:R[1,21;none,full,emulator–0,1,2]:0
:100:_l:R[pioattr9.cat,1,21;none,full,emulator=0,1,2]:0
T Allows multiple selections to be made from a pop up list and works identical to
the R operator. The multi–select field equals m .
To allow multiple choices to be made from a pop up menu, enter:
:100:_l:T[none,full,emulator=0,1,2]:0
V Specifies additional validation for any attribute. The V operator does not affect
how an ODM stanza is built for an attribute. The data specified with the V operator
is colon file type code (% operators). The % operators do the validation. The
colon file code resolves to one value. The value is either 0 or non–zero. If the
resolved value is 0, then the attribute value is valid. If the value is non–zero, then
the attribute value is invalid.
To verify that the value of _l is in the range 0 to 100, enter:
:100:_l:V[%?%G_l%{100}%>%t1%e%?%G_l%{0}%<%tl%e0%;%;]:60