Previous Page | Next Page

TEMPLATE Procedure: Managing Template Stores

PATH Statement


Specifies locations to write to or read from when you create or use PROC TEMPLATE templates or definitions, and specifies the order in which to search for them. This statement overrides the ODS PATH statement for the duration of the PROC TEMPLATE step.
Featured in: Listing Templates in a Template Store and Viewing the Source of a Template

PATH <(APPEND) | (PREPEND) | (REMOVE) > location(s);
PATH path-argument;


Required Arguments

location(s)

specifies one or more locations to write to or read from when creating or using PROC TEMPLATE items and the order in which to search for them. ODS searches the locations in the order that they appear on the statement. It uses the first definition that it finds that has the appropriate access mode (Read, Write, or Update) set.

Each location has this form:

<libref.>item-store <(READ | UPDATE | WRITE)>

<libref.>item-store

identifies an item store to read from, to write to, or to update. If an item store does not already exist, then the PATH statement creates it.

(READ | UPDATE | WRITE)

specifies the access mode for the item. An access mode is one of the following:

READ

provides read-only access.

WRITE

provides Write access (always creating a new template store) as well as Read access.

UPDATE

provides Update access (creating a new template store only if the specified one does not exist) as well as Read access.

Default: READ
Default: The general default path is as follows:

SASUSER.TEMPLAT (UPDATE))

SASHELP.TMPLMST (READ)

If you have specified the RSASUSER SAS system option, then the default path is as follows:

WORK.TEMPLAT(UPDATE)

SASUSER.TEMPLAT (READ)

SASHELP.TMPLMST (READ)

Note:   SAS stores all the items that it provides in SASHELP.TMPLMST.   [cautionend]

Note:   See the RSASUSER SAS system option in SAS Language Reference: Dictionary for more information.  [cautionend]

Tip: If you want to be able to ignore all the items that you create, then keep them in their own item stores so that you can leave them out of the list of item stores that ODS searches.
path-argument

sets or displays the ODS path.

path-argument is one of the following:

RESET

sets the ODS path to the default settings SASUSER.TEMPLAT (UPDATE) and SASHELP.TMPLMST (READ).

SHOW

displays the current ODS path.

VERIFY

sets the ODS path to include only templates supplied by SAS. Specifying VERIFY is the same as specifying ODS PATH SASHELP.TMPLMST (READ).


Options

(APPEND | PREPEND | REMOVE )

adds one or more locations to a path, or removes one or more locations from a path.

APPEND

adds one or more locations to the end of a path. When you append a location to a path, all duplicate instances (with the same name and same permissions) of that item store are removed from the path. Only the last item store with the same name and permissions is kept.

PREPEND

adds one or more locations to the beginning of a path. When you prepend a location to a path, all duplicate instances (with the same name and same permissions) of that item store are removed from the path. Only the first item store with the same name and permissions is kept.

REMOVE

removes one or more locations from a path.

Default: If you omit an APPEND, PREPEND, or REMOVE option, then the PATH statement overwrites the complete path.

Previous Page | Next Page | Top of Page