SAS 9.1.3 Integration Technologies » Developer's Guide


Publish Package Interface
Publish/Retrieve Encoding Behavior
Publishing Packages
INSERT_CATALOG
INSERT_DATASET
INSERT_FDB
INSERT_FILE
INSERT_HTML
INSERT_MDDB
INSERT_PACKAGE
INSERT_REF
INSERT_SQLVIEW
INSERT_VIEWER
PACKAGE_BEGIN
PACKAGE_END
PACKAGE_PUBLISH
LDAP Channel Store Syntax
SAS Metadata Repository Channel Store Syntax
Retrieving Packages
COMPANION_NEXT
ENTRY_FIRST
ENTRY_NEXT
PACKAGE_DESTROY
PACKAGE_FIRST
PACKAGE_NEXT
PACKAGE_TERM
RETRIEVE_CATALOG
RETRIEVE_DATASET
RETRIEVE_FDB
RETRIEVE_FILE
RETRIEVE_HTML
RETRIEVE_MDDB
RETRIEVE_NESTED
RETRIEVE_PACKAGE
RETRIEVE_REF
RETRIEVE_SQLVIEW
RETRIEVE_VIEWER
Filtering Packages
Publishing Examples
Publishing in the Data Step
Publishing in a Macro
Publishing with FTP
Publishing Framework

RETRIEVE_FILE

Retrieves an external binary or text file from a package.

Syntax

CALL RETRIEVE_FILE(entryId, filename, rc);

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.

Details

Specifying "FILENAME:" (without a filename) applies to the retrieved file the name of the original file, when that file was inserted in the package.

The following example retrieves a binary file from a queue.

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