mache.parallel.pbs.PbsSystem.resolve_pbs_options

classmethod PbsSystem.resolve_pbs_options(config: ConfigParser, nodes: int, min_nodes_allowed: int | None = None, queue: str | None = None, constraint: str | None = None, desired_wall_time: str | None = None, scheduler_target: str | None = None) → PbsOptions[source]

Get PBS submission options for a requested node count.

A requested queue is honored when the machine’s metadata allows it; otherwise the default queue is used and the returned options explain why.

Parameters:

  • config (ConfigParser) – Machine configuration parser.

  • nodes (int) – Requested node count.

  • min_nodes_allowed (int, optional) – Optional lower bound for adjusted node counts.

  • queue (str, optional) – A specific queue the caller would like to use.

  • constraint (str, optional) – A specific constraint the caller would like to use.

  • desired_wall_time (str, optional) – The wall time (HH:MM:SS) the caller intends to request. A requested queue that does not allow it is not honored, and the returned wall_time is capped at max_wallclock.

  • scheduler_target (str, optional) – A target named without saying which axis it is on, for callers with one machine-independent intent such as “use the debug target”. PBS machines schedule by queue, so it is used as the queue when this machine lists it as one. queue takes precedence.

Returns:

PbsOptions – The resolved PBS submission options.