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

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

Summary of Optional Arguments

specifies libref translations.
specifies that internal pathnames should be cleared in the updated entries.
specifies the type of GIS catalog entry to synchronize.
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.