Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

Reality V15.0 ()

get Command (UNIX-Connect User Guide) (m603006+get.htm)

To	Reality
Version
Topic
Submitted by
Company
Location
Email address
Comment

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: TESTFILE ITEM17
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.