TCPIP$UCP_HELP.HLB  —  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 ]

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.
Close Help