Contents Publish Package Interface Previous Next

RETRIEVE_VIEWER

Retrieves a viewer entry from a package.

Syntax

CALL RETRIEVE_VIEWER(entryId, filename, rc<, properties, propValue1, ...propValueN>);

entryId
Numeric, input.
Identifies the file entry.

filename
Character, input.
Specifies the name of the file or fileref, using the following syntax:
  • FILENAME: external_filename
  • FILEREF: SAS_fileref

rc
Numeric, output.
Receives a return code.

properties
Character, input.
Identifies a comma-separated list of optional property names. Valid property names are as follows:
  • ENCODING

propValue1, ...propValueN
Character, input.
Specifies one value for each specified property name. The order of the property values must match the order of the property names in the properties parameter. Valid property values are defined as follows:

ENCODING
Input character string indicates the target encoding for the retrieved viewer file. An example of a target encoding value is ISO-8859-1. Refer to Publish/Retrieve Encoding Behavior for further information.

Details

Specifying "FILENAME:", without an external filename, applies to the retrieved file the same name that was used when the file was initially inserted into the package.

The following example retrieves a viewer from a package.

fname = "filename: /users/jsmith.bin";
CALL RETRIEVE_VIEWER(entryId, fname, rc);

Contents Publish Package Interface Previous Next