User`s guide

4-55
Printer, Plotter, and Spooler Subsystem Programming
reserved2 Reserved for future use.
pipeline Specifies a shell command to execute. Specifically:
• For l statements, specifies the shell command to run. The output of
the command is constructed into a menu.
• For v statements, specifies the shell command executed to validate
the values entered. A 0 (zero) return code indicates that the entered
value is valid.
msgid Specifies the message to be used by this statement. The field consists
of the message catalog name (CatalogName), set number
(SetNumber), and message number (MessageNumber), separated by
commas. The message catalog name and set number only need to be
specified on the first statement; null strings can be used for subsequent
statements.
defmsg Specifies the default message text to be used if a message cannot be
found in the message catalog.
Comments in a Device Configuration File
A line with a # (pound sign) character in the first column will be ignored, allowing comment
lines in the config line.
First Statement in a Device Configuration File
The first statement in the device configuration file must be the m (menu choice) statement
type. This statement specifies the menu choice displayed by the mkvirprt command when
prompting the user for the device they wish to configure.
If the message catalog name and set number are specified in this statement, null strings
can be used for the catalog name and catalog set in subsequent statements.
Setting Up Menus and Prompts in a Device Configuration File
When configuring network–attached printers, you may want to customize specific types of
information. To handle this, you can set up menus and prompts in the device configuration
file.
Menus
Menus can be constructed in two ways:
1. Using one M statement in combination with one or more m statements.
2. Using one M statement in combination with one l statement.
The M statement identifies the beginning of a menu and specifies text for the menu header,
which is displayed above the menu choices.
Each m statement specifies a different item under the menu.
The l statement specifies a shell command to be executed. The stdout from the shell
command is constructed into a menu. In the construction of the menu the \n (newline)
character is the delimiter for menu items. For example, the shell command:
echo Choice1\\nChoice2\\nChoice3
is constructed into the menu as:
1 Choice1
2 Choice2
3 Choice3