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.
Syntax
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 in which 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: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). SAS stores all the
items that it provides in Sashelp.Tmplmst.
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.
See:RSASUSER System Option in SAS System Options: Reference for more information about how to
open the Sasuser library for Read access or Read-Write access.
- 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).
Optional Argument
- (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.
Copyright © SAS Institute Inc. All rights reserved.