.. _auto_hpcjobsettings_finder:

*RETRIEVES HPCJOB SETTINGS BASED ON THE QUERY*
==============================================

Queries the platform's HPC job registry and retrieves saved job settings that match the specified filters (server, solver type, and/or solver version). Use this worker to look up existing HPC configurations before submitting or templating a new simulation job.

When to use
-----------

Tagged: ``configuration``, ``hpc``, ``hpcjob``, ``lookup``, ``settings``, ``simulations``, ``solver``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Search
     - search
     - text
     - —
     - 
     - Free-text search string used to filter HPC job settings by keyword; hidden by default and typically left null when filtering via the structured fields below.
   * - HPCServer
     - hpcserver_id
     - remote_lookup
     - —
     - 
     - One or more HPC server identifiers (selected via remote lookup from /api/admin/hpcservers) used to restrict results to settings associated with specific cluster nodes.
   * - Solver Type
     - solver_type
     - list
     - —
     - 
     - Solver type filter (e.g. LS-DYNA, Abaqus) drawn from unique values already present in the job registry; leave blank to return settings for all solver types.
   * - Solver Version
     - solver_version
     - list
     - —
     - 
     - Solver version filter (e.g. R14.1, 2023.1) drawn from unique values in the job registry; leave blank to return settings across all installed solver versions.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Saved HPC Settings
     - hpcsettings
     - dataset
     - Tabular dataset of saved HPC job settings records matching the supplied filters, including server, solver type/version, and associated job configuration parameters.

Disciplines
-----------

- platform.hpc_config
- platform.job_submission

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>hpcjobsettings_finder</code>. Schema hash: <code>9182df0350d3</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>