Copies an OpenVMS file to a UNIX file located in a container
directory.
Related commands: EXPORT, DIRECTORY
Applies to: NFS server
Format
IMPORT vms_file_name "/path/name"
[ /[NO]CONVERT ]
[ /HOST=host ]
[ /[NO]LOG ]
[ /MODE=n ]
[ /UID=n ]
[ /USER_NAME=vms_user_name ]
1 – Restrictions
No wildcards.
2 – Parameters
vms_file_name
Required.
Name of the file to copy.
"/path/name"
Required.
Specifies the name of the UNIX container directory into which you
want to copy the file and a file name.
3 – Qualifiers
3.1 /CONVERT
/CONVERT
/NOCONVERT
Optional. Default: /CONVERT.
Converts OpenVMS record files to STREAM_LF files. (The NFS server
stores UNIX files in STREAM_LF format.)
3.2 /HOST
/HOST=host
Optional.
Selects specific hosts if the proxy database has multiple host
entries with the same user name and UID.
3.3 /LOG
/LOG
/NOLOG
Optional. Default: Displays values for host, UID, GID, and user
name.
Displays a full description of the specified proxy database
record for you to determine ownership.
3.4 /MODE
/MODE=n
Optional. Default: 755 (provides the following protection for
owner, group, and world: rwx-rx-rx).
Specifies a UNIX protection mask for a new directory.
Specify octal values in the following order: user, group, others.
The values are:
o 0 - No access
o 1 - Execute access
o 2 - Write access
o 3 - Write and execute access
o 4 - Read access
o 5 - Read and execute access
o 6 - Read and write access
o 7 - Read, write, and execute access
For example, /MODE=751 provides:
User Read, write, and 7 rwx
execute access
Group Read and execute 5 rx
access
Other Execute access 1 x
3.5 /UID
/UID=n
Optional. Default: Determined with CREATE DIRECTORY.
Selects a specific entry in the proxy database to determine the
ownership of the UNIX file.
In the proxy database:
o UID and GID fields identify UNIX ownership.
o User name field identifies OpenVMS ownership.
If you want to access an entry in the proxy database without a
unique UID and user name combination, you might need to specify
the /HOST qualifier. For example, the same UID and user name
combination could appear on multiple hosts.
You can use the /UID qualifier in any combination with the /HOST
and /USER_NAME qualifiers. However, if you do not have SYSPRV or
BYPASS privilege, the values you specify must correspond to the
values for your user name in the proxy database.
3.6 /USER_NAME
/USER_NAME=vms_user_name
Optional. Default: None.
Selects a specific entry in the proxy database to determine the
ownership of the UNIX file.
The UID and GID fields in this entry establish the file's
UNIX identity, while the user name field provides the OpenVMS
ownership.
If you want to access an entry in the proxy database without a
unique UID and user name combination, you might need to specify
the /HOST qualifier. For example, the same UID and user name
combination could appear on multiple hosts.
If you have SYSPRV or BYPASS privilege and do not specify the
/USER_NAME qualifier, the proxy record with a UID of 0 and a GID
of 1 is selected.
SYSPRV or BYPASS privilege is required to select a user name
that has a UIC different from the UIC of the process running the
management program.
You can use the /USER_NAME qualifier in any combination with the
/HOST and /UID qualifiers. However, if you do not have SYSPRV or
BYPASS privilege, the values you specify must correspond to the
values for your user name in the proxy database.
If you do not specify the /USER_NAME qualifier, the proxy record
with a GID of 1 and a UID of 0 is selected. If there is no proxy
entry for the UID of 0, IMPORT fails.
4 – Examples
1.TCPIP> IMPORT USER1$:[BIRDY]JOBS.TXT "/upland/sand/piper"
Copies the file JOBS.TXT to the new file piper in the container
directory /upland/sand. The file's ownership depends on the
directory information specified with the CREATE DIRECTORY
command.