Displays information about the contents of a coverage entry. Also, creates a new coverage entry, replaces an existing entry, modifies the characteristics of an entry, or deletes an entry.
specifies a descriptive phrase that is stored in the description field of the GISCOVER entry.
specifies the GISSPA-type entry to which the coverage definition refers.
specifies a WHERE expression that subsets the chains data set to define a geographic coverage of a spatial database.
specifies the coverage entry that you want to create, delete, replace, or update. The coverage-entry name must conform to the rules for SAS names:
You must specify one of the following values for the operation keyword:
prints information about the specified coverage entry. prints information about the specified coverage entry to the Output window. This includes the WHERE expression that defines the spatial database subset. It also includes details of the spatial database that is provided by the SPATIAL CONTENTS statement.
An error occurs if the specified coverage entry does not exist.
Restriction | No additional arguments (other than the coverage entry name) are used with the CONTENTS operation. |
creates a new coverage entry. The CREATE operation does not overwrite existing coverage entries. An error occurs if a coverage entry with the specified name already exists. Use the REPLACE operation to replace an existing entry.
Requirement | For the CREATE operation, you must also specify the WHERE= argument. |
removes the specified coverage entry. For the DELETE operation,
you can also specify the special value _ALL_
for
the coverage entry name argument to delete all coverage entries in
the current catalog.
An error occurs if the specified coverage entry does not exist.
Restriction | No additional arguments (other than the coverage entry name) are used with the DELETE operation. |
Note | You must specify new coverages for any map entries that refer to the deleted coverage entry. |
CAUTION: |
The REPLACE operation has the effect of canceling the previously issued CREATE operation for the specified coverage entry.
Requirement | For a REPLACE operation, you must also specify the WHERE= argument. |
modifies the specified coverage entry by applying new values for specified arguments. An error occurs if there is no existing coverage entry with the specified name.
When you specify CREATE, REPLACE, or UPDATE for theoperation argument in a COVERAGE statement, you can specify one or more of the following additional optional arguments. Separate the list of options from the coverage-entry argument with a slash (/).
Default | Blank |
specifies the GISSPA-type entry to which the coverage definition refers. An error occurs if there is no existing spatial entry that has the specified name, or if you omit this argument when no spatial entry is currently selected.
Default | Current spatial entry |
specifies a WHERE expression that subsets the chains data set to define a geographic coverage of a spatial database. The where-string value can contain a complete valid WHERE expression of 200 characters or fewer.
To specify a WHERE expression greater than 200 characters, you must break the expression into separate quoted strings. When WHERE= is processed, the strings are concatenated, with a space between each string, and the entire expression is evaluated.
You can specify multiple WHERE expressions to delineate the coverage. If you are using multiple strings, each string does not have to contain a complete WHERE expression, but the concatenated expression must be valid.
You can use any of the variables in the chains data set in the WHERE expression, not just the coordinate variables. When the map is opened, only those chains that match the WHERE clause are read in. You can use only variables in the WHERE expression, not composites. Specify WHERE='1' to define a coverage that includes the entire spatial database.
Note | The WHERE= argument is required when you use the CREATE or REPLACE operation. |
coverage create southeast / where=("statel in (1,12,13,28,37,45,47) | stater in (1,12,13,28,37,45,47)"); run;