hpcflow.sdk.monitoring.listing.list_registered_submissions#

hpcflow.sdk.monitoring.listing.list_registered_submissions(app, workflow_ref=None, ref_type=None, max_recent=None, template_names=None, include_missing=False, use_cache=False)#

Return registered active/unknown records followed by recent inactive history.

Resolve an optional workflow reference and exact template-name filter before applying max_recent to inactive records; None lists all retained history. Comma-separated IDs select multiple workflows, including the -1 latest alias. Activity is the last recorded observation, not a live scheduler query. Missing paths are excluded before history limits unless include_missing is True; checking existence does not change or remove registry entries.

Never prune or write the registry, query schedulers, or construct workflow objects. A template filter may read metadata headers to recover names absent from older records; saved names remain usable when workflow data is missing. use_cache avoids workflow-file reads entirely: availability and template names come only from the registry, with no existence checks or header recovery.

Parameters:
  • app (BaseApp)

  • max_recent (int | None)

  • template_names (Sequence[str] | str | None)

  • include_missing (bool)

  • use_cache (bool)

Return type:

list[SubmissionRecord]