.UTIL FIELD GET

This subroutine is called to retrieve the value of the specified field name.

Usage:

      PASS         <value>                    FIELD            SHARE? Y
      PASS         <App_Id>                   FIELD            SHARE? N
      PASS         <Field_Name>               FIELD            SHARE? N
      PASS         <Occ_no>                   FIELD            SHARE? N
      GOSUB    --- .UTIL FIELD GET
      *        Check for errors
      IF       --- .UTIL FIELD GET            NE

Description:

This subroutine is called to retrieve the value of the specified field name. All parameters are required. If any required parameters are missing, the subroutine will CANCEL.

<value> will contain the data in string format from the specified field (Required). This must be PASSed with Share "Y" to return the value.

<App_Id> is the Application Id of the field whose value you want to retrieve (Required). The version will be taken from the currently running version.

<Field_Name> is the field whose value you want to retrieve (Required). This must be a valid field in the specified application. Group fields are not supported

<Occ_no> is the occurrence number to be retrieved (Required). If blank or zero, it will default to 1.

<value> will contain a string representing the data in <Field_Name>. Dates will be in CCYYMMDDhhmmsstt format, with any missing parts filled with dashes.

If <Field_Name> cannot be found, an error will be returned and the previous contents of <value> (if any) will be unchanged.

See also .UTIL FIELD SET.

Comments:

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

JeanNeron - 2012-02-29