psmsgen(1M)

NAME

psmsgen — model script configuration utility for psfontpf

SYNOPSIS

/usr/sbin/psmsgen [-o model-script-name] [ppd-file]

/usr/sbin/psmsgen [-p printer-model] -m model-or-interface-script

DESCRIPTION

The psmsgen command is a terminal-based interactive model script configuration tool for configuring the PS.font model script that uses the psfontpf 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 Microsoft Windows system with the corresponding PostScript print driver installed. The generic PS.font 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 psmsgen command is used to either create a new model script or modify an existing model script. However, the psmsgen command cannot be used to modify the generic PS.font model script.

The psmsgen 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 psmsgen command recognizes the following options:

-o model-script-name

Specify the name of the output model script to be created. By default, the output model script name is PS.ppd-name where ppd-name is the name of the PPD file without the .ppd extension.

-m model-or-interface-script

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): /usr/lib/lp/model
2): /etc/lp/interface/netlp.asx
3): /etc/lp/interface/model.orig
4): /etc/lp/interface

-p printer-model

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 /usr/lib/lp/psfontpf/ppd 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 /usr/lib/lp/psfontpf/ppd 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 /usr/lib/lp/psfontpf/ppd 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 psmsgen command 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 -m 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 /usr/lib/lp/model 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 psmsgen command is entered, the user is allowed to configure any of the following settings (see the EXAMPLES 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 -m 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 -m 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 psmsgen 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 psfontpf print filter.
By default, the system-provided configuration files in the /usr/lib/lp/psfontpf/pscf 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 location.
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 psmsgen.
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 psmsgen, the psfontpf 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 supported 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 btray 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 keyword=option command line option that you supply to the psfontpf 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 keywords.
Add or remove alias for PPD option keywords
A PPD option keyword is the option part of the keyword=option command line option you supply to the psfontpf 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 keywords.
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 sjis 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 psfontpf options.
Show all current settings
This option displays all the configured settings.
Quit
This option causes the psmsgen 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 smh system management homepage can be used for configuring local printers. For configuring network printers, you can use either the setnetlp configuration command or use the hppi command in the optional HP JetDirect Printer Installer for Unix software.

The network printer setup capability of the smh command depends on the presence of the above HP JetDirect software. The setnetlp command is recommended because it comes with the HP-UX operating system, and it integrates well with the psmsgen 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 command.

EXTERNAL INFLUENCES

Environment Variables

LANG determines the locale to use when neither LC_ALL or the other category variables specify a locale.

LC_ALL determines locale to be used. It overrides any values specified by LANG or any other LC_* variables.

EXAMPLES

When the psmsgen command is invoked without any argument, the following printer selection menus may be displayed depending on what PPD files are available in the /usr/lib/lp/psfontpf/ppd 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 psmsgen command was developed by HP.

FILES

/usr/lib/lp/model/PS.font: Model script that uses the psfontpf print filter.
/usr/lib/lp/psfontpf/ppd: Directory for holding Adobe PPD files.
/usr/lib/lp/psfontpf/pscf: Directory for holding various configuration files.