delete

Output of --help=delete

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

delete
------

Deletes the specified node(s) or _ALL_ existing definitions( i.e delete all suites) in the server.

Argument(s):

    force: (optional) [ force | yes ]
        # Use this parameter to bypass checks, i.e. for active or submitted tasks

    confirm: (optional)
        # value must be "yes"; bypasses the confirmation prompt

    target: node paths | _all_
        # The value `_all_` means delete all suites.
        # The node paths must start with a leading '/'.

Usage:

    --delete=_all_                    # Delete all suites in server. Use with care.
    --delete=/suite/f1/t1             # Delete node at /suite/f1/t1. This will prompt
    --delete=force /suite/f1/t1       # Delete node at /suite/f1/t1 even if active or submitted
    --delete=force yes /s1 /s2        # Delete suites s1,s2 even if active or submitted, bypassing prompt

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 DeleteCmd — the request/reply payloads exchanged with the server and the C++ command class that implements this command.