Chapter Contents

Previous

Next
SAS Companion for the OpenVMS Operating Environment

Host-Specific Frames of the FORM Window

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:

FSFORM form-name.FORM

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]

Note:   The information in the Printer Selection window is also site-dependent, so your window may look slightly different.  [cautionend]

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.  [cautionend]


OpenVMS Print File Parameters Window Frame

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]

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]

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.


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.