The GIS Procedure

SYNC Statement

Updates a SAS/GIS catalog entry libref and the internal pathname.

Restriction:	In order to use the SYNC statement on a catalog entry, you must have Write permission to the source location.
Note:	You can synchronize a single GIS entry or include the dependent entries on a catalog entry.

Syntax

Summary of Optional Arguments

Required Argument

Options

Syntax

SYNC <libref.catalog.>entry<.type> </ options>;

Summary of Optional Arguments

ALIAS=(old-libref-1=new-libref-1<, ..., old-libref-n=new-libref-n>)

specifies libref translations.

BLANK

specifies that internal pathnames should be cleared in the updated entries.

ENTRYTYPE=type

specifies the type of GIS catalog entry to synchronize.

SELECT=_ALL_ | ENTRY

specifies which catalog entries that are referenced by the source entry should be updated.

Required Argument

<libref.catalog.>entry<.type>

specifies the catalog entry to synchronize. If you specify a one-level name, the current catalog is used.

Note	When you specify a four-level entry name, type must be the actual SAS/GIS catalog entry extension (for example, GISMAP, not MAP).

Options

Separate the list of options from the catalog entry name with a slash (/).

ALIAS=(old-libref-1=new-libref-1<, ..., old-libref-n=new-libref-n>)

specifies libref translations. The old-libref value is the libref that is stored in the existing catalog entry. The new-libref value is the libref that you want to substitute in the synchronized version of the entry.

BLANK

specifies that internal pathnames should be cleared in the updated entries.

ENTRYTYPE=type

specifies the type of GIS catalog entry to synchronize. The following are the values for type:

GISSPA or SPATIAL
GISMAP or MAP
GISLAYER or LAYER
GISCOVER or COVERAGE.

This argument can be omitted if a complete, four-level entry name is specified. The following statements are identical:

sync sasuser.mall.stores entrytype=gismap

sync sasuser.mall.stores.gismap

SELECT=_ALL_ | ENTRY

specifies which catalog entries that are referenced by the source entry should be updated. The following are the values for this argument:

_ALL_

updates all dependent catalog entries. This is equivalent to specifying ENTRY.

ENTRY

updates all dependent catalog entries.