glite-transfer-channel-set

glite-transfer-channel-set — Modifies a transfer channel

Synopsis

glite-transfer-channel-set [ -h ] [ -q ] [ -s SERVICE ] [ -V ] [ -v ] [ --verbose ] [ -b BANDWIDTH ] [ -c CONTACT ] [ -f FILES ] [ -S STATE ] [ -t THROUGHPUT ] [ -u TCPBUFFERSIZE ] [ -T STREAMS ] [ -m MESSAGE ] [ -k Y|N ] [ -x NUM ] [ --block-size VAL|unset ] [ --http-timeout N|unset ] [ --tx-log-level VAL ] [ --preparing-ratio VAL ] [ --urlcopy-put-to N|unset ] [ --urlcopy-putdone-to N|unset ] [ --urlcopy-get-to N|unset ] [ --urlcopy-getdone-to N|unset ] [ --urlcopy-tx-to N|unset ] [ --urlcopy-tx-marks-to N|unset ] [ --urlcopy-no-prog-to N|unset ] [ --urlcopy-tx-to-per-mb N|unset ] [ --srmcopy-direction VAL ] [ --srmcopy-to N|unset ] [ --srmcopy-refresh-to N|unset ] CHANNEL...

DESCRIPTION

glite-transfer-channel-set is a command-line tool for modifying the parameters of a data transfer channel.

OPTIONS

-h

Print a short help message on parameters and usage, and exit.

-q

Quiet operation.

-s SERVICE

Specifies the service endpoint to use. If SERVICE starts with http://, https:// or httpg://, then it is taken as a direct service endpoint URL. Otherwise SERVICE is taken as a service instance name and Service Discovery is invoked to look up the endpoint. If no entries are found, SERVICE is then interpreted as site or host name and Service Discovery is again invoked. In that case, if more than one entry is returned, the client interface version is taken as reference to choose between all the discovered instances.

If this option is not specified, Service Discovery will be invoked and the first available transfer service will be used. If the Service Discovery fails, the program will exit with an error.

Note

If this option is not specified, only services with a known good status will be returned by Service Discovery. However if you explicitely specify a service name or an endpoint, the tool will try to use it regardless of its registered status.

-v

Print details about the service endpoint being used.

--verbose

Increases the verbosity level.

-V

Print the version number and exit.

-b BANDWIDTH

Specify the bandwidth of the channel (Mbit/s).

-c CONTACT

Specify the contact e-mail address for the channel.

-f FILES

Specify the number of concurrent files allowed on the channel.

-S STATE

Specify the operational state of the channel. One of [Active, Inactive, Drain, Halted, Stopped, Archived]

-t THROUGHPUT

Specify the throughput goal to achieve.

-u TCPBUFFERSIZE

Specify the TCP buffer size for the channel.

-T STREAMS

Specify the number of concurrent streams allowed on the channel.

-m MESSAGE

To specify the reason that the change was made (recommended).

CHANNEL

The name of the channel to modify.

-k Y|N

Flag to check destination directory. If set to Y (default), each transfer process will check for the existence of the target directory and create all missing path elements. If set to N these checks and extra operations will be skipped.

-x NUM|unset

Timeout before the first non-zero transfer marker is received, in seconds. Specify "unset" to unset the value (no timeout).

--block-size VAL|unset

Default block size of a transfer, e.g. '1MB' or '1024kb'. This parameter is passed to the globus FTP client.

--http-timeout N|unset

Http timeout, in seconds. Specify "unset" to unset the value (no timeout).

--tx-log-level VAL

Log level of the transfer processes. Allowed values are DEBUG, INFO (default), WARN and ERROR.

--preparing-ratio VAL

Ratio of SRM activity to number of transfer slots.

--urlcopy-put-to N|unset

Timeout on put operation for urlcopy channels, in seconds. Specify "unset" to unset the value (no timeout).

--urlcopy-putdone-to N|unset

Timeout on putDone operation for urlcopy channels, in seconds. Specify "unset" to unset the value (no timeout).

--urlcopy-get-to N|unset

Timeout on get operation for urlcopy channels, in seconds. Specify "unset" to unset the value (no timeout).

--urlcopy-getdone-to N|unset

Timeout on getDone operation for urlcopy channels, in seconds. Specify "unset" to unset the value (no timeout).

--urlcopy-tx-to N|unset

Urlcopy transfer timeout, in seconds. Specify "unset" to unset the value (no timeout).

--urlcopy-tx-marks-to N|unset

Timeout between the receival of two consecutive non-zero transfer markers, in seconds. Specify "unset" to unset the value (no timeout).

--urlcopy-no-prog-to N|unset

Maximum time without transfer progress (indicated by non-zero transfer markers), in seconds. Specify "unset" to unset the value (no timeout).

--urlcopy-tx-to-per-mb N|unset

Additional size-based timeout (seconds/MB, floating point value). Specify "unset" to unset the value (no timeout).

--srmcopy-direction VAL

Srmcopy direction. Possible values are PUSH and PULL.

--srmcopy-to N|unset

Srmcopy timeout, in seconds. Specify "unset" to unset the value (no timeout).

--srmcopy-refresh-to N|unset

Timeout between status updates, in seconds. Specify "unset" to unset the value (no timeout).

ENVIRONMENT VARIABLES

GLITE_SD_CHANNEL_TYPE

Specifies the type of the service to use during service discovery. The default value is org.glite.ChannelManagement.