{
{   The purpose of this request is to get the value of a string variable from
{ a form and transfer it to your program.
{
{       FDP$XGET_STRING_VARIABLE (FORM_IDENTIFIER, VARIABLE_NAME,
{         VARIABLE_OCCURRENCE, VARIABLE, VARIABLE_STATUS, STATUS)
{
{ FORM_IDENTIFIER: (input)  This parameter specifies the form identifier for
{       the instance of the form.
{
{ VARIABLE_NAME: (input)  This parameter specifies the name of the variable.
{
{ VARIABLE_OCCURRENCE: (input)  This parameter specifies the occurrence of the
{       variable name.
{
{ VARIABLE: (output)  This parameter specifies the string variable.
{
{ VARIABLE_STATUS: (output)  This parameter specifies the ordinal which gives
{       the status of the variable.
{
{       value:  fdc$no_error
{               fdc$invalid_string
{
{ STATUS: (output) This parameter specifies the name of the variable
{       to set to indicate the status of the request.
{
{       condition identifiers: fde$bad_data_value
{                              fde$invalid_form_identifier
{                              fde$invalid_variable_name
{                              fde$system_error
{                              fde$unknown_occurrence
{
