NAME

       ecaccess-association-put - Update/Create an Association

SYNOPSIS

       ecaccess-association-put -version|-help|-manual

       ecaccess-association-put [-debug] [-gateway name] [-password] source-file

DESCRIPTION

       Allow updating or creating an ECtrans Association. If the name exists then the Association
       is updated. If it does not exists then a new Association is created. In order to get a
       template for a new Association please use the following command:

       ecaccess-association-get -template association-name target-file

       The target-file for the Association Descriptive File does not have to be the name of the
       Association itself. The name for the Association is specified in the association-name
       parameter.

       When creating a new Association the -password option should be used to set the password
       (it can not be set in the Association Descriptive File as this would not be secure).

ARGUMENTS

       source-file
               The name of the Association Descriptive File to upload.

OPTIONS

       -gateway name
               This is the name of the ECaccess Gateway where the Association should be
               installed.  It is by default the Gateway you are connected to. In order to get the
               name of your current Gateway you can use the ecaccess-gateway-name command. When
               using the commands at ECMWF the default Gateway is always "ecaccess.ecmwf.int".

       -password
               Allow prompting for a new password for the Association.

       -version
               Display version number and exits.

       -help   Print a brief help message and exits.

       -manual Prints the manual page and exits.

       -retry count
               Number of SSL connection retries per 5s to ECMWF. This parameter only apply to the
               initial SSL connection initiated by the command to the ECMWF server. It does not
               apply to all the subsequent requests made afteward as it is mainly targeting
               errors that can happen from time to time during the SSL handshake. Default is no
               retry.

       -debug  Display the SOAP and SSL messages exchanged.

EXAMPLES

       ecaccess-association-put -password ./test

       Push the Association described in the ./test file of your current directory on your
       default Gateway. You will be also prompted for a new password.

       ecaccess-association-put -gateway ecaccess.ecmwf.int ./test

       Push the Association described in the ./test file of your current directory on the
       ecaccess.ecmwf.int Gateway.

SEE ALSO

       ecaccess-association-delete, ecaccess-association-get, ecaccess-association-list,
       ecaccess-association-protocol and ecaccess.