{
{      The purpose of this request is to initiate the LCN connection
{ establishment process.  This request is only used by the client
{ application.  The client application must "sign_on" to the local
{ access method prior to issuing this request.
{ If this request successfully completes, a file specified by the
{ CONNECTION_FILE parameter is created and the corresponding RHFAM
{ file attributes are assigned.  The file must then be used to
{ reference this connection on all future requests.
{
{      NOTE - The state of the connection after this request
{             successfully completes is 'connect_in_progress'.  The
{             connection file can not be opened until the remote
{             end accepts the connection.  The user can use
{             RFP$AWAIT_SERVER_RESPONSE or
{             OSP$AWAIT_ACTIVITY_COMPLETE to determine when the
{             connection has been established (or terminated).
{             The user can terminate the connection establishment
{             process with the RFP$TERMINATE_CONNECTION request.
{
{ RFP$REQUEST_CONNECTION(CLIENT_NAME, SERVER_NAME, DESTINATION_HOST,
{   CONNECTION_FILE, FILE_ATTRIBUTES, STATUS)
{
{ CLIENT_NAME: (input) This parameter specifies the name of the
{   requesting client application.  The client name must be the same as
{   a client name used in a previous APPLICATION_SIGN_ON request.
{
{ SERVER_NAME: (input) This parameter specifies the name of the
{   requested server application.
{
{ DESTINATION_HOST: (input) This parameter specifies the name
{   of the remote host where the server application resides.  If the
{   application specifies a logical identifier, the access method will
{   randomly select a physical host (assuming multiple hosts have the same
{   logical identifier defined) to receive the connect request.  If the
{   application specifies a physical identifier, the access method will
{   send the connect request to the specified host.
{
{ CONNECTION_FILE: (input) This parameter specifies a file name that
{   the access method should create and assign to the connection end
{   point.  The file reference must be in a temporary master catalog
{   and must not already exist in that catalog.
{
{ FILE_ATTRIBUTES: (input) This parameter specifies the file attributes,
{   whose values are to be changed to the corresponding values specified
{   by this parameter. A value of NIL for this parameter indicates that
{   default values are to be used for all attributes. Further
{   information on the file attributes is provided in the BAM request
{   section.
{
{ STATUS: (output) This parameter returns the result of the request.
{   A status of normal means the specified file has been created and
{   a connection end point has been assigned to that file.
{   CONDITIONS:  rfe$destination_host_undefined
{                rfe$exceeded_connect_limit
{                rfe$file_already_exists
{                rfe$invalid_attribute_key
{                rfe$max_appl_connects_exceeded
{                rfe$not_signed_on
{                rfe$not_signed_on_as_client
{                rfe$path_to_remote_undefined
{                rfe$paths_to_destination_down
{                rfe$remote_server_undefined
{                rfe$system_task_not_active
{   IDENTIFIER:  'RF'
{
