Previous Page | Next Page

The FSLETTER Procedure

FSLETTER Command

Initiates an FSLETTER session.
FSLETTER <? | SAS-catalog<.catalog-entry>>
Arguments

The following arguments can be used with the FSLETTER command:

?

opens a selection window from which you can choose the catalog that is used by the FSLETTER procedure. You can select the catalog interactively by pointing and clicking in the selection lists, or you can specify the desired catalog explicitly in the Member Name field. Once you specify the catalog, an Explorer window opens showing the contents of the specified catalog. From the Explorer window, you can select an existing entry or create a new entry.

SAS-catalog<.catalog-entry>

specifies the catalog in which documents, forms, and editor parameters for the FSLETTER session are stored and, optionally, the specific entry. The complete form of the argument is

<libref.>catalog-name<.entry-name<.entry-type>>
You can specify a one-, two-, three-, or four-level name:

  • If a one-level name is specified, it is treated as a catalog name in the default library, WORK. If the specified catalog does not already exist in the WORK library, it is created.

    Remember that all catalogs in the WORK library are erased when you end your SAS session.

  • If a two-level name is specified, it is treated as libref.catalog-name. If the specified catalog does not already exist in the specified library, it is created.

  • If a three-level name is specified, it is treated as libref.catalog-name.entry-name. The entry type is assumed to be LETTER. If the specified catalog does not already exist in the specified library, it is created.

  • If a four-level name is specified, the fourth level should be EDPARMS, FORM, or LETTER. Invalid catalog entry types are ignored; LETTER is used instead. If the specified catalog does not already exist in the specified library, it is created.

If you use a one- or two-level name, the procedure initially opens an Explorer window, from which you can select an existing entry or create a new entry in the specified catalog.

If you use a three- or four-level name, the procedure opens the appropriate window for creating or editing the specified entry:

  • If the entry type is LETTER, or if the entry type is omitted, an FSLETTER window is opened.

  • If the entry type is FORM, a FORM window is opened.

  • If the entry is FSLETTER.EDPARMS, an EDPARMS window is opened.

The procedure terminates with an error message if you specify an entry type that is not supported by the FSLETTER procedure.

If you do not specify any of these arguments, the selection window that was described for the ? argument is opened.

Using the FSLETTER Command

The FSLETTER command is a convenient way to open the FSLETTER window because it can be issued in any SAS System window. When you end an FSLETTER session that was initiated with the FSLETTER command, you return to whatever window was active when the command was issued.

Previous Page | Next Page | Top of Page

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