Advanced Server for OpenVMS
Commands Reference Manual


Previous Contents Index


STOP SERVICE

Stops a currently running network service. Use the SHOW SERVICES command to display a list of available network services.

Format

STOP SERVICE servicename [/qualifiers]

restrictions

Use of this command requires membership in the Administrators local group or the Server Operators local group.

Related Commands


Parameters

servicename

Specifies the name of the network service to stop.

Qualifiers

/CONFIRM

/NOCONFIRM

Controls whether you are prompted for a confirmation before the operation is performed. The default is /CONFIRM if running in interactive mode. When the prompt is issued, the default response is shown, and you may accept the default by pressing Return or Enter. If you type YES, TRUE, or 1, the operation is performed. If you type NO, FALSE, 0, or enter Ctrl/Z, no action is performed. If you type anything else, the prompt is repeated until you type an acceptable response. No prompt for confirmation is issued if running in batch mode.

/SERVER=server-name

Specifies the name of the server on which to stop the service. The default is the server currently being administered.

Example


LANDOFOZ\\TINMAN> STOP SERVICE NETLOGON 
 
Do you really want to stop service "NETLOGON" [YES or NO] (YES) : YES 
%PWRK-I-SVCOPWAIT, attempting to stop the "NETLOGON" service on "TINMAN" 
%PWRK-S-SVCSTOP, service "NETLOGON" stopped on server "TINMAN" 
      

This example stops the NetLogon service on the server currently being administered (TINMAN). A confirmation is required.


TAKE FILE OWNERSHIP

Takes ownership of the specified file or directory. By granting permissions, the owner controls how a file or directory can be accessed by others. For instance, the owner of a file or directory can grant TAKE OWNERSHIP access rights to another user who can then use the TAKE FILE OWNERSHIP command to become the new owner. (You can grant ownership access rights for a file or directory by using the SET FILE/PERMISSIONS command with either the /FILE_SPECIFIC=TAKE_OWNERSHIP or /DIRECTORY_SPECIFIC=TAKE_OWNERSHIP qualifiers.) Members of the Administrators group have privileges that allow them to TAKE FILE OWNERSHIP without being granted the TAKE OWNERSHIP permission.

Format

TAKE FILE OWNERSHIP path [/qualifier]

restrictions

You must be a member of the Administrators group to take ownership of a file or directory.

Related Commands


Parameters

path

Specifies the UNC (Universal Naming Convention) path to the directory or file for which to take ownership. Wildcards are not accepted within directory or file names.

Qualifiers

/SERVER=server-name

Specifies the name of the server on which to take ownership of the directory or file. The default is the server currently being administered.

Example


LANDOFOZ\\TINMAN> TAKE FILE OWNERSHIP STATES\KANSAS\FILE1.DAT 
%PWRK-S-FILEMOD, "\\TINMAN\STATES\KANSAS\FILE1.DAT" modified 
      

This example takes ownership of the file FILE1.DAT in the directory KANSAS in the shared directory STATES on the server currently being administered (TINMAN). The new owner of the file will be the currently logged-on user.


TELL

Use the TELL command to perform one or more administrative commands on a remote server.

Format

TELL server-name [/qualifier] [remote-command]

restrictions

Use of this command requires membership in the Administrators local group. The command cannot be used to manage a Windows NT Server.

Parameters

server-name

Specifies the name of the server on which to execute the command.

remote-command

Specifies the administrative command to be executed on the remote server. It must physically be the last item on the command line.

If remote-command is not specified, a command processor is started to receive multiple administrative commands to the remote server. In this case, the local prompt is changed to \\servername>> and all further commands are sent to the remote server until you enter Ctrl/Z or EXIT. If the remote server is an Advanced Server, you can enter only ADMINISTER commands. For PATHWORKS for OpenVMS (LAN Manager) servers, you can enter only LAN Manager Net commands.

If you wish to perform an ADMINISTER command, do not specify the ADMINISTER command on the remote-command. For Net commands, you must precede the Net command with NET on the remote-command.


Qualifiers

/PASSWORD[=password]

/NOPASSWORD

Specifies the password to use for connection to the appropriate remote server. If you do not specify a value for password, or specify it as an asterisk (*), you are prompted for a password that is not displayed as it is entered.

If you do not specify the /PASSWORD qualifier, then the password used when you logged on to the network is used. If this password is not valid, then you will be prompted to enter a valid password for connection to the remote server. The default is /NOPASSWORD.


Examples

#1

 LANDOFOZ\\TINMAN> TELL WOODMAN NET VERSION 
 %PWRK-I-SRVINFO, the server type is: LAN Manager 2.2 for OpenVMS 
 
 PATHWORKS V5 for OpenVMS (LAN Manager) 
 Version 5.0E 
      

This example performs the NET VERSION command on the remote server WOODMAN, which is a PATHWORKS for OpenVMS (LAN Manager) server. The password used to connect to the remote server is the password specified when you logged on to the network.

#2

 LANDOFOZ\\TINMAN> TELL DOROTHY/PASSWORD="OverTheRainbow" SHOW VERSION 
 %PWRK-I-SRVINFO, the server type is: Advanced Server 3.51 for OpenVMS 
 
 Advanced Server V7.2 for OpenVMS 
 
 
 
      

This example performs the ADMINISTER SHOW VERSION command on the remote server DOROTHY. The password used to connect to server DOROTHY is OverTheRainbow.

#3

 LANDOFOZ\\TINMAN> TELL DOROTHY 
 %PWRK-I-SRVINFO, the server type is: Advanced Server 3.51 for OpenVMS 
 
 \\DOROTHY>> SHOW VERSION 
 
 Advanced Server V7.2 for OpenVMS 
 
 \\DOROTHY>> SHOW SERVICES 
 
 Services on server "DOROTHY": 
 
 Service          Status 
 ---------------  --------------- 
 ALERTER          Started 
 BROWSER          Started 
 EVENTLOG         Started 
 NETLOGON         Started 
 SERVER           Started 
 
   Total of 5 services 
 
 \\DOROTHY>> EXIT 
 
 LANDOFOZ\\TINMAN> 
 
 
 
      

This example starts a command processor so that multiple commands may be performed on remote server DOROTHY. The SHOW VERSION and SHOW SERVICES commands are performed on DOROTHY. When EXIT is entered as the command, the command processor is terminated and the TELL command is completed.


Chapter 3
Net Commands and ADMINISTER Command Equivalents

This chapter contains a subset of PATHWORKS V5 for OpenVMS (LAN Manager) Net commands and their ADMINISTER command equivalents implemented for the Advanced Server. This provides backward compatibility to a subset of PATHWORKS LAN Manager Net commands. However, administrators are strongly encouraged to use ADMINISTER commands instead of Net commands.

3.1 Command Mappings

The rest of this chapter lists examples of Net commands and their ADMINISTER command equivalents. To see a display of the appropriate ADMINISTER command on your system, enter the NET/TRANSLATE command at either the domainname\\servername> prompt or the DCL prompt.

For example:

$ NET/TRANSLATE ACCOUNT /ROLE:PRIMARY

or

domainname\\servername> NET/TRANS ACCOUNT /ROLE:PRIMARY

Some commands have no equivalent; for these commands, you see an explanatory message preceded by a % sign. For example:

$ NET/TRANSLATE NET STATISTICS

%PWRK-E-INVLDCMD, invalid command entered

$ ADMINISTER NET/TRANSLATE access dsk1:[user] /add

%PWRK-E-NSUDCL, no support for "net access resource /add", Use "ADMINISTER SET FILE path"
Example of Existing OpenVMS Net Command ADMINISTER Command Equivalent
NET ACCESS    
net access The net access command is not supported. Use the ADMINISTER SET FILE path command.
NET ACCOUNTS    
net accounts SHOW ACCOUNT POLICY
net accounts /role: SET COMPUTER /ROLE=
  Options:    
  member   Invalid role for the Advanced Server.
  standalone   Invalid role for the Advanced Server.
  primary   PRIMARY_DOMAIN_CONTROLLER
  backup   BACKUP_DOMAIN_CONTROLLER
net accounts /sync SET COMPUTER /ACCOUNT_SYNCHRONIZE
net accounts (valid with the following relevant options) SET ACCOUNT POLICY
  Options:    
  /forcelogoff: number   /FORCE_DISCONNECT
  /forcelogoff:no   /NOFORCE_DISCONNECT
  /lockout:no   /NOLOCK_OUT
  /lockout: number   /LOCK_OUT=(ATTEMPTS= number)
  /minpwlen: length
/maxpwage: days
/minpwage: days
/uniquepw: number
(other than 0)
  /PASSWORD_POLICY=(MINLENGTH= length, MAXAGE= days, MINAGE= days, HISTORY= number)
  /maxpwage:unlimited
/uniquepw:0
  /PASSWORD_POLICY=(NOMAXAGE, NOHISTORY)
NET ADMIN    
net admin \\ servername /command ADMINISTER servername
  Options:    
  password   /PASSWORD=" password"
  *   /PASSWORD
  /command net command   NET command
NET AUDIT    
net audit/delete CLEAR EVENTS /TYPE=SYSTEM
net audit SHOW EVENTS /TYPE=SYSTEM
  Options:    
  /count: number   /COUNT= number
  /reverse   /SORT=(DESCENDING)
NET CONFIG    
net config The net config command is not supported.
NET CONTINUE    
net continue servicename CONTINUE SERVICE servicename
net continue print= printername SET PRINT QUEUE printername/CONTINUE
NET DEVICE    
net device SHOW PRINT QUEUES
  Option:    
  printername   printername
net device printername (valid with the following relevant options) SET PRINT QUEUE printername
  Options:    
  /delete   /DELETE
  /restart   /RESTART
NET ERROR    
net error /delete CLEAR EVENTS /TYPE=SYSTEM
net error SHOW EVENTS /TYPE=SYSTEM
  Options:    
  /count: number   /COUNT= number
  /reverse   /SORT=(DESCENDING)
NET FILE    
net file id/close CLOSE OPEN_FILE id
net file SHOW OPEN_FILES
  Option:    
  id   id
NET GROUP    
net group SHOW GROUPS /FULL
  Option:    
  groupname   groupname
net group groupname/delete REMOVE GROUP " groupname"
net group groupname/add ADD GROUP " groupname"
  Option:    
  /comment:" text"   /DESCRIPTION=" text"
net group groupname username1 username2 (valid only with the following relevant options) MODIFY GROUP " groupname"
  Options:    
  /add   /ADD_MEMBERS=(" username1", " username2" )
  /delete   /REMOVE_MEMBERS=(" username1", " username2" )
net group groupname/comment:" text" MODIFY GROUP " groupname" /DESCRIPTION=" text"
NET HELP, NETHELPMSG    
net help
net helpmsg
The net help and net helpmsg commands are unsupported; use the ADMINISTER HELP command.
NET LOGON    
net logon LOGON
  Options:    
  username   " username"
  password   " password"
  * (for password)   *
  /domain: name   /DOMAIN= name
NET LOGOFF    
net logoff LOGOFF
NET PASSWORD    
net password SET PASSWORD
  Options:    
  username   " username"
  oldpassword   " oldpassword"
  newpassword   " newpassword"
  * (for newpassword)   *
  \\ servername   Not supported
  /domain: name   /DOMAIN= name
NET PAUSE    
net pause service PAUSE SERVICE service
net pause print The net pause print command is not supported.
net pause print= printername SET PRINT QUEUE printername /PAUSE
NET PRINT    
net print SHOW PRINT QUEUES
  Options:    
  sharename   sharename
  \\ servername   /SERVER= servername
  devicename:   devicename:
net print sharename (or queuename)
(valid only with the relevant following options)
SET PRINT QUEUE queuename
  Options:    
  /remark:" text"   /DESCRIPTION=" text"
  /route: print1, print2   /ROUTE_TO=( print1, print2)
  /hold   /PAUSE
  /release   /CONTINUE
  /purge   /PURGE
net print sharename (or queuename) /delete REMOVE PRINT QUEUE queuename
net print job
(valid with the following relevant options)
SET PRINT JOB job
  Options:    
  /hold   /HOLD
  /release   /RELEASE
  /first   /FIRST
  /last   /LAST
  /delete   /DELETE
net print \\ servername job SHOW PRINT JOBS job /SERVER= servername
net print \\ servername job
(valid with the following relevant options)
SET PRINT JOB job /SERVER= servername
  Options:    
  /hold   /HOLD
  /release   /RELEASE
  /delete   /DELETE
NET SEND    
net send alias " message" SEND " alias" " message"
net send * " message" The net send * " message" command is not supported.
net send /users " message" SEND /USERS " message"
net send /domain: name " message" The net send /domain: name " message" command is not supported.
NET SESSION    
net session SHOW SESSIONS
  Option:    
  \\ computername   computername
net session \\ computername /delete CLOSE SESSION computername
net session /delete CLOSE SESSION *
NET SHARE    
net share SHOW SHARES
  Options:    
  /personal   /TYPE=PERSONAL
  sharename   sharename/FULL
net share (valid with the following relevant options) ADD SHARE/DIRECTORY, ADD SHARE/PRINT
  Options:    
  ipc$   /IPC
  admin$   /ADMIN
  ipc$ password   Share-level security is not supported.
net share sharename= pathname ADD SHARE/DIRECTORY sharename pathname
  Options:    
  /personal   /PERSONAL
  /users: number   /LIMIT= number
  /remark:" text"   /DESCRIPTION=" text"
  /unlimited   /NOLIMIT
  password   Share-level security is not supported.
  /permissions: permissions   Share-level security is not supported.
net share sharename/print ADD SHARE/PRINT sharename queuename
net share printshare= devicename/print ADD SHARE/PRINT printshare devicename
  Options:    
  /users: number   /LIMIT= number
  /unlimited   /NOLIMIT
  /remark:" text"   /DESCRIPTION=" text"
net share sharename
(valid with the following relevant options)
MODIFY SHARE sharename
  Options:    
  /users: number   /LIMIT= number
  /remark:" text"   /DESCRIPTION=" text"
  /unlimited   /NOLIMIT
net share sharename/delete REMOVE SHARE sharename
NET START    
net start SHOW SERVICES
net start service START SERVICE service
NET STATISTICS    
net statistics The net statistics command is not supported.
NET STATUS    
net status The net status command is not supported.
NET STOP    
net stop service STOP SERVICE service
NET TIME    
net time The net time command is not supported.
NET USER    
net user SHOW USERS
net user username password/add ADD USER " username"/PASSWORD=" password"
    Default values:
    /FLAGS=(NODISUSER, PWDEXPIRED, NOPWDLOCKED)
    /PRIMARY_GROUP=" Domain Users"
net user username * /add ADD USER " username" /PASSWORD
    Default values:
    /FLAGS=(NODISUSER, PWDEXPIRED, NOPWDLOCKED)
    /PRIMARY_GROUP=" Domain Users"
  Options:    
  /active:no   /FLAGS=(DISUSER)
  /active:yes   /FLAGS=(NODISUSER)
  /comment:" text"   /DESCRIPTION=" text"
  /countrycode: number   Not mapped; the default country code is always set.
  /expires: date   /EXPIRATION_DATE= date
(Date is equivalent OpenVMS date. For example, 09-Jan-1999.)
  /expires:never   /NOEXPIRATION_DATE
  /fullname:" Firstname Lastname"   /FULL_NAME=" Firstname Lastname"
  /homedir: pathname   /HOME=(PATH= pathname)
  /homedirreq:no   /NOHOME
  /logonserver:\\ computername   Not mapped. A default logon server, such as the primary domain controller, is always set.
  /maxstorage: number   Not mapped. A high value of maxstorage is always set by default.
  /operator:accounts   /MEMBER_OF_GROUPS=("Domain Users", "Account Operators")
  /operator:print   /MEMBER_OF_GROUPS=("Domain Users", "Print Operators")
  /operator:server   /MEMBER_OF_GROUPS=("Domain Users", "Server Operators")
  /operator:comm   Not mapped.
  /operator:print, accounts, server   /MEMBER_OF_GROUPS=("Domain Users", "Print Operators", "Account Operators", "Server Operators")
  /passwordchg:yes   /FLAGS=(NOPWDLOCKED)
  /passwordchg:no   /FLAGS=(NOPWDEXPIRED, PWDLOCKED)
  /passwordreq:no   /NOPASSWORD
  /privilege:admin   /MEMBER_OF_GROUPS=("Domain Admins") /PRIMARY_GROUP="Domain Admins"
  /privilege:guest   /MEMBER_OF_GROUPS=("Domain Guests") /PRIMARY_GROUP="Domain Guests"
  /privilege:user   /MEMBER_OF_GROUPS=("Domain Users") /PRIMARY_GROUP="Domain Users"
  /scriptpath: pathname   /SCRIPT= pathname
  /times:all   /HOURS=(SUNDAY=(0-23),
MONDAY=(0-23),
TUESDAY=(0-23),
WEDNESDAY=(0-23),
THURSDAY=(0-23),
FRIDAY=(0-23),
SATURDAY=(0-23))
  /times: times   /HOURS=( times)
  /usercomment:" text"   Not mapped.
  /workstations: computer1,computer2   /WORKSTATIONS=( computer1, computer2)
  /workstations:*   /WORKSTATIONS=(*)
net user username/delete REMOVE USER " username"
net user username password MODIFY USER " username" /PASSWORD=" password"
net user username * MODIFY USER " username"/PASSWORD
  Options are identical to those for net user username/add, except for the values for the following qualifiers:    
  /operator:accounts   /ADD_TO_GROUPS=("Account Operators")
/REMOVE_FROM_GROUPS=("Print Operators", "Server Operators")
  /operator:print   /ADD_TO_GROUPS=("Print Operators")
/REMOVE_FROM_GROUPS=("Server Operators", "Account Operators")
  /operator:server   /ADD_TO_GROUPS=("Server Operators")
/REMOVE_FROM_GROUPS=("Print Operators", "Account Operators")
  /operator:accounts,print,server   /ADD_TO_GROUPS=("Account Operators", "Print Operators", "Server Operators")
  /privilege:admin   /ADD_TO_GROUPS=("Domain Admins")
/REMOVE_FROM_GROUPS=("Domain Users", "Domain Guests") /PRIMARY_GROUP="Domain Admins"
  /privilege:user   /ADD_TO_GROUPS=("Domain Users")
/REMOVE_FROM_GROUPS=("Domain Admins", "Domain Guests") /PRIMARY_GROUP="Domain Users"
  /privilege:guest   /ADD_TO_GROUPS=("Domain Guests")
/REMOVE_FROM_GROUPS=("Domain Admins", "Domain Users") /PRIMARY_GROUP="Domain Guests"
NET VERSION    
net version SHOW VERSION
NET VIEW    
net view SHOW COMPUTERS
  Option:    
  \\ servername   servername
NET WHO    
net who The net who command is not supported.


Previous Next Contents Index