/sys$common/syshlp/TCPIP$UCP_HELP.HLB  —  REMOVE

1  –  DIRECTORY

    Removes a link to a directory within a UNIX container directory.
    If there are no other links to it, the directory is deleted.

    Related commands: CREATE DIRECTORY, DIRECTORY

    Applies to: NFS server

    Format

      REMOVE DIRECTORY  "/path/name"

1.1  –  Restrictions

    Requires:

    o  Read and write access to the parent directory

    o  BYPASS privilege

1.2  –  Parameters

 "/path/name"

    Required.

    Directory with the link you want to remove.

1.3  –  Examples

    1.TCPIP> REMOVE DIRECTORY "/eagles/eaglet"

      Removes a link to the directory /eagles/eaglet.

2  –  EXPORT

    Deletes directory names from the export database so that they are
    not available for mounting by an NFS client.

    Related commands: ADD EXPORT, SHOW EXPORT, MAP, SET CONFIGURATION
    MAP, SET CONFIGURATION NOMAP, SHOW MAP, SHOW CONFIGURATION MAP

    Applies to: NFS server

    Format

      REMOVE EXPORT  "/path/name"

                     [ /[NO]CONFIRM ]

                     [ /HOST=host ]

2.1  –  Restrictions

    Requires read and write access to the export database.

2.2  –  Parameters

 "/path/name"

    Required.

    Directory name to delete from the export database.

2.3  –  Qualifiers

2.3.1    /CONFIRM

       /CONFIRM
       /NOCONFIRM

    Optional. Default: /CONFIRM if you use a wildcard.

    When the software encounters a match, it displays a description
    and solution. If /CONFIRM is enabled, the software then requests
    confirmation before deleting each directory name. Enter one of
    the following:

    o  Y to delete the name

    o  N to retain the name

    If you specify the /NOCONFIRM qualifier, the operation is
    performed without asking you to confirm the request.

2.3.2    /HOST

       /HOST=host

    Optional. Default: /HOST=* (all hosts).

    Host, running NFS client, that will become unable to access the
    specified container directory.

    Format for multiple hosts:

    /HOST=("host0","host1", "host2")

2.4  –  Examples

    1.TCPIP> REMOVE EXPORT "/house/finch"

      Removes the name of container directory /house/finch from the
      export database. This directory is now inaccessible to NFS
      client users.

    2.TCPIP> REMOVE EXPORT "/oceans/swamps" /HOST=("tern","crane")

      Modifies the accessibility of local UNIX directory
      /oceans/swamps. This directory is now unavailable to users
      working on hosts tern and crane, which run NFS client software.

3  –  FILE

    Removes a link to a file within a container directory. If there
    are no other links to it, the file is deleted.

    Related commands: DIRECTORY, REMOVE DIRECTORY

    Applies to: NFS server

    Format

      REMOVE FILE  "/path/name"

3.1  –  Restrictions

    Requires:

    o  Read and write access to the parent directory

    o  BYPASS privilege

3.2  –  Parameters

 "/path/name"

    Required.

    File with the link you want to remove.

3.3  –  Examples

    1.TCPIP> REMOVE FILE "/peacock/feather.care/preening"

      Removes the NFS link to the file preening.

4  –  MAIL

    Deletes mail messages from SMTP queues.

    Without the user parameter, all messages from the user name that
    correspond to your process's user name are deleted.

    Related commands: SEND MAIL, SHOW MAIL

    Applies to: SMTP

    Format

      REMOVE MAIL  [ user ]

                   [ /[NO]COPY=[directory] ]

                   [ /[NO]CONFIRM ]

                   [ /ENTRY=n ]

4.1  –  Restrictions

    Requires SYSPRV or BYPASS privilege for mail messages that are
    not yours.

4.2  –  Parameters

 user

    Optional. Default: All mail messages with your process's user
    name.

    Removes messages sent from the specified user name.

4.3  –  Qualifiers

4.3.1    /COPY

       /COPY=[directory]
       /NOCOPY=[directory]

    Optional. Default: Messages copied to the user's default
    directory.

    Copies messages to be deleted to the specified directory.

    /NOCOPY: Messages are not copied.

4.3.2    /CONFIRM

       /CONFIRM
       /NOCONFIRM

    Optional. Defaults:

    o  With an entry number specified - /NOCONFIRM

    o  Without an entry number specified - /CONFIRM

    If you specify /CONFIRM, or if you omit an entry number, requests
    confirmation before deleting each message. Respond to the
    CONFIRM: prompt by entering one of the following:

    o  Y to delete the mail message

    o  N to retain the mail message

    o  G to change to NO CONFIRMATION mode

    If you specify the /NOCONFIRM qualifier or an entry, the
    operation is performed without asking you to confirm the request.

4.3.3    /ENTRY

       /ENTRY=n

    Optional. Default: All.

    Queue entry numbers to remove from the SMTP queue.

4.4  –  Examples

    1.TCPIP> REMOVE MAIL

      Removes all messages for your process's user name, or deletes
      everything in the SMTP queue if you have either SYSPRV or
      BYPASS privilege.

    2.TCPIP> REMOVE MAIL /ENTRY=781

      Removes message 781, if it corresponds to your process's user
      name, or if you have either SYSPRV or BYPASS privilege.

    3.TCPIP> REMOVE MAIL BROOD

      Removes all messages for BROOD, if your process's user name is
      BROOD, or if you have either SYSPRV or BYPASS privilege.

    4.TCPIP> REMOVE MAIL /USER_NAME=COCKATOO /COPY=[COCKATOO.OLD_MAIL]

      Removes all messages for COCKATOO, if this is your process's
      user name, or if you have either SYSPRV or BYPASS privilege.
      Before deletion, copies this queued mail to the specified
      directory.

5  –  PROXY

    Deletes entries from the volatile and permanent proxy database.

    Related commands: ADD PROXY, SHOW PROXY

    Applies to: NFS server, NFS client, PC-NFS, remote shell,
    LPR/LPD, and customer-developed services

    Format

      REMOVE PROXY  [ user_name ]

                    [ /COMMUNICATION ]

                    [ /[NO]CONFIRM ]

                    [ /GID=n ]

                    [ /HOST=host ]

                    [ /NFS=options ]

                    [ /PERMANENT ]

                    [ /REMOTE_USER=user ]

                    [ /UID=n ]

5.1  –  Restrictions

    Requires:

    o  Read and write access to the proxy database

    o  One of the following privileges:

       -  SYSPRV

       -  SYSLCK

       -  OPER

5.2  –  Parameters

 user_name

    Optional. Default: All entries (REMOVE PROXY *).

    Deletes the specified entries from the proxy database.

5.3  –  Qualifiers

5.3.1    /COMMUNICATION

    Optional. Default: Both communication and NFS entries.

    Deletes communication (non-NFS) proxies.

5.3.2    /CONFIRM

       /CONFIRM
       NOCONFIRM

    Optional. Default: /CONFIRM if you use a wildcard.

    With /CONFIRM enabled, the software requests confirmation before
    deleting records. At the CONFIRM: prompt, enter one of the
    following:

    o  Y to delete the entry

    o  N to retain the entry

    o  G to change to NO CONFIRMATION mode

    If you specify the /NOCONFIRM qualifier, the operation is
    performed without asking you to confirm the request.

5.3.3    /GID

       /GID=n

    Optional. Default: All GIDs.

    Deletes only proxies for the specified group identifier (GID).

5.3.4    /HOST

       /HOST=host

    Optional. Default: All hosts.

    Deletes only proxies for the specified host.

5.3.5    /NFS

       /NFS=INCOMING
       /NFS=OUTGOING

    Optional. Default: /NFS=(INCOMING,OUTGOING).

    Deletes an NFS proxy. Specify one of the following:

    /NFS=OUTGOING        Proxy to use NFS client
    /NFS=INCOMING        Proxy to use NFS server
    /NFS=(OUTGOING,INCOMIProxy to use NFS client and NFS server

5.3.6    /PERMANENT

    Optional. Default: None.

    Deletes entries only from the permanent proxy database.

5.3.7    /REMOTE_USER

       /REMOTE_USER=user

    Optional. Default: None.

    Deletes entries for the specified remote user name.

5.3.8    /UID

       /UID=n

    Optional. Default: All UIDs.

    Limits the search of entries to delete to proxies for the
    specified UID.

5.4  –  Examples

    1.TCPIP> REMOVE PROXY "peacock" /HOST=GOLDEN /UID=83

      Removes authorization for UID 83 on host GOLDEN from OpenVMS
      account peacock.

    2.TCPIP> REMOVE PROXY /HOST=GOLDEN /UID=83

      Removes authorization for UID 83 from host GOLDEN.

    3.TCPIP> REMOVE PROXY /HOST=("goose","grouse")

      Removes authorization for all users on hosts goose and grouse.

    4.TCPIP> REMOVE PROXY /UID=83

      Totally removes authorization for UID 83.

    5.TCPIP> REMOVE PROXY VMS_USER /REMOTE=PARTRIDGE /HOST=*

      Removes authorization for remote user PARTRIDGE on all hosts.
Close Help