.ENV GET PATH NAME

This subroutine returns the path name of the requested Appx file.

Usage:

      PASS         <file_path>                FIELD            SHARE? Y
      PASS         <app_id>                   FIELD            SHARE? N
      PASS         <file_name>                FIELD            SHARE? N
      PASS         <error_msg>                FIELD            SHARE? Y
      PASS         <database>                 FIELD            SHARE? N
      PASS         <version>                  FIELD            SHARE? N
      GOSUB    --- .ENV GET PATH NAME
      *        Check for errors
      IF       --- .ENV GET PATH NAME         NE

Description:

This subroutine returns the path name of the requested Appx file. The first three parameters are required, if any are missing the subroutine will CANCEL. The remaining parameters are optional.

<file_path> will contain the path and file name of the requested file (Required). This must be PASSed with Share "Y" to return the value. Note that this does not include the '.dat' extension

<app_id> is the application id of the file you are interested in (Required).

<file_name> is the name of the file you are interested in (Required).

<error_msg> will contain any additional error information (optional).

<database> is the name of the database that contains the file you are interested in. If not PASSed, it will default to the current database.

<version> is the version that contains the file you are interested in. If not PASSed, it will default to the version used by <database>.

If the field you passed in <file_path> is too short to contain the data, --- .ENV GET PATH NAME will be set to "Data was truncated".

Comments:

Read what other users have said about this page or add your own comments.

-- JeanNeron - 2012-01-27