DIGITAL TCP/IP Services for OpenVMS
Management Command Reference


Previous Contents Index


DELETE CONTAINER

Deletes a DIGITAL TCP/IP Services for OpenVMS container file system and all its contents. Applies to the NFS server.

Related commands: CREATE CONTAINER, SHOW CFS


Format

DELETE CONTAINER container_file_system

restrictions

Wildcards are not allowed.

Requires both read and delete access to the directory.

Requires BYPASS privileges.


Parameters

container_file_system

Required.

Device and directory name of the container file (no wildcards).

The container file has file type .CONTAINER.


Examples

#1

TCPIP> DELETE CONTAINER WORK1$:[DOVE.NEST_BUILDING]  
      

Deletes the container directory WORK1$:[DOVE.NEST_BUILDING] along with the container file, all subdirectories, and files.


DIRECTORY

Displays a list of files, along with typical directory information, in a UNIX style container directory. Applies to the NFS server.

Format

DIRECTORY "/path/name" [ /FULL ] [ /VMS ]

restrictions

Requires:

Parameters

"/path/name"

Required.

Name of the UNIX style container directory for which you want a directory listing and, optionally, directory names.


Qualifiers

/FULL

Optional. Default: Brief display.

Displays a comprehensive list of information, including the OpenVMS file name, for each file.

/VMS

Optional. Default: No OpenVMS file names provided.

Provides the corresponding OpenVMS file name for each file.


Examples

#1

TCPIP> DIRECTORY/FULL "/nest_container"  
    
Directory:  /nest_container  
    
 .                                                                   
 OpenVMS file: _$1$DISK:[SYSTEM.NEST.HATCHLING]00012301$BFS.DIR;1  
 Size                                File ID:   74497  
  Blocks:            4               Owner  
  Bytes:          1915                UID:          0  
 Created:   1-NOV-1997 13:17:18.91    GID:          1  
 Revised:   1-NOV-1997 13:17:19.24   Mode:        755  Type: Directory  
 Accessed:  1-NOV-1997 13:16:20.52   Links:         2  
    
     ..  
 OpenVMS file: _$1$DISK:[SYSTEM.NEST.HATCHLING]00012301$BFS.DIR;1  
 Size                                File ID:   74497  
  Blocks:            4               Owner  
  Bytes:          1915                UID:          0  
 Created:   1-NOV-1997 13:17:18.91    GID:          1  
 Revised:   1-NOV-1997 13:17:19.24   Mode:        755  Type: Directory  
 Accessed:  1-NOV-1997 13:16:20.52   Links:         2  
  
     .SUPER.SYS  
 OpenVMS file: no corresponding file  
 Size                                File ID:    6145  
  Blocks:            1               Owner  
  Bytes:            54                UID:          0  
 Created:   1-NOV-1997 13:17:18.91    GID:          1  
 Revised:   1-NOV-1997 13:17:17.24   Mode:        644  Type: File  
 Accessed:  1-NOV-1997 13:16:18.52   Links:         1  
  
     .BITMAP.SYS  
 OpenVMS file: no corresponding file  
 Size                                File ID:    6657  
  Blocks:           16               Owner  
  Bytes:          8187                UID:          0  
 Created:   1-NOV-1997 13:17:18.91    GID:          1  
 Revised:   1-NOV-1997 13:17:17.24   Mode:        644  Type: File  
 Accessed:  1-NOV-1997 13:16:18.52   Links:         1  
  
     .HISTORY.SYS  
 OpenVMS file: no corresponding file  
 Size                                File ID:   66305  
  Blocks:            1               Owner  
  Bytes:           129                UID:          0  
 Created:   1-NOV-1997 13:17:18.91    GID:          1  
 Revised:   1-NOV-1997 13:17:17.24   Mode:        644  Type: File  
 Accessed:  1-NOV-1997 13:16:18.52   Links:         1  
  
      

Displays a full directory listing of the container file system /nest_container.

#2

TCPIP> DIRECTORY "/dove/nest/plans"  
      

Displays names of the files in UNIX style directory /dove/nest/plans.


DISABLE SERVICE

Sets the auxiliary server so it does not start the specified service.

SET SERVICE does not modify dynamic information about services. Therefore, to change the auxiliary server's configuration for services, issue the DISABLE SERVICE and ENABLE SERVICE commands to toggle between disabled and enabled states.

Related commands: ENABLE SERVICE, SET SERVICE, SHOW SERVICE


Format

DISABLE SERVICE service
[ /ADDRESS=IP_address ]
[ /PORT=n ]
[ /PROCESS=process ]
[ /PROTOCOL=protocol ]


Parameters

service

Required.

Service you want to disable. Specify any service that appears in the SHOW SERVICE display. To disable all services, use a wildcard.


Qualifiers

/ADDRESS=IP_address

Optional. Default: 0.0.0.0.

Disables only the services for the specified address.

/PORT=n

Optional. Default: All ports.

Disables the service communicating at the specified port.

/PROCESS=process

Optional. Default: All processes.

Disables the service running as the specified process.

/PROTOCOL=protocol

Optional. Default: All protocols.

Disables only the services that use the specified protocol.


Examples

#1

TCPIP> DISABLE SERVICE TELNET   
      

Disables TELNET.

#2

TCPIP> DISABLE SERVICE RLOGIN /ADDRESS=130.180.4.7   
      

Disables the remote login process bound to address 130.180.4.7.


DISCONNECT DEVICE_SOCKET

Interactively terminates an existing TCP/IP connection.

Format

DISCONNECT DEVICE_SOCKET dev_sock_number


Parameters

dev_sock_number

Required.

Number of the device socket associated with the connection you want to abort.


Examples

#1

TCPIP> DISCONNECT DEVICE_SOCKET BG123  
      

Interactively terminates the connection at DEVICE_SOCKET BG123.


DISMOUNT

Makes a physically remote file system that is currently accessible to local users inaccessible. Applies to the NFS client.

Dismounts a remote file system or directory from local device DNFSn: (the mount point).

Required order of command keywords: the DISMOUNT keyword, immediately followed by mount_point. Example: DISMOUNT DNFS03:.

Related commands: MOUNT, SHOW MOUNT


Format

DISMOUNT { mount_point | logical_name }
[ /ALL ]
[ /HOST=host ]
[ /[NO]WAIT ]

restrictions

Dismounting a /SYSTEM mount requires SYSNAM privileges.

Dismounting a /GROUP mount requires GRPNAM privileges.


Parameters

mount_point

Required (if you omit logical_name and the /ALL qualifier). Default: None.

DNFS device (and optional directory tree) required to dismount. Specify this mount point as one of the following:


DNFSn:   
DNFSn:[dir.subdir]  
DNFSn:[dir.subdir]file  

where:
n Value from 1 to 9999.
   
[ dir] or
[ dir.subdir]
Directory to mount
(up to eight in addition to the [000000] directory).
   
file Individual file to dismount.
   

Note

Type the device name immediately after the keyword DISMOUNT.

If you use the /ALL qualifier, you must specify DNFSn: without the directory tree.

logical_name

Required (if you omit mount_point and the /ALL qualifier). Default: None.

Logical name that you defined with the MOUNT command of the device to dismount.


Qualifiers

/ALL

Optional.

Dismounts one of the following:

If you dismount using the /ALL qualifier, the dismount operation completes even if the server is not currently reachable.

/HOST=host

Optional. Default: None.

Dismounts all file systems from the specified NFS server.

/WAIT

/NOWAIT

Optional. Default: /NOWAIT.

Examples

#1

TCPIP> DISMOUNT DNFS3:  
      

Makes the file system mounted on local device DNFS3: inaccessible to local users.

#2

TCPIP> DISMOUNT DNFS4:[USR.MNT]  
      

Dismounts only the specified mount point, [USR.MNT], on local device DNFS4:.

#3

TCPIP> DISMOUNT DNFS5: /WAIT  
      

Dismounts the DNFS5:[000000] mount point and waits for it to occur.

#4

TCPIP> DISMOUNT /ALL  
      

Dismounts all mount points on all devices.

#5

TCPIP> DISMOUNT /ALL /HOST="robin"  
      

Dismounts all mount points served by host robin.


ENABLE SERVICE

Enables a service on the running DIGITAL TCP/IP Services for OpenVMS software.

Related commands: DISABLE SERVICE, SHOW SERVICE


Format

ENABLE SERVICE [ service ]
[ /ADDRESS=IP_address ]
[ /PORT=n ]
[ /PROCESS=process ]
[ /PROTOCOL=protocol ]


Parameters

service

Optional. Default: All services.

Service to enable. The service must be defined in the services database.


Qualifiers

/ADDRESS=IP_address

Optional. Default: 0.0.0.0.

Binds the service only to the specified address. If your host is multihomed, use this qualifier to configure the service to be offered on a specific internet interface.

/PORT=n

Optional. Starts the service on the specified port.

/PROCESS=process

Optional.

Runs the service as the specified process.

/PROTOCOL=protocol

Optional. Default: TCP.

Runs the service with the specified protocol.


Examples

#1

TCPIP> ENABLE SERVICE TELNET  
      

Initializes TELNET communications.

#2

TCPIP> ENABLE SERVICE RLOGIN /ADDRESS=130.180.4.7  
      

Starts the Remote Login service for users on the host with IP address 130.180.4.7.

#3

TCPIP> ENABLE SERVICE SMTP  
      

Starts the SMTP receiver. To start the SMTP sender, see the START MAIL command. To start the SMTP sender when DIGITAL TCP/IP Services for OpenVMS starts up, see the SET CONFIGURATION ENABLE SERVICE command.


EXIT

Exits from the management program.

Format

EXIT


EXPORT

Copies a file from within a container directory to an OpenVMS file.

Related commands: IMPORT, DIRECTORY


Format

EXPORT "/path/name" vms_file_name

restrictions

No wildcards.

Parameters

"/path/name"

Required.

Container directory and name of the file you want to copy.

vms_file_name

Required.

Target OpenVMS file name for the copied file.


Examples

#1

TCPIP> EXPORT "/upland/sand/piper" USER1$:[BIRDY]JOBS.TXT  
      

Copies the file piper from the container directory /upland/sand to the regular OpenVMS file JOBS.TXT in directory [BIRDY] on disk USER1$:.


GENERATE MAP

Executes the mapping created with SET CONFIGURATION MAP commands.

When the NFS server starts up, it issues GENERATE MAP. This command is not usually entered manually.

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


Format

GENERATE MAP

restrictions

Requires SYSPRV and BYPASS privileges

Examples

#1

TCPIP> GENERATE MAP  
      

Enables mapping information for NFS created with SET CONFIGURATION MAP commands from the configuration database.


HELP

Displays online help for using management commands.

Format

HELP [ topic ]


IMPORT

Copies an OpenVMS file to a UNIX style file located in a container directory. Applies to the NFS server.

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 ]

restrictions

No wildcards.

Parameters

vms_file_name

Required.

Name of the file to copy.

"/path/name"

Required.

Name of the UNIX style container directory into which you want to copy the file and a file name.


Qualifiers

/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

Optional.

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

/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=n

Optional. Default: 755 (provides the following protection for owner, group, and world: rwx-rx-rx).

UNIX style protection mask for a new directory.

Specify octal values in the following order: user, group, others. The values are:

For example, /MODE=751 provides:
User Read, write, and execute access 7 rwx
Group Read and execute access 5 rx
Other Execute access 1 x

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

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 privileges, the values you specify must correspond to the values for your user name in the proxy database.

/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 privileges 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 privileges are 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 privileges, 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.


Examples

#1

TCPIP> IMPORT USER1$:[BIRDY]JOBS.TXT "/upland/sand/piper"  
      

Copies file JOBS.TXT to the container directory /upland/sand/piper. The file's ownership is determined with CREATE DIRECTORY.


Previous Next Contents Index