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);