Here is an example
of specifying a single name/value pair for an entire package:
The publisher identifies
the entire package as relevant only to a US market.
To describe the contents
of an entire package with finer granularity, the publisher can specify
multiple name/value pairs. A space separates each name/value pair.
Here is another example of specifying multiple name/value pairs for
an entire package:
market=US type=report content=ticketsales
Quarter4 priority=high
This high-priority package
contains one or more reports about fourth-quarter ticket sales that
is relevant only to a US market.
When both subscribers
and developers of package-retrieval applications know about package
name/value pairs, they can construct
and apply filters that control package delivery.
See Filtering Packages and Package Entries.
The publisher can specify
name/value pairs when publishing
the package by using the Publish Package Interface. For the archive,
message queue, and SAS channel subscriber delivery types only, you
assign
name/value pairs
to the nameValue property in the PACKAGE_BEGIN CALL routine.
The following code shows
the assignment of name/value pairs to an entire package:
packageID=0;
rc=0;
desc = "Nightly run.";
nameValue = "market=US type=report content=ticketsales
Quarter4 priority=high";
CALL PACKAGE_BEGIN(packageId, desc, nameValue, rc);
This nameValue property
specifies a high-priority package that contains one or more reports
about fourth-quarter ticket sales that are relevant only to a US market.