connect Command

The connect command establishes a connection to a remote environment.

Syntax

connect System [ UserId{,UserPasswd} || "" ] { Account{,AcctPasswd}}
- or -
sft System [ UserId{,UserPasswd} || "" ] { Account{,AcctPasswd}}

The first syntax is used at the sft>  prompt. The second is used at the UNIX $  prompt - it starts SFT and connects to a remote environment in one operation.

Syntax Elements

System This is the name of the remote environment to which connection is required. It must be a valid system name as entered in the ROUTE-FILE by the System Administrator.

UserId This is a valid user-id on the remote environment. If the user-id is omitted or set to "", the network user-id from the USERS-FILE is used.

UserPasswd This is the password associated with the supplied user-id. If the user-id is obtained from the USERS-FILE, any associated password is also obtained from the USERS-FILE.

Account This parameter is only required when connecting to Reality. It must be the name of a valid account in the remote environment. If the account name is omitted, the user’s default account is used.

Note

If you specify an account name, set the user-id to "" to use the network user-id from the USERS-FILE.

AcctPasswd This is the password to the Reality account. If the account has a password, that password must be supplied.

Remarks

If the connection is refused an error message is displayed and the sft>  prompt repeated.

Examples

sft> connect SYS0 PROG1 TEST
sft>

In the above example a connection is made to a Reality account called TEST using a user-id of PROG1 on the system SYS0. Neither the user-id nor the account have a password.

$ sft SYS1
sft>

In this example, SFT is started with a connection to UNIX system SYS1 using the network user-id from the USERS-FILE.