psmsgen(1M)psmsgen(1M)NAMEpsmsgen - model script configuration utility for psfontpf
SYNOPSIS
model-script-name] [ppd-file]
printer-model] model-or-interface-script
DESCRIPTION
The command is a terminal-based interactive model script configuration
tool for configuring the model script that uses the internationalized
PostScript print filter.
This command can only be run by a user with superuser privilege.
The prerequisite for configuring a certain PostScript printer is the
availability of an Adobe PostScript printer description file (PPD) for
that printer. That PPD file can be searched and copied from a Micro‐
soft Windows system with the corresponding PostScript print driver
installed. The generic model script can still be used directly without
any configuration, but many of the device specific capabilities of the
PostScript printer will not be available for use.
The command is used to either create a new model script or modify an
existing model script. However, the command cannot be used to modify
the generic model script.
The command also embeds a usage message into the created or modified
model scripts. This usage message explains what command line options
are available. This usage message will be displayed when the model
script is run without any argument.
Options
The command recognizes the following options:
Specify the name of the output model script to be created.
By default, the output model script name is where ppd-
name is the name of the PPD file without the .ppd exten‐
sion.
Specify the model or interface script to be modified.
With no path prefix, the model or interface script will
be searched from the following directories:
1)
2)
3)
4)
Specify the model name of the printer being configured. If the
model name
matches that of one of the existing PPD files, that PPD
file will be selected automatically.
If no PPD file, ppd-file, is specified in the command line, or the
interface script to be modified has no PPD file specified, or the
printer model name does not match any of the existing PPD files, the
command will display a list of PPD files for the user to choose from
the directory. The command display is a two-level selection menu and
the user has to choose the printer manufacturer and color or black and
white printer first, and then the list of PostScript printers in that
category.
If a PPD file is specified without a full pathname, the PPD file is
assumed to be from the directory also. Even though the command allows
the use of PPD file in other non-system directories, HP recommends that
the new PPD files should be copied to the default directory for easier
maintenance and better availability as the configured model script may
not work correctly if the PPD file that it uses is missing. The com‐
mand provides an PPD import option to do just that.
There are two ways to configure a model script. One way is to configure
the interface script with the option after the LP spooling system for a
printer is set up. The other way is to create a new configured model
script for a particular type of printer in the directory. The former
way is preferred for configuring a single PostScript printer or several
different PostScript printers. The latter way is more appropriate for
configuring a group of similar printers at the same time.
After the command is entered, the user is allowed to configure any of
the following settings (see the section):
· set default locale
· set user configuration file
· set output model script file name
· set printer installable options
· set default value for PPD features
· set default user options
· add or remove alias for PPD main keywords
· add or remove alias for PPD option keywords
· add or remove locale name aliases
· add or remove setup macros
The "set output model script file name" setting is not available if the
option is used to modify an existing script. For the first two or
three configuration settings with non-numeric values within the square
bracket, those values represent the currently selected values for those
settings. For the remaining configuration settings with numeric values
within the square bracket, those values can be one of the following:
1. The number of defined entries for that configuration setting.
2. The number of PPD main keywords that have assigned an option
keyword value that differs from the PPD default.
If the option is used to modify an existing model or interface file,
the third item for setting output model script name will not display.
Only the first two settings will have their values shown directly in
the square bracket.
There are also three more options that the user can choose. They are:
· show all current settings
· quit
· save changes and exit
Each selectable option shown by this command is prefixed by a number.
You enter the number to select the corresponding option.
The following paragraphs describe each of the configuration settings in
more details:
· Set default locale
The configured model script can have a default locale defined so that
text or PostScript input data are processed under that locale if no
explicit locale is defined on the command line.
By default, the current locale will be used unless the selected PPD
file is a localized version. In that case, the corresponding local
language locale will be used for those that are recognized by the
command.
The locale is important for selecting the right fonts and parsing
input text file correctly.
· Set user configuration file
The user configuration file is useful for specifying custom font
information to the print filter.
By default, the system-provided configuration files in the directory
will be listed if this option is chosen. However, the user is also
provided the option to enter a user configuration file at any loca‐
tion.
· Set output model script file name
This setting is only shown when creating a new model script. This
setting allows the user to choose a name other than the default used
by
· Set printer installable options
This is perhaps the first and the most frequently used setting in
this command. Most of the PostScript printers have additional
installable options like additional input trays or a duplexer that
users can choose to purchase. These installable options affect what
capabilities a printer has.
For instance, if the printer has a duplexer installed but the
duplexer installable option is not set in the print filter will not
be able to print in duplex mode even if the appropriate option is
turned on at the command line. Make sure all the installed options
are properly selected in this configuration setting to fully unleash
the capability of the printer. These installable options should also
be defined first before other PPD related parameters are modified.
· Set default value for PPD features
If no default value is set, the default values specified in the PPD
file will be used. However, those default values may not be optimal.
This option allows the user to select default values for all the sup‐
ported PPD features. For example, you can turn on duplexing by
default or select paper from the large capability tray.
· Set default user options
This option is used to set the default values for non-PPD related
features. For example, the option can be used here to specify that
the banner page always comes from a specific input tray.
· Add or remove alias for PPD main keywords
A PPD main keyword is the keyword part of the command line option
that you supply to the print filter. Typical PPD main keyword names
are very verbose. This option is helpful to define alias names that
will be easier to type or easier to remember for those PPD main key‐
words.
· Add or remove alias for PPD option keywords
A PPD option keyword is the option part of the command line option
you supply to the print filter. Typical PPD option keyword names are
very verbose. This option is helpful to define alias names that will
be easier to type or easier to remember for those PPD option key‐
words.
· Add or remove locale name aliases
This option is helpful to define easier to remember alias name for
HP-UX system locales. For example, the alias name can be defined for
the ja_JP.SJIS locale.
· Add or remove setup macros
The setup macro enables a user to use a easily remembered macro names
to represent any combinations of options.
· Show all current settings
This option displays all the configured settings.
· Quit
This option causes the command to quit without making any change.
· Save changes and exit
This option prompts the user about saving changes to the specified
model or interface script.
Configuring Network Printers
The system management homepage can be used for configuring local print‐
ers. For configuring network printers, you can use either the configu‐
ration command or use the command in the optional HP JetDirect Printer
Installer for Unix software.
The network printer setup capability of the command depends on the
presence of the above HP JetDirect software. The command is recom‐
mended because it comes with the HP-UX operating system, and it inte‐
grates well with the command. This command sets up a network printer
using the LPD or JetDirect printing protocol. The LPD print queue name
is usually "AUTO" for HP printers.
For other printers, you may need to consult the documentation or the
configuration web page to find out what print queue name should be
used. See the setnetlp(1M) manpage for details on how to use this com‐
mand.
EXTERNAL INFLUENCES
Environment Variables
determines the locale to use when neither or the other category vari‐
ables specify a locale.
determines locale to be used. It overrides any values specified by or
any other variables.
EXAMPLES
When the command is invoked without any argument, the following printer
selection menus may be displayed depending on what PPD files are avail‐
able in the directory:
*** PostScript Printer Configuration ***
Please select one of the following manufacturer and printer types
1) HP black & white printers
2) HP color printers
i) Import an external PPD file
Please select an item, or press <CR> to quit: 1
*** PostScript Printer Configuration ***
Please select one of the following PPD files
1) HP LaserJet 1300 PS (hpc1300s.ppd)
2) HP LaserJet 2200 Series (hpb22007.ppd)
3) HP LaserJet 2300 PS (hpc2325s.ppd)
4) HP LaserJet 2300L PS (hpc2320s.ppd)
5) HP LaserJet 2410 PS (hpc2410s.ppd)
6) HP LaserJet 2420 PS (hpc2420s.ppd)
7) HP LaserJet 2430 PS (hpc2430s.ppd)
8) HP LaserJet 3015 PS (hpc3015s.ppd)
9) HP LaserJet 3020 PS (hpc3020s.ppd)
10) HP LaserJet 3030 PS (hpc3030s.ppd)
11) hp LaserJet 3050 PS (hpc3050s.ppd)
12) HP LaserJet 3380 PS (hpc3380s.ppd)
13) hp LaserJet 3390 PS (hpc3390s.ppd)
14) HP LaserJet 4100 PS (hpb41007.ppd)
15) HP LaserJet 4200 PS (hpc4200s.ppd)
16) HP LaserJet 4200L PS (hpc420xs.ppd)
17) HP LaserJet 4240 PS (hpc4240s.ppd)
18) HP LaserJet 4250 PS (hpc4250s.ppd)
19) HP LaserJet 4300 PS (hpc4300s.ppd)
20) HP LaserJet 4345 mfp PS (hpc4345s.ppd)
21) HP LaserJet 4350 PS (hpc4350s.ppd)
22) HP LaserJet 5000 Series (hp5000_7.ppd)
23) HP LaserJet 5100 (hp5100_7.ppd)
24) HP LaserJet 8150 PS (hpb81507.ppd)
25) HP LaserJet 9000 PS (hpb90007.ppd)
26) HP LaserJet 9040 mfp PS (hpc904ms.ppd)
27) HP LaserJet 9050 mfp PS (hpc905ms.ppd)
28) HP LaserJet 9050 PS (hpc9050s.ppd)
29) HP LaserJet 9055 MFP PS (hpc9055s.ppd)
30) HP LaserJet 9065 MFP PS (hpc9065s.ppd)
Please select an item, or press <CR> to quit:
After selecting the HP LaserJet 9000 printer (25), the following menu
may be displayed:
*** PostScript Printer Configuration ***
Current printer model = HP LaserJet 9000 PS
Please select one of the following actions
1) Set default locale [C]
2) Set user configuration file [None]
3) Set output model script file name [PS.hpb90007]
4) Set printer installable options [0]
5) Set default values for PPD features [0]
6) Set default user options [0]
7) Set paper size to input tray mapping [0]
8) Add/Remove alias for PPD main keywords [0]
9) Add/Remove alias for PPD option keywords [0]
10) Add/Remove locale name aliases [0]
11) Add/Remove setup macros [0]
s) Show all current settings
q) Quit
x) Save changes and exit
Please select an item:
AUTHOR
The command was developed by HP.
FILES
Model script that uses the print filter.
Directory for holding Adobe PPD files.
Directory for holding various configuration files.
SEE ALSOlp(1), psfontpf(1M), setnetlp(1M).
psmsgen(1M)
