| SAS Companion for the OpenVMS Operating Environment |
The FSFORM command activates
a series of window frames collectively called the FORM window, which enables
you to specify the printer, text format, and destination for your output.
This capability is useful when you issue the PRINT command and when you print
from SAS/AF and SAS/FSP procedure
output. (For more information, see Routing the SAS Log and SAS Procedure Output
and the FSFORM command in the SAS online Help.)
To invoke the FORM window, issue the following command:
The first frame that you see after issuing the FSFORM
command is the Printer Selection window. This window enables you to specify
which printer you want to use. Printer Selection Window shows the default
information for this window under OpenVMS.
Printer Selection Window
![[IMAGE]](./images/01319563.gif)
Note: The information in the Printer
Selection window is also
site-dependent, so your window may look slightly different. ![[cautionend]](../common/images/cautend.gif)
The Printer Selection window appears only the first
time you create a print form. After you modify a form, it is stored in your SASUSER.PROFILE catalog
(entry type FORM).
The next time you modify this form, the Printer Selection
window is skipped. You cannot return to the Printer Selection window from
the second FORM window frame.
The third FORM window frame is also host-specific. This
frame has two parts: the OpenVMS Print
File Parameters window frame and the OpenVMS Job
and Page Definitions window frame.
Note: The information
in these window frames is site-dependent, so your window frames may look slightly
different from those shown in OpenVMS Print File Parameters Window Frame and
OpenVMS Job and Page Definitions Window.
The first part of the third FORM window is
the
OpenVMS Print
File Parameters window frame (shown in OpenVMS Print File Parameters Window Frame). The OpenVMS print
file parameters displayed in this window frame are the same parameters that
you would use in an OpenVMS PRINT command.
This window frame provides field-specific help. To receive help on a field,
place your cursor on that field and press the HELP function key. In addition
to the help given in this window, you can also request help on the PRINT command
by using the OpenVMS Help Facility.
OpenVMS Print File Parameters Window Frame
![[IMAGE]](./images/01319564.gif)
The following fields appear in the
OpenVMS Print
File Parameters window frame:
- Printer queue
- sends output to the specified queue. If
no queue is specified, the default is SYS$PRINT.
Filling in this field is equivalent to using the QUEUE= option in the OpenVMS PRINT
command. Do not include quotation marks in the queue specification. The value
can contain up to 31 characters.
- Job name
- specifies the output name. The name is specified
using 1 to 39 alphanumeric characters. The default is the name of the file
being submitted. Filling in this field is equivalent to using the NAME= option
in the OpenVMS PRINT command, except
that the job name cannot contain any spaces or quotation marks.
Issuing the SHOW QUEUE command from the DCL prompt displays
the job name. The job name is also printed on the flag page for the output.
- Number of copies
- specifies the number of copies of the output
that you want to receive. The number of copies defaults to 1, but it can be
specified from 1 to 255. Filling in this field is equivalent to using the COPIES= option
in the OpenVMS PRINT command.
- Job characteristics
- specifies one or more characteristics, separated
by commas, for your output. The list of characteristics cannot contain any
spaces. For example, you can specify the following:
LOWER,DOUBLE
Job characteristics are site- and printer-specific;
see your system manager for information on what characteristics are available
for your printers. Filling in this field is equivalent to using the CHARACTERISTICS= option
in the OpenVMS PRINT command, except
that the specification may not include parentheses or quotation marks.
- Parameters
- specifies one or more parameters, separated
by commas, for your output. The list of parameters cannot contain any spaces.
These parameters are site-specific; see your system manager for information
on what parameters are available. Filling in this field is equivalent to using
the PARAMETERS= option in the OpenVMS PRINT
command, except that the specification cannot include parentheses or quotation
marks. You can specify up to eight parameters.
- Date/time for print
- can be used to hold the output until the
date and time specified. Use absolute date and time to specify the day and
time the output is printed. (That is, specify 12:00, not "3 hours from
now.") Enter values from left to right. You do not need to fill in each
field, but each field to the left of one that is entered must be filled in.
Filling in this field is equivalent to using the AFTER= option
in the OpenVMS PRINT command, except
that the date and time specification cannot include quotes.
- Job termination parameters:
-
- Do not notify when done
- specifies whether you are notified when
the output has been printed. By default, you are notified when your job is
finished. Filling in this field is equivalent to using the NOTIFY= option
in the OpenVMS PRINT command.
- Do not restart
- specifies whether to restart the printing
of the output when a crash occurs or if a stop/requeue command is issued.
By default, jobs are restarted. This field is equivalent to using the RESTART= option
in the OpenVMS PRINT command.
|
| OpenVMS Job and Page Definitions Window Frame |
The second part of the third FORM window frame is
the OpenVMS Job
and Page Definitions window frame. This
window frame is shown in OpenVMS Job and Page Definitions Window. You display this window frame by placing the cursor on the SELECT
field at the bottom of the OpenVMS Print
File Parameters window frame (described in OpenVMS Print File Parameters Window Frame) and pressing RETURN.
OpenVMS Job and Page Definitions Window
![[IMAGE]](./images/01319565.gif)
The following fields appear in the
OpenVMS Job
and Page Definitions window frame:
- Print form name:
- specifies the name of the form that is used
for the print queue. Filling in this field is equivalent to using the FORM=
option in the OpenVMS PRINT command.
These forms are site-dependent. See your system manager for information about
which forms are available.
- Flag page message:
- specifies the message to be printed on the
flag page. Filling in this field is equivalent to using the NOTE= option in
the OpenVMS PRINT command, except that
the message cannot contain any spaces or quotation marks.
- Job definition parameters
-
- Print flag page
- controls whether a flag page is printed
before the output. The flag page displays the name of the user submitting
the output and other information about the output being printed. By default,
no flag page is printed. Filling in this field is equivalent to using the
FLAG= option in the OpenVMS PRINT command.
- Print burst page
- specifies whether a flag page is printed
over the perforation in the paper so that the output is easily identified.
By default, no burst page is printed. Filling in this field is equivalent
to using the BURST= option in the OpenVMS PRINT
command.
- Print trailer page
- specifies whether to print a trailer page
at the end of the output. The trailer page has the name of the user submitting
the output and other information about the output being printed. By default,
no trailer page is printed. Filling in this field is equivalent to using the TRAILER= option
in the OpenVMS PRINT command.
- Passall
- specifies whether all formatting is bypassed
and sent to the printer with formatting suppressed. By default, formatting
is used. Filling in this field is equivalent to using the PASSALL= option
in the OpenVMS PRINT command.
- Page definition
parameters
-
- Form feed
- specifies whether form feeds occur within
the last four lines of the page when printing is taking place. By default,
no form feeds are performed. Filling in this field is equivalent to using
the FEED= option in the OpenVMS PRINT
command.
- Double space
- specifies whether to double-space the output.
By default, the output is single-spaced. Filling in this field is equivalent
to using the SPACE= option in the OpenVMS PRINT
command.
- Title each page
- specifies whether to print a title on each
page of output. By default, no titles are printed. Filling in this field is
equivalent to using the HEADER= option
in the OpenVMS PRINT command.
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.
