{
{   The purpose of this request is to detach a file from the job.  For a
{ temporary file, this request also deletes the registration of the file in the
{ temporary catalog.
{
{   This request requires that there be no outstanding instances of open of the
{ file within the job.  Otherwise, this request will be rejected.
{
{   If the file is an attached permanent file, the attachment of the file to
{ the job ends with this request.  The space that the permanent file occupies
{ is unaffected by this request.
{
{   If the file is a temporary mass storage file, the file information is
{ destroyed, i.e.  the mass storage space once assigned to the file is returned
{ to the system.
{
{   If the file is a magnetic tape file, the tape volume assigned to file, if
{ any, is detached from the job.  Information on the tape volume(s) accessed by
{ the job is unaffected by this request.  If detachment_options are not
{ specified, the volume is dismounted from the tape drive.  If the
{ fsc$do_unload_volume detachment_option is specified, the detachment of the
{ volume from the tape drive is based on the value specified by this option.
{
{       FSP$DETACH_FILE (FILE, DETACHMENT_OPTIONS, STATUS)
{
{ FILE: (input)  This parameter specifies the path name of the file to be
{       detached.  The value specified is evaluated by this request as an SCL
{       <file expression>.  Refer to the discussion of <file expression> in the
{       NOS/VE Command Interface ERS.
{
{ DETACHMENT_OPTIONS: (input)  This parameter specifies the detachment options
{       to be used for the detachment of the file.
{
{ STATUS: (output) This parameter specifies the request status.
{       CONDITION:  ame$ring_validation_error,
{                   ame$file_not_closed,
{                   ame$file_not_known.
{       IDENTIFIER: amc$access_method_id.
{
