.. _auto_hpc_config_create:

*HPC CONFIG CREATE*
===================

Creates a new saved HPC configuration for the active user from an HPC server's available options. Defaults queue, cores, walltime, and solver attributes from the server's option definitions and validates them against the selected queue before persisting. The created config can be passed directly to job-submission workers.

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

Tagged: ``config_create``, ``hpc``, ``hpc_config``, ``job_submission``, ``settings``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - HPC Server
     - hpcserver_id
     - text
     - —
     - ✓
     - Id of the HPC server to build the configuration for. Its option definitions drive the defaulting and validation of queue, cores, walltime, and solver attributes.
   * - Config Name
     - name
     - text
     - —
     - ✓
     - Unique name for the new saved configuration. Rejected if a configuration with this name already exists (use hpc_config_update to edit).
   * - Solver
     - solver
     - text
     - —
     - 
     - Solver name (e.g. mpp_lsdyna). Defaults to mpp_lsdyna when available, otherwise the server's first solver. Must be one of the server's supported solvers.
   * - Solver Version
     - solver_version
     - text
     - —
     - 
     - Solver version (e.g. r11dp). When omitted, the solver attribute default from the server options is used.
   * - Queue
     - queue
     - text
     - —
     - 
     - Queue name. Defaults to the server's default queue (or first queue). Must be a queue offered by the server; cores/walltime are validated against it.
   * - CPU Cores
     - cpus
     - number
     - —
     - 
     - Number of cores. Defaults to the queue default; clamped to the queue's min/max and rounded to its core increment.
   * - Walltime
     - walltime
     - text
     - —
     - 
     - Walltime as HH:MM:SS. Defaults from the queue/server; coerced into the queue's allowed walltime range.
   * - Memory
     - memory
     - text
     - —
     - 
     - Optional job memory value; stored on the config as job_memory when provided.
   * - Solution Type
     - solution_type
     - text
     - —
     - 
     - Solution type for the solver; defaults to 'auto'.
   * - Key-Value Overrides
     - keyvalue_overrides
     - keyvalue
     - —
     - 
     - Optional flat key-value object overriding top-level config fields or solver attributes (keyed by solver attribute id) after defaulting.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Created HPC Config
     - created_config
     - object
     - Complete HPC configuration JSON object as persisted; can be passed directly to job-submission workers.
   * - Status Message
     - status_message
     - text
     - Human-readable summary of the created configuration (server, solver, queue, cores, walltime, attributes defaulted).

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

- platform.hpc_config

.. raw:: html

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