SAS Institute. The Power to Know

SAS(R) 9.2 Publishing Framework: Developer's Guide

Previous Page | Next Page

Publishing Packages

PACKAGE_PUBLISH (Publish Package to Archive)



Publishes a package to an archive
Syntax
Arguments
Details
Example

Syntax

CALL PACKAGE_PUBLISH(packageId, publishType, rc, properties,<propValue1, ...propValueN>);

Arguments

packageID

identifies the package that is to be published.

Type: Numeric
Direction: Input
publishType

indicates how to publish the package. To publish the package by using the archive transport, specify TO_ARCHIVE.

Type: Character
Direction: Input
rc

receives a return code.

Type: Numeric
Direction: Output
properties

identifies a comma-separated list of optional property names. Specify any of the following property names, or specify '' to indicate that no properties are to be applied:

  • ARCHIVE_NAME

  • ARCHIVE_PATH

  • FTP_PASSWORD

  • FTP_USER

  • HTTP_PASSWORD

  • HTTP_PROXY_URL

  • HTTP_USER

For more information about these properties, see Transport Properties.
Type: Character
Direction: Input
propValue1, ...propValueN

specifies a value for each specified property name. The order of the property values must match the order of the property names in the properties parameter.

Type: Character
Direction: Input

Details

The ARCHIVE_NAME property identifies the name of the archive file to create. If this property is omitted, then the archive transport generates a unique name by default.

The ARCHIVE_PATH property identifies where the archive is created. This property can be a physical pathname, an FTP URL, or an HTTP URL. If ARCHIVE_PATH is an HTTP URL on a secured server, you must specify the HTTP_USER and HTTP_PASSWORD properties. Specifying the HTTP_PROXY_URL property is optional. If ARCHIVE_PATH is an FTP URL on a secured host, then you must specify the FTP_USER and FTP_PASSWORD properties.

Note:    In the z/OS operating environment, an archive can be published only to UNIX System Services directories.  [cautionend]


Example

pubType = "TO_ARCHIVE";
properties='archive_path, archive_name';
path = '/u/users';
name = 'results';
CALL PACKAGE_PUBLISH(packageId, pubType,
   rc, properties, path, name);

Previous Page | Next Page | Top of Page