Examples--Unmounting and Mounting a Form
The following example shows the process of unmounting the currently mounted form on the printer luna.
# reject luna destination "luna" will no longer accept requests # lpadmin -p luna -M f none # accept luna destination "luna" now accepting requests |
The following example shows the process of mounting the medical form on the printer luna.
# reject luna destination "luna" will no longer accept requests # lpadmin -p luna -M f medical -a -o filebreak # accept luna destination "luna" now accepting requests |
How to Set an Alert to Mount a Form
Log in as superuser, lp, or assume an equivalent role on the print server.
Set a request alert for mounting a form.
# lpforms -f form-name -A alert [-Q requests] [-W minutes]
-f form-name
Form for which you want to set a request alert.
-A alert
Specifies what kind of alert will occur when a form is requested. See Table 5-3 for detailed information about the valid values for alert. Some valid values are mail, write, and quiet. If you choose mail or write, a predefined alert message says to mount the specified form and includes the names of one or more printers that have been set up to use the form.
-Q requests
Specifies how many print requests that require the form must be in the queue to trigger an alert. If you don't specify this option, an alert occurs with just one print request in the queue.
-W minutes
Specifies how often (in minutes) the alert will occur. If you don't specify this option, the alert is sent once.
The request alert is added in the print server's /etc/lp/forms/form-name/alert.sh file.
Verify that the alert has been added for the form by checking the output of the following command.
# lpforms -f form-name -A list
Otherwise, if you have set a low number of print requests to trigger the alert, submit print requests to meet the minimum requirement and make sure you receive an alert to mount the form.
Examples--Setting an Alert to Mount a Form
The following example shows how to set email alerts to occur every five minutes for the letterhead form when there are 10 print requests for letterhead in the print queue.
# lpforms -f letterhead -A mail -Q 10 -W 5 |
The following example shows how to set console window alerts to occur every 10 minutes for the letterhead form when there are five requests for letterhead in the print queue.
# lpforms -f letterhead -A write -Q 5 -W 10 |
The following example shows how to set no request alerts for the invoice form.
# lpforms -f invoice -A none |
How to View Information About a Form
Log in as superuser, lp, or assume an equivalent role on the print server.
Request information about a form.
# lpforms -f form-name -l
-f form-name
Form for which you want to view information. Specify all for form-name to view information about all the available forms.
-l
Lists the specified form.
Information about the specified form(s) is displayed.
Examples--Viewing Information About a Form
The following example shows how to display information about the medical form.
# lpforms -f medical -l Page length: 62 Page width: 72 Number of pages: 2 Line pitch: 6 Character pitch: 12 Character set choice: pica Ribbon color: black Comment: Medical claim form |
The following example shows how to redirect the information about the medical form to a file. (This command creates the form definition for the form.) This is useful if a form definition gets removed unintentionally.
# lpforms -f medical -l > medical.fmd |
How to View the Current Status of a Form
Log in on the print server.
Request information about the current status of a form.
$ lpstat -f form-name
-f form-name
Form for which you want to view the current status. Specify all for form-name to view the current status of all the forms.
Information about the current status of the specified form(s) is displayed.
Example--Viewing the Current Status of a Form
the following example shows how to display the status of the medical form.
$ lpstat -f medical form medical is available to you |
How to Limit User Access to a Form
Log in as superuser, lp, or assume an equivalent role on the print server.
Allow or deny users access to a form.
# lpforms -f form-name -u allow:user-list | deny:user-list
-f form-name
Name of the form for which the allow or deny user access list is being created.
-u allow:user-list
Represents users to be added to the allow access list. Use a comma or a space to separate users' login IDs. If you use spaces, enclose the list of IDs in quotes.
Table 5-5 provides the valid values for user-list.
deny:user-list
Represents users to be added to the deny user access list. Use a comma or a space to separate users' login IDs. If you use spaces, enclose the list of IDs in quotes. Table 5-5 provides the valid values for user-list.
The specified user(s) are added to the allow or deny user access list for the specified form in one of the following files on the print server:
/etc/lp/forms/form-name/allow or
/etc/lp/forms/form-name/deny
Verify the allow and deny user access lists.
# lpforms -f form-name -l
Examples--Limiting User Access to a Form
The following example shows how to allow only the users nathan and marcia access to the check form.
# lpforms -f check -u allow:nathan,marcia |
The following example shows how to deny users jones and smith access to the dental form.
# lpforms -f dental -u deny:"jones,smith" |
How to Limit Printer Access to a Form
Log in as superuser, lp, or assume an equivalent role on the print server.
Allow or deny use of forms on a printer.
# lpadmin -p printer-name -f allow:form-list | deny:form-list
-p printer-name
Name of the printer for which the allow or deny forms list is being created.
-f allow:form-list | deny:form-list
Form names to be added to the allow or deny list. Use a space or a comma to separate multiple form names. If you use spaces to separate form names, enclose the list of form names in quotes.
The specified form(s) are added to the allow or deny forms list in one of the following files on the print server:
/etc/lp/printers/printer-name/form.allow
/etc/lp/printers/printer-name/form.deny
Verify the allow and deny forms lists.
# lpstat -p printer-name -l