...
As can be seen from the output, for a normal user-id the validity is 168 hours (7 days) for all services. The date/time shown refers to the expiration of the certificate.
...
General information
To display the "Message of the day" (/etc/motd on ecgate) containing announcements of upcoming system sessions etc., use the command ecaccess-cosinfo:
-> ecaccess-cosinfo ******************************************************************************* * * * * * Welcome to AIX Version 5.3! * * * * * * Please see the README file in /usr/lpp/bos for information pertinent to * * this release of the AIX Operating System. * * * * * ******************************************************************************* ECMWF SYSTEM SESSIONS -------------------- WEDNESDAY the 12th of JANUARY 2011: ---------------------------------- 08:30-10:30 UTC Mars and ECFS System Session: impact: Mars and ECFS will be unavailable To reread the message please use: more /etc/motd or cat /etc/motd ==============================================================================
...
Gateway information
Commands named ecaccess-gateway-* (table 2) provide information about ECaccess gateways (see section 2.1). Table 2: Web Toolkit commands providing information on ECaccess gateways (ecaccess-gateway-*).
...
The command ecaccess-gateway-name is the only one which can be used without authentication/certificate.
| Anchor | ||||
|---|---|---|---|---|
|
...
File management
Files at ECMWF can be managed through the Web Toolkit commands named ecaccess-file-*. The file location is specified with the following syntax [domain:][/user-id/]path where domain: can take the values as listed in table 3. The user-id refers to a an ECMWF computer user-id. Only if the domain is specified as an ECFS domain, then the user-id could also be a common pool, e.g. demeter. Table 3: Domain values.
...
| Command | Purpose |
| ecaccess-file-chmod | Change ECaccess File Mode Bits |
| ecaccess-file-copy | Copy an ECaccess File |
| ecaccess-file-delete | Remove an ECaccess File |
| ecaccess-file-dir | List ECaccess Directory Contents |
| ecaccess-file-get | Download an ECaccess File |
| ecaccess-file-mget | Download Multiple ECaccess Files at once |
| ecaccess-file-mkdir | Make a Directory on the ECaccess File System |
| ecaccess-file-modtime | Show the Last Modification Time of an ECaccess File |
| ecaccess-file-move | Move or Rename ECaccess Files |
| ecaccess-file-mput | Upload Multiple Local Files on the ECaccess File System at once |
| ecaccess-file-put | Upload a File on the ECaccess File System |
| ecaccess-file-rmdir | Remove a Directory on the ECaccess File System |
| ecaccess-file-size | Show the Size of an ECaccess File |
...
Batch job management
Batch jobs at ECMWF can be managed through the Web Toolkit commands named ecaccess-job/queue-*, see table 5. Possible values of the job status, which can be checked with the command ecaccess-job-list or via the Web interface, are listed in table 6. A special service (see option -eventIds) allows to automatically submit jobs to be run when certain points in the daily ECMWF operational forecast suite have been reached. The main purpose is to ensure that certain data are available before e.g. submitting a MARS request. These events correspond to the different stages when the ECMWF operational activity has produced certain data or products. The list of events can be retrieved with the "ecaccess-event-list" command. Table 5: Web Toolkit commands for batch job management (ecaccess-job/queue-*).
...
| Status | Meaning |
| DONE | Jobs have successfully completed |
| EXEC | Jobs are running |
| INIT | Jobs are being initialised |
| RETR | Jobs will be resubmitted |
| STDBY | Jobs are waiting for an event |
| STOP | Jobs have NOT completed (error) |
| WAIT | Jobs have been queued to the scheduler (e.g. LoadLeveler) |
...
Management of events
ECMWF maintains some notifications (events) which are linked to ECMWF's operational activity and offers the service for time-critical jobs (see also separate documentation). This service is also available to MS users who maintain their own notifications and can therefore create simple dependencies between different activities, at ECMWF and remote sites. The shell commands to managed events are listed in table 7. Table 7: Web Toolkit commands for management of events at ECMWF (ecaccess-event-*).
| Command | Purpose |
| ecaccess-event-clear | Clear an ECaccess Event |
| ecaccess-event-create | Create an ECaccess Event |
| ecaccess-event-delete | Delete an ECaccess Event |
| ecaccess-event-grant | Grant usage of an ECaccess Event |
| ecaccess-event-list | List available events |
| ecaccess-event-send | Trigger an ECaccess Event |
...
Management of ECtrans transfers
The commands for the management of ECMWF-initiated transfers (ectrans, see section 4.2) are listed in table 8. They can only be used for the management of transfers, which have used the ECaccess gateway as shown with the ecaccess-gateway-name command. Table 8: Web Toolkit commands for management of ECMWF-initiated transfers (ecaccess-ectrans-*).
| Command | Purpose |
| ecaccess-ectrans-delete | Delete ECtrans |
| ecaccess-ectrans-list | List all ectrans transfers |
| ecaccess-ectrans-request | Request a new ECtrans transfer |
| ecaccess-ectrans-restart | Restart an existing ECtrans transfer |
| Anchor | ||||
|---|---|---|---|---|
|
...
Management of ECtrans associations
Before making use of ectrans, users will need to declare an ectrans association (previously referred to as 'remote Member State user (msuser)') for the storage/retrieval of the remote file. The management of these associations can be done through the Web Toolkit commands named ecaccess-association-* listed in table 9. Table 9: Web Toolkit commands for management of ECtrans associations (ecaccess-association-*).
| Command | Purpose |
| ecaccess-association-delete | Delete Association |
| ecaccess-association-get | Get the Association Descriptive File |
| ecaccess-association-list | List your ECtrans associations |
| ecaccess-association-protocol | List the supported ECtrans Protocol |
| ecaccess-association-put | Update/Create an Association |
...
Execution return codes
The option '-debug' can be used with any Web Toolkit command to display information concerning the SOAP messages exchanged. If a Web Toolkit command doesn't work correctly, please run it with the -debug option and send the output to ECMWF for further investigation. Web Toolkit commands return 0 if successful, and a non-zero code otherwise. Each time an error occurs, a message indicating the error is displayed to the user.