Chapter Contents


The BUILD Procedure

BUILD Command

Initiates a BUILD session.

BUILD <<libref.>catalog-name<.entry-name<.entry-type>>>


You can specify the following optional arguments with the BUILD command:

specifies the catalog or catalog entry to open. Argument values are interpreted as follows:

The form of the argument determines which window the BUILD command opens, as follows:

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.

specifies the RESOURCE entry that is associated with any FRAME entries you create during the BUILD session. By default, new FRAME entries use the RESOURCE entry that is specified in the SAS registry. You can use the BUILD= option to override the default for the current BUILD session. 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 (the catalog that was specified in the BUILD command's catalog-name argument).

Note:   You can use the RESOURCE command in a BUILD procedure window to change the default RESOURCE entry during the BUILD session.  [cautionend]

Using the BUILD Command

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.

Chapter Contents



Top of Page

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