psmsgen(1M)															       psmsgen(1M)

NAME

       psmsgen - 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 international-
       ized 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 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 extension.

	      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 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 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):

	      o set default locale
	      o set user configuration file
	      o set output model script file name
	      o set printer installable options
	      o set default value for PPD features
	      o set default user options
	      o add or remove alias for PPD main keywords
	      o add or remove alias for PPD option keywords
	      o add or remove locale name aliases
	      o 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:

	      o show all current settings
	      o quit
	      o 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:

       o 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.

       o 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 location.

       o 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

       o 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  instal-
	 lable	options  like additional input trays or a duplexer that users can choose to purchase.  These installable options affect what capa-
	 bilities 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 prop-
	 erly 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.

       o 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.

       o 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.

       o 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.

       o 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.

       o 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.

       o Add or remove setup macros

	 The setup macro enables a user to use a easily remembered macro names to represent any combinations of options.

       o Show all current settings

	 This option displays all the configured settings.

       o Quit

	 This option causes the command to quit without making any change.

       o 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 printers.  For configuring network printers, you can use either the con-
       figuration 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 recommended
       because	it  comes  with the HP-UX operating system, and it integrates 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 command.

EXTERNAL INFLUENCES

   Environment Variables
       determines the locale to use when neither or the other category variables 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
       available 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 ALSO

       lp(1), psfontpf(1M), setnetlp(1M).

																       psmsgen(1M)