{
{   The purpose  of  this  request  is  to  establish  a "connection" from the
{ subject file to the target file.  The effect of this connection is that  any
{ data  access  requests  against the subject file are passed on to the target
{ file.
{   A subject file may be connected to more than one target file.
{   Output requests for the subject file are passed on to all targets.
{   Input requests are passed on only to the most recently connected target.
{   The amp$fetch_access_information, amp$fetch  and  amp$store  requests  are
{ passed on only to the least recently connected target.
{   The ifp$fetch_terminal and ifp$store_terminal requests are passed on  only
{ to the most recently connected target for which they are appropriate.
{   If the  subject  file  is not currently connected to any target files, the
{ connection is made only for subsequent opens of the subject file (i.e.   for
{ any  current opens of the subject file the connection is ignored).  However,
{ if the subject file is currently connected to one or more target files,  the
{ new connection is immediate.
{
{   The connection  will  be  rejected  if  the  attributes of the subject and
{ target files are incompatible.  The attributes in question are file_contents
{ and  file_structure.   The  corresponding  attributes  of the two files must
{ either be identical or the value for one of the files must be "unknown".
{   If the  target  file  doesn't  currently  exist the default values for its
{ file_contents  and  file_strucutre  attributes  will  be  the  corresponding
{ attribute values of the subject file.
{
{   The following   files   may   not   be   the   subject  of  a  connection:
{ clc$current_command_input,       clc$job_command_input,       clc$job_input,
{ clc$proc_caller_command_input, clc$job_output and clc$null_file.
{
{       CLP$CREATE_FILE_CONNECTION (SUBJECT_FILE, TARGET_FILE, STATUS)
{
{ SUBJECT_FILE:  (input)  This  parameter  specifies  the  file from which the
{       connection is to be made.
{
{ TARGET_FILE:  (input)  This  parameter  specifies  the  file  to  which  the
{       connection is to be made.
{
{ STATUS: (output) This parameter specifies the request status.
{       CONDITIONS: cle$improper_subject_file_name,
{             cle$improper_target_file_name, cle$duplicate_file_connection,
{             cle$circular_file_connection, cle$incompatible_file_connect,
{             cle$subject_cannot_be_connected
{       IDENTIFIER: 'CL'
{
