FORMSALIGN [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation
MPE/iX Commands Reference Manual Volume I
FORMSALIGN
Configures one spooled printer or a group of spooled printers related by
device class, to conditionally enter into a forms message dialog with its
operator (s) when the current spoolfile includes a forms message.
Syntax
{ldev }
FORMSALIGN [DEV=] {devclass}
{devname }
[ {{EACHCHANGE} }]
[;[DIALOG=] {{EACHFILE } [, {FORMIDOVERRIDE }]}] [;SHOW]
[ {{EACHCOPY } [ {NOFORMIDOVERRIDE}]}]
Parameters
ldev The logical device number of a printer. The
printer must be configured as an MPE Type 32
device.
devclass The device class name of a class of printers. Each
printer in the class must be configured as an MPE
Type 32 device. The device class must begin with a
letter and consist of eight or fewer alphanumeric
characters.
devname The device name of a printer. The device name must
begin with a letter and consist of eight or fewer
alphanumeric characters. Users should note that it
is not possible to have a device class name and a
device name (which are the same). If you enter an
alphanumeric character string, the command will
search the device class list first, and then the
device name list.
EACHCHANGE The spooler process conducts the forms message
dialog only when the (case-insensitive) forms
message of the current spoolfile differs from that
of the previous spoolfile printed by that process
when an overriding formid specification is not in
effect. Two different spoolfiles with the same
forms message will print without the forms message
dialog if they are printed consecutively.
EACHFILE The spooler process conducts the forms message
dialog whenever the spoolid of the current
spoolfile differs from that of the previous
spoolfile printed by that process, the current
spoolfile contains a forms message and an
overriding formid specification is not in effect.
Two copies of the same spoolfile will print without
the forms message dialog if they are printed
consecutively.
EACHCOPY The spooler process conducts the forms message
dialog for every copy of every spoolfile which
contains a forms message if an overriding formid
specification is not in effect.
FORMIDOVERRIDE This is a sub-parameter of the chosen EACHxxx
keyvalue. With this feature selected, the Native
Mode Spooler first checks its current and previous
spoolfiles for the same non-blank, case-insensitive
formid. If the formids match, both the DIALOG
option for the spooler process and any
forms message in the current spoolfile are
ignored, and the forms message dialog is not
activated. Identical formids override all other
considerations.
Note that the DIALOG option is not changed. It is
ignored as long as the two formids match.
If the two formids do not match, and the formid of
the current spoolfile is not empty, then the
spooler conducts the forms message dialog using the
forms message of the current spoolfile.
If the current spoolfile has no forms message (even
though it has a forms identification), the spooler:
* Conducts no dialog if standard forms are
already mounted.
* Displays the STANDARD FORMS message if
special forms are mounted.
If the two formids do not match because the current
spoolfile has no formid and the previous spoolfile
did, the spooler will always conduct a forms
message dialog, again ignoring any setting of
DIALOG. If the current spoolfile has a non-empty
forms message, the spooler conducts a normal forms
message dialog with the device operator. If the
forms message is empty, and the device has special
forms mounted, the spooler prompts the device
operator to mount standard forms.
Once both the previous spoolfile and the current
spoolfile have no formids, the spooler operates in
accordance with the selected DIALOG option once
more.
NOFORMIDOVERRIDE This is a sub-parameter of the chosen EACHxxx
keyvalue. With this feature selected, the Native
Mode Spooler ignores any and all formids associated
with the current spoolfile or the previous
spoolfile. The setting of the DIALOG option always
determines the conditions under which the spooler
process conducts the forms message dialog. The
formid is then useful only as an item in a
selection equation.
__________________________________________________
NOTE The setting of (NO)FORMIDOVERRIDE only
affects the spooler's function during the
forms message dialog. It has no effect on
the use of the FORMID keyword in a selection
equation of either the SPOOLF or LISTSPF
command. It is still possible to select a
subset of all spoolfiles to alter, delete, or
display on FORMID=, regardless of the setting
(NO)FORMIDOVERRIDE for a given device. They
are totally independent of each other.
If the current spoolfile has no forms message
but special forms are mounted on the device,
the spooler always conducts the STANDARD
FORMS dialog.
__________________________________________________
SHOW Specifying this option causes the configuration for
the specified devices to be displayed. If no other
parameters are used, the current configuration is
displayed. If other parameters are used, the
configuration is first updated and then displayed.
If a device class is specified, the configuration
for each device in the class is displayed.
If this option is omitted, there is no display.
Operation Notes
The FORMSALIGN command can be used on a spooled or an unspooled printer,
or on a device class containing any mixture of spooled and unspooled
printers. When used on a spooled printer, the specified options become
effective on the next copy selected for printing on that device. The
choices are retained until changed by another FORMSALIGN command, even if
the printer should become unspooled and a new spooler process started for
it.
When used on an unspooled printer, it presently has no effect but will be
retained (unless changed by another FORMSALIGN command) and will become
effective immediately upon spooling the printer. Files which include a
forms message, and which are directed to an unspooled printer, always
trigger a forms message dialog with the printer's operator. Any formid
accompanying the file is irrelevant when the file is directed to an
unspooled printer.
NOTE This command effects more than one device (if applied to all
devices in a class). You may get warning messages for some devices
and not others. A warning message on one or more devices affects
only that device. The command will continue to execute until all
selected devices have been configured or shown, or an error is
detected. An error terminates the command.
The options specified in the FORMSALIGN command are stored in the
appropriate device files. For example, options for LDEV 6 are stored in
file 00000006.DEVICES.3000devs. This is why the options are retained
even when no spooler process exists for LDEV 6.
However, these device files are reconstructed at each system startup.
The FORMSALIGN options set at that time are EACHCHANGE, FORMIDOVERRIDE.
Your SYSSTART file should include one FORMSALIGN command per device or
class for which you want to set options other than the default.
Use
This command may be issued from a session, job, program, or in BREAK. Any
user may execute this command with only the ;SHOW option to display
current configuration. When changing configuration, this command may be
executed only from the console or by any user who has been allowed the
FORMSALIGN command with the ALLOW command. You can also execute this
command by assigning a user the ASSOCIATE command and specifying the
device.
Examples
To display the current configuration, enter:
FORMSALIGN LP;SHOW
A sample of the output might look like the following:
FORMID
LDEV DEVNAME DIALOG OVERRIDE
6 LDEV6 EACHCHANGE YES
14 LDEV14 EACHCOPY NO
15 LDEV15 EACHFILE YES
19 LDEV19 EACHCHANGE NO
To conduct a forms message dialog for each copy of each file printed,
enter:
FORMSALIGN 6;DIALOG=EACHCOPY,NOFORMIDOVERRIDE
You may also specify the system startup options, for example:
FORMSALIGN 6;DIALOG=EACHCHANGE,FORMIDOVERRIDE
Related Information
Commands SPOOLER, ALLOW, ASSOCIATE
Manuals Performing System Operation Tasks (32650-90137)
MPE/iX 5.0 Documentation