requeue

Output of --help=requeue

The following help text is generated by ecflow_client --help=requeue

requeue
-------

Re queues the specified node(s)
  If any child of the specified node(s) is in a suspended state, this state is cleared
Repeats are reset to their starting values, relative time attributes are reset.

Argument(s):

    mode: (optional) [ abort | force ]
        # abort  = re-queue only aborted tasks below node
        # force  = Force the re-queueing even if there are nodes that are active or submitted
        # <null> = Checks if any tasks are in submitted or active states below the node,
        #          and if so does nothing. Otherwise, re-queues the node.

    node: path
        # A space separared list of node paths. Paths must begin with a leading '/' character

Usage:

    --requeue=abort /suite/f1  # re-queue all aborted tasks of /suite/f1
    --requeue=force /suite/f1  # forcibly re-queue /suite/f1 and all its children.May cause zombies.
    --requeue=/s1/f1/t1 /s1/t2 # Re-queue node '/suite/f1/t1' and '/s1/t2'

The client considers, for both user and task commands, the following environment variables:

  ECF_HOST <string> [mandatory*]
    The main server hostname; default value is 'localhost'
  ECF_PORT <int> [mandatory*]
    The main server port; default value is '3141'
  ECF_SSL <any> [optional*]
    Enable secure communication between client and server.
  ECF_HOSTFILE <string> [optional]
    File that lists alternate hosts to try, if connection to main host fails
  ECF_HOSTFILE_POLICY <string> [optional]
    The policy ('task' or 'all') to define which commands consider using alternate hosts.

The options marked with (*) must be specified in order for the client to communicate
with the server, either by setting the environment variables or by specifying the
command line options.

See also

Protocol reference for RequeueNodeCmd — the request/reply payloads exchanged with the server and the C++ command class that implements this command.