Function:     EDITFILE

Purpose:      User action interface routine to edit a text file.

Category:     SYSTEM, USER-INTERFACE 

File:         srvreq.c

Author:       J.P. Terlouw

Use:          INTEGER EDITFILE( FILENAME,   Input       character
                                MESSAGE )   Input       character

              EDITFILE   success/error return code:
                         0: success;
                        -1: user cancelled the edit;
                        -2: cannot start editor;
                        -3: editor process exited with error status.
                      -666: this version of Hermes does not support EDITFILE

              FILENAME   name of file to be edited.

              MESSAGE    message for user.

Description:  EDITFILE requests Hermes to run an editor to edit the specified
              file. Hermes then displays the message in the task status area
              and prompts the user to start the editor. At this moment the
              user has the option to start the edit operation or to cancel or
              postpone it.
              
Updates:      Nov  8, 1992: JPT, document created.