
{
{    The purpose of this request is to return an attached permanent file.
{
{       PFP$RETURN_PERMANENT_FILE (APFID, SYSTEM_FILE_ID,
{            USAGE_SELECTIONS, STATUS)
{
{ APFID: (input) This parameter specifies the permanent file identifier
{       of the attached file to be returned.
{
{ SYSTEM_FILE_ID: (input) This parameter specifies the device manager
{       system file table index.  This is currently only used when the
{       file being returned resides on a server mainframe, in which case the
{       system_file_id indicates the file table entry on the client
{       mainframe.
{
{ USAGE_SELECTIONS: (input) This parameter specifies how the file was attached.

{ STATUS: (output) This parameter returns the request status.
{       If there is an internal error such that the cycle cannot be
{         found in the catalog, the apfid is invalidated.
{       If the status indicated the volume is down, the file is not
{         returned, and the apfid remains valid.  The file may be returned
{         at a later time, when the device is available.
{       If the status indicated the server is terminated, the file tables
{         on the client are removed.
{       If the status indicates an error on the detach, as a result
{         for example, of an mme$io_write_error, the catalog is updated
{         to indicate the current usage is complete and the apfid is
{         invalidated.
{

