Initiates a BUILD session.
The BUILD command can
be issued from any SAS window. Each BUILD command starts a separate
BUILD session, so you can have several BUILD sessions running at the
same time, each building different entries in the same or different
catalogs. If you attempt to open an entry that is already open for
editing in a different BUILD session, it is opened for browsing rather
than editing.
BUILD
<<libref.>catalog-name<.entry-name<.entry-type>>>
<RESOURCE=<libref.catalog-name.>resource-name<.RESOURCE>>
<libref.>catalog-name<.entry-name<.entry-type>>
specifies the catalog
or catalog entry to open. Argument values are interpreted as follows:
-
A one-level name (
catalog-name)
identifies a catalog in the default library, WORK. Remember that
the contents of the WORK library are deleted when the SAS session
ends.
-
A two-level name (
libref.catalog-name)
identifies a catalog in a specified library.
-
A three-level name (
libref.catalog-name.entry-name)
identifies a PROGRAM entry in a specified catalog.
-
A four-level name (
libref.catalog-name.entry-name.entry-type)
identifies an entry of a specified type in a specified catalog.
The form of the argument
determines which window the BUILD command opens, as follows:
-
If you supply a one- or two-level
name, an Explorer window opens to display the contents of the catalog.
You can then select an existing entry in the catalog to edit, or you
can create a new catalog entry.
-
If you supply a three-level name,
the DISPLAY window opens for editing the specified PROGRAM entry.
-
If you supply a four-level name,
the appropriate window opens for the specified entry type.
See
BUILD Procedure Windows for information about the corresponding
window for each entry type. If you specify an entry name that does
not already exist, a new entry of the specified type is created. Refer
to
SAS/AF Catalog Entry Types for information about the uses of
the different catalog entry types.
If you issue a BUILD
command with no catalog or entry name argument, a SAS Explorer window
opens, from which you can select a library and catalog and then either
select an existing catalog entry or create a new catalog entry.
RESOURCE=<libref.catalog-name.>resource-name<.RESOURCE>
specifies the RESOURCE
entry that is associated with all FRAME entries during the current
build session, and also after the current session closes. The resource
name is saved in the SAS Registry in the key named Resource under
Products\AF\Design Time\Frame. All FRAME entries use the value of
this key to specify their default RESOURCE.
The
resource-name value
must be the name of an existing RESOURCE entry. If you omit the
libref.catalog-name value,
the procedure looks for the specified RESOURCE entry in the current
catalog, which is identified in the CATALOG= option.
To return the Resource
key back to its original value, you can use the RESOURCE command,
the RESOURCE= option, or the REGEDIT command.