Compaq TCP/IP Services for OpenVMS
Management Command Reference


Previous Contents Index


DIRECTORY

Displays a list of files, along with typical directory information, in a UNIX container directory.

Applies to: NFS server


Format

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

restrictions

Requires:

Parameters

"/path/name"

Required.

Name of the UNIX 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 directory /dove/nest/plans .


DISABLE SERVICE

For most services, this command disables the specified service but does not stop the current process. This allows you to perform an orderly shutdown of the service, which prevents new connections while allowing current connections to continue.

To stop and restart the current process:

  1. Wait until the process exits, or stop it using the service-specific shutdown command procedure (TCPIP$service_SHUTDOWN.COM).
  2. Restart the service using the service-specific startup command procedure (TCPIP$service_STARTUP.COM).

Note that, for the NFS server, TELNET, and RLOGIN, the DISABLE SERVICE command stops the current process.

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 that is bound to address 130.180.4.7.


DISCONNECT DEVICE_SOCKET

Interactively terminates a 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 terminate.


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.

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

Applies to: NFS client


Format

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

restrictions

Dismounting a /SYSTEM mount requires SYSNAM privilege.

Dismounting a /GROUP mount requires GRPNAM privilege.


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 TCP/IP Services software.

Related commands: DISABLE SERVICE, SHOW SERVICE


Format

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


Parameters

service

Optional. Default: All services.

Specifies the service to enable. The service must be defined in the services database. ENABLE NOSERVICE removes the entry for the service from the list of enabled services.


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. For instructions on how to start the SMTP sender when TCP/IP Services 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.

Specifies the container directory and name of the file you want to copy.

vms_file_name

Required.

Specifies the 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$:.


HELP

Displays online help for using management commands.

Format

HELP [ topic ]


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 ]

restrictions

No wildcards.

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.


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

Specifies a UNIX 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 privilege, 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 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.


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.


LIST COMMUNICATION_CONTROLLER

Displays the communication controllers known to the TCP/IP Services software.

Related commands: DEFINE COMMUNICATION_CONTROLLER, DELETE COMMUNICATION_CONTROLLER


Format

LIST COMMUNICATION_CONTROLLER [ controller ] [ /INTERNET_INTERFACE=character ]

restrictions

Requires OPER privilege.

Parameters

controller

Optional. Default: All devices.

Displays information about the OpenVMS device specified by controller.

Specify the controller name that was used when the device was set up with the DEFINE COMMUNICATION_CONTROLLER command.


Qualifiers

/INTERNET_INTERFACE=letter

Optional. Default: All letters.

Displays entries with the specified letter, which represents the first letter of an interface name. See the Compaq TCP/IP Services for OpenVMS Management guide for more information.


Examples

#1

TCPIP> LIST COMMUNICATION_CONTROLLER
                    Communication Controller Configuration  
 
Controller:  LO   Internet Interface:  L 
                         Description: 
                                Type:  LOCAL 
 
Controller:  WI   Internet Interface:  W 
                         Description: 
                                Type:  WIRELESS 
 
Controller:  EC   Internet Interface:  C 
                         Description: 
                                Type:  CLUSTER ETHERNET 
 
Controller:  XE   Internet Interface:  D 
                         Description: 
                                Type:  CLUSTER ETHERNET 
 
Controller:  EF   Internet Interface:  F 
                         Description: 
                                Type:  CLUSTER ETHERNET 
 
Controller:  CL   Internet Interface:  I 
                         Description:  ATM Classical IP 
                                Type:  FDDI 
 
Controller:  EL   Internet Interface:  L 
                         Description:  ATM Emulated LAN 
                                Type:  FDDI 
 
Controller:  PP   Internet Interface:  P 
                         Description:  Point to Point Protocol 
                                Type:  PPP 
 
Controller:  EB   Internet Interface:  B 
                         Description:  Shared Memory LAN 
                                Type:  CLUSTER ETHERNET 
 
Controller:  EI   Internet Interface:  I 
                         Description:  Fast Ethernet - I82558 
                                Type:  CLUSTER ETHERNET 
 
Controller:  FA   Internet Interface:  A 
                         Description: 
                                Type:  CLUSTER FDDI 
 
Controller:  FC   Internet Interface:  C 
                         Description: 
                                Type:  CLUSTER FDDI 
 
Controller:  IC   Internet Interface:  C 
                         Description: 
                                Type:  CLUSTER TOKEN_RING 
 
Controller:  IR   Internet Interface:  R 
                         Description: 
                                Type:  CLUSTER TOKEN_RING 
 
Controller:  SL   Internet Interface:  S 
                         Description: 
                                Type:  SERIAL 
 
 
Controller:  CL   Internet Interface:  I 
                         Description:  ATM Classical IP 
                                Type:  FDDI 
 
 
TCPIP>
      

Displays all the information in the table used to match OpenVMS device names with Internet interface names.


Previous Next Contents Index