ECACCESS-ASSOCIATION-GET(1p) | User Contributed Perl Documentation | ECACCESS-ASSOCIATION-GET(1p) |
ecaccess-association-get - Get the Association Descriptive File
ecaccess-association-get -version|-help|-manual
ecaccess-association-get [-debug] [-gateway name] [-template] association-name target-file
Get the Descriptive File for the ECtrans Association specified by the association-name parameter. Once downloaded, the target-file can be modified and processed through the ecaccess-association-put command.
When using the -template option, if the Association already exists in the ECaccess Gateway Database, then the command return with an error. In order to create a new Association similar to an existing one the ecaccess-association-get command can be used to retrieve the Descriptive File of the existing Association. The file can then be updated and pushed to the ECaccess Gateway Database with the ecaccess-association-put command.
An ECtrans Association Descriptive File contains parameters for ECtrans of the general form $name='value'. Each ECtrans Association has their own Descriptive File, and parameters in any given Descriptive File will be passed to the ECtrans container whenever a transfer is requested to the corresponding Association.
Blank lines and leading spaces and tabs are ignored when they do not occur in single quoted strings. Lines whose first non-space character is a pound-sign (#) are comments, and are ignored. Note that comments are not allowed on the same line as parameters and don't persist when the Descriptive File is retrieved from the Gateway (they might however be used when Descriptive Files are archived on your system).
The parameters are the following:
ecaccess-association-get -template test ./test
Create a new Association Descriptive File for an Association named test and store it in your current directory (file ./test). The file can then be edited and updated accordingly to your requirements.
ecaccess-association-put -password ./test
Create the Association with the previously updated ./test Association Descriptive File.
ecaccess-association-get -gateway ecaccess.ecmwf.int ginko ./ginko
Get the Descriptive File for the existing ginko Association on the ecaccess.ecmwf.int Gateway.
ecaccess-association-put -gateway ecaccess.ecmwf.int ./ginko
Push the Association back (once updated).
This is an example of an Association Descriptive File:
############################################################## # Main Parameters ############################################################## $active='yes' $comment='Access to the archive system' $grantedUserList='abc,def,jhi' $directory='/tmp/data' $hostName='hostname.example.ms' $login='anonymous' $protocol='genericFtp' ############################################################## # Data ############################################################## $data=' ftp.mkdirs="yes" ftp.passive="no" ftp.port="21" ftp.suffix=".tmp" ftp.usetmp="yes"'
Please note the multiple lines in the data parameter.
ecaccess-association-delete, ecaccess-association-list, ecaccess-association-protocol, ecaccess-association-put and ecaccess.
2013-12-11 | perl v5.18.1 |