dtscli Command—Manage Data Transfers › dtscli -tos Parameter Group—Specify the Location of the TOS

dtscli -tos Parameter Group—Specify the Location of the TOS

(Optional) The -tos parameter group specifies the location of the Transfer Object Server (TOS) and any required credentials.

Syntax format:

dtscli -tos [host=hostname] [user=username::password] [timeout=timeout] 

[port=port] [trustuser=username::password] [trustdomain=domain]

host=hostname

(Optional) Specifies the name of the host server to use for this transfer. If the server does not reside on the local computer, you must specify it explicitly using this parameter.

Default: localmachine

user=username::password

(Optional) Specifies the user name and password to connect to the server.

Default: None

timeout=timeout

(Optional) Specifies the timeout value in seconds for the transfer request to connect to the server. The timeout setting is used for all communications between the DTSCLI and the TOS.

port=port

(Optional) Specifies the legacy communications port to use when connecting to the TOS.

Default: 8198

trustuser=username::password

(Optional) Specifies the user name and password for the trusted security domain.

Note: Use the trustuser= and trustdomain= operands together to sign on to a trusted security domain and perform trusted transfers.

trustdomain=domain

(Optional) Specifies the name of the trusted security domain. When you have successfully signed on to the trusted security domain, you can perform trusted transfers in that domain. In a trusted security domain, a Data Transport Service administrator defines trusted users and the DTS agents to which they have trusted access. Trusted access means that these users can successfully activate transfers without specifying a user name and password for the Data Transport Agents in the transfer, even if the agents have their security mode set to "fail."

You can perform trusted transfers if your Data Transport Service administrator has assigned your user ID and DTS agent computer to a trusted security domain, and has completed other requirements. For more information about trusted transfers and to determine if you can perform trusted transfers, consult your Data Transport Service administrator.

Example:

In the following example, the administrator has added the trusted user redlead1 to the trusted domain redblue1. The transfer can now be performed between machines yellow and green without specifying security credentials (the iuser and ruser parameters) for the transfer.

dtscli -tos host=syd500 user=sesede::silles timeout=30 port=8898 

trustuser=redlead1::blueline trustdomain=redblue1 
-t "ipath=yellow::input_path" "rpath=green::output_path"