get Command
The get command allows you to copy data from a remote environment to files in a directory in the local UNIX environment.
Syntax
get { RealityFile { [ ItemId || * ] } }
- or -
get { Directory { [ UnixFile ||
* ] } }
Syntax Elements
RealityFile is the Reality file containing the item or items to be copied.
ItemId is the item-id of a single item in the specified Reality file.
Directory is the UNIX directory containing the file or files to be copied.
UnixFile is the name of a single UNIX file to be copied.
Note
You must leave a space between the UNIX directory and file name.
* Specifies that all items or files (as appropriate) are to be copied.
The get command prompts for its parameters as follows:
-
Used with no parameters, get prompts for the source RealityFile and ItemId, or Directory and UnixFile as appropriate, and for the destination directory. For example:
sft>
get
FROM: TESTFILE ITEM17
TO:fred
*
[ 1 item(s) transferred]
sft> -
Used with only a RealityFile or Directory parameter, get displays the following message:
[ITEMID required - Ctrl-D to cancel]
It then prompts for the source ItemId or UnixFile as appropriate, and for the destination directory. For example:
sft>get TESTFILE
[ITEMID required - Ctrl-D to cancel]
FROM: TESTFILEITEM17
TO:fred
*
[ 1 item(s) transferred]
sft>
-
Used with both a RealityFile or Directory parameter and an ItemId or UnixFile, get prompts only for the destination directory. For example:
sft>
get TESTFILE ITEM17
TO:fred
*
[ 1 item(s) transferred]
sft>
The files created in the destination directory will have the same names as the source items or files (as appropriate).
Note
You cannot use UNIX wild-card characters in the Directory or UnixFile parameters, or in the destination directory name.
Remarks
You can only use the get command if a connection to a remote environment has already been established by using the connect command.
The destination UNIX directory must already exist before you use the get command.
Reality items whose item-ids contain the ?/? character cannot be transferred.
An asterisk is displayed on the screen for each item or file transferred.
Examples
sft>get
FROM:TEST ITEM01
TO:fred
*
[ 1 item(s) transferred]
sft>!ls fred
ITEM01
In the above example a single Reality item (with the item-id ITEM01) is transferred to a directory with a relative pathname of fred. The item is written to a file called ITEM01.
sft>get DICT TEST *
TO:fred
***
[ 3 out of 3 item(s) transferred]
sft>!ls fred
ITEM01
ITEM02
ITEM03
sft>
In this example all the items from the dictionary section of the file TEST are transferred to a UNIX directory with a relative pathname of fred. The items are written to UNIX files called ITEM01, ITEM02 and ITEM03.
sft>get
FROM:/usr/gill *
TO:/home/gill
****
[ 4 out of 4 item(s) transferred]
sft>!ls /home/gill
myfile
testfile
mailfile
oldfile
sft>
In the third example, all the files within the directory /usr/gill on the remote system are transferred to the directory /usr/gill on the local system.