1  IMPORT
   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 ]
 

2  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.
 

2  Qualifiers
 

/CONVERT

      /CONVERT
      /NOCONVERT

   Optional. Default: /CONVERT.

   Converts OpenVMS record files to STREAM_LF files. (The NFS server
   stores UNIX files in STREAM_LF format.)
 

/HOST

      /HOST=host

   Optional.

   Selects specific hosts if the proxy database has multiple host
   entries with the same user name and UID.
 

/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.
 

/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
 

/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.
 

/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.
 

2  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.