{
{  The purpose of this request is to open a file specified by FILE_NAME as a
{        text file type.
{
{
{        CYP$OPEN_TEXT_FILE (FILE_NAME, FILE_ACCESS, FILE_ATTACHMENT,
{              DEFAULT_CREATION_ATTRIBUTE, MANDATED_CREATION_ATTRIBUTE,
{              ATTRIBUTE_VALIDATION, ATTRIBUTE_OVERRIDE, FILE, STATUS)
{
{
{  FILE_NAME: (input) This parameter specifies the file to be opened.
{
{  FILE_ACCESS: (input) This parameter specifies how the file is to be
{        accessed.
{
{  FILE_ATTACHMENT: (input) This parameter specifies the attachment options to
{        be in effect for this instance of open.
{
{  DEFAULT_CREATION_ATTRIBUTE: (input) This parameter specifies file attribute
{        values which are to be used in the absence of a CREATE_FILE command or
{        program request specification.
{
{  MANDATED_CREATION_ATTRIBUTE: (input) This parameter specifies file attribute
{        values which must be used to describe the file, if it is to be
{        initially opened by this request.
{
{  ATTRIBUTE_VALIDATION: (input) This parameter specifies the desired attribute
{        values of the file.
{
{  ATTRIBUTE_OVERRIDE: (input) This parameter specifies an attibute value to
{        be used only for this instance of open of the file or file cycle.
{
{  FILE: (output) This parameter returns a pointer that must be used on all
{        other calls to CYBILIO when referring to the file being opened here.
{
{  STATUS: (output) This parameter specifies the request status.
{        CONDITIONS:
{              cye$illegal_open_request
{              cye$no_memory_to_open_file
{

