----------------------------------------------
lines 6-47 of file: at_cascade/clear_shared.py
----------------------------------------------

{xrst_begin clear_shared}
{xrst_spell
  errno
  inuse
}

Clear at_cascade Shared Memory
##############################

Prototype
*********
{xrst_literal
   # BEGIN_DEF
   # END_DEF
}

Purpose
*******
This routine clears the at_cascade shared memory that is in use
and has a particular prefix.
For example, you may get the following error message when trying
to run the cascade:

   FileExistsError: [Errno 17] File exists: *name*

where *name* ends with ``_number_cpu_inuse`` or ``_job_status``.
This may happen if the previous :ref:`fit_parallel-name`
did not terminate cleanly; e.g., if the system crashed.

all_node_database
*****************
is a path to the :ref:`all_node_db-name`.
This is used to determine the
:ref:`option_all_table@shared_memory_prefix`.

job_name
********
This is the :ref:`create_job_table@job_table@job_name`
for the shared memory that we are clearing; see
:ref:`fit_parallel@shared_unique` .

{xrst_end clear_shared}