Advanced Server for OpenVMS
Commands Reference Manual


Previous Contents Index

This example adds the user SCARECROW as a member of the MUNCHKINS group, and sets the user's home path to be \\TINMAN\USERS\SCARECROW, which will be mapped to drive D on the user's workstation.


NET

The NET command accepts a subset of the LAN Manager Net commands and attempts to perform the equivalent ADMINISTER command. This provides some level of backward compatability with PATHWORKS LAN Manager servers.

Format

NET [/qualifier] command-line


Parameters

command-line

Specifies the Net command line that you wish to process.

Qualifiers

/TRANSLATE

The /TRANSLATE qualifier must precede the command-line parameter. Use it to display the equivalent ADMINISTER command without performing the command action. This enables you to determine the equivalent command without actually performing the command.

Examples

#1

 LANDOFOZ\\TINMAN> NET/TRANSLATE ACCOUNT 
 Translated command is: SHOW ACCOUNT POLICY 
      

This example translates the LAN Manager NET ACCOUNT command into the equivalent ADMINISTER command and displays the resulting translation without performing the command action.

#2

 LANDOFOZ\\TINMAN> NET ACCOUNT 
 Account Policy for domain "LANDOFOZ": 
 
 Minimum password age (days) : 1 
 Maximum password age (days) : 90 
 Minimum password length : 0 
 Length of password history maintained : None 
 Force user logoff after logon hours expire : NO 
 Lock out account after how many bad password attempts : Never 
 Role of server TINMAN : Primary Domain Controller 
 

This example translates the LAN Manager NET ACCOUNT command into the equivalent ADMINISTER command (SHOW ACCOUNT POLICY) and performs the command action.


PAUSE PRINT QUEUE

Pauses a currently active Advanced Server for OpenVMS print queue. Use the SHOW PRINT QUEUES command to display the list of available queues. This command performs the same function as the SET PRINT QUEUE queue-name /PAUSE command.

Format

PAUSE PRINT QUEUE queue-name [/qualifiers]

restrictions

This command is valid only to OpenVMS servers. Use of this command requires membership in the Administrators, Server Operators, or Print Operators local group.

Related Commands


Parameters

queue-name

Specifies the name of the print queue for which to pause printing.

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 where the specified print queue resides. The default is the server currently being administered.

Example


LANDOFOZ\\TINMAN> PAUSE PRINT QUEUE LN03/NOCONFIRM 
%PWRK-S-QUESET, queue "LN03" paused on server "TINMAN" 
      

This example pauses the print queue LN03 on the server currently being administered (TINMAN). A confirmation is not required.


PAUSE SERVICE

Pauses a currently active service. Use the SHOW SERVICES command to display a list of available services.

Format

PAUSE 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 service to pause.

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 pause the service. The default is the server currently being administered.

Example


LANDOFOZ\\TINMAN> PAUSE SERVICE NETLOGON 
Do you really want to pause service "NETLOGON" [YES or NO] (YES) : YES 
%PWRK-S-SVCPAUSE, service "NETLOGON" paused on server "TINMAN" 
      

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


REMOVE COMPUTER

Removes a computer from a domain. The computer's account is deleted from the domain's security database, and it can no longer participate in domain security.

Format

REMOVE COMPUTER computer-name [/qualifiers]

restrictions

Do not remove the primary domain controller for a domain. Use of this command requires membership in the Administrators local group.

Related Commands


Parameters

computer-name

Specifies the name of the computer to remove from the domain.

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.

/DOMAIN=domain-name

Specifies the name of the domain from which to remove the computer. The default is the domain currently being administered. Do not specify both /DOMAIN and /SERVER on the same command line.

/SERVER=server-name

Specifies the name of a server that is a member of the domain from which to remove the computer. Do not specify both /DOMAIN and /SERVER on the same command line.

Example


LANDOFOZ\\TINMAN> REMOVE COMPUTER DOROTHY 
Removing computer "DOROTHY" from domain "LANDOFOZ" will render it 
incapable of authenticating domain logons until it is added to another 
domain. 
 
Do you want to continue with the removal [YES or NO] (YES) : YES 
%PWRK-S-COMPREM, computer "DOROTHY" removed from domain "LANDOFOZ" 
      

This example removes the computer named DOROTHY from the default domain's (LANDOFOZ) security database. A confirmation is displayed.


REMOVE GROUP

Permanently removes a local or global group from a domain's security database.

Be sure you want to delete a group before you do so, because a deleted group cannot be recovered. The server knows every group by its security identifier (SID), a unique number that identifies it. If you delete a group and then create another group with the same name, the new group will not have any of the permissions that were previously granted to the old group, because the groups have different SID numbers.


Format

REMOVE GROUP group-name [/qualifiers]

restrictions

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

Related Commands


Parameters

group-name

Specifies the name of an existing group to be removed.

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.

/DOMAIN=domain-name

Specifies the name of the domain from which to remove the group. The default is the domain currently being administered. Do not specify both /DOMAIN and /SERVER on the same command line.

/SERVER=server-name

Specifies the name of a server that is a member of the domain from which to remove the group. Do not specify both /DOMAIN and /SERVER on the same command line.

Example


LANDOFOZ\\TINMAN> REMOVE GROUP MUNCHKINS 
Each group is represented by a unique identifier which is independent 
of the group name.  Once this group is deleted, even creating an 
identically named group in the future will not restore access to 
resources which currently name this group in the access control list. 
 
Remove group "MUNCHKINS" [YES or NO] (YES) : YES 
%PWRK-S-GROUPREM, group "MUNCHKINS" removed from domain "LANDOFOZ" 
      

This example removes the group named MUNCHKINS from the default domain (LANDOFOZ). A confirmation is required.


REMOVE HOSTMAP

Removes a user account mapping between an Advanced Server user account and an OpenVMS user account.

Format

REMOVE HOSTMAP [domain-name\]user-name [/qualifiers]

restrictions

This command is valid only to OpenVMS servers. Use of this command requires membership in the Administrators local group.

Related Commands


Parameters

[domain-name\]user-name

Specifies the Advanced Server or OpenVMS user account name whose mapping is to be removed. To remove the mapping of a network user in a trusted domain, specify the domain-qualified user name in the format domain-name\user-name, such as KANSAS\DOLE, where KANSAS is the trusted domain, and DOLE is the user name of the user account defined in the trusted domain. If you omit the domain name, the user account is assumed to be defined in the domain of the server currently being administered.

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.

/HOSTUSER

Indicates that the specified user name is an OpenVMS user name. All Advanced Server user account mappings to the specified OpenVMS user name will be removed.

Note that more than one Advanced Server user name may be mapped to a single OpenVMS user name. Use the SHOW HOSTMAP command to check. Removing the mappings for an OpenVMS user name may result in the removal of more than one Advanced Server user name mapping.

Do not specify both /HOSTUSER and /NETUSER on the same command line.

/NETUSER

Indicates that the specified user name is an Advanced Server user name. The account mapping for the specified Advanced Server user name will be removed. This is the default if you specify neither /NETUSER or /HOSTUSER. Do not specify both /HOSTUSER and /NETUSER on the same command line.

/SERVER=server-name

Specifies the name of the server on which to remove the host account mapping. The default is the server currently being administered.

Examples

#1

 LANDOFOZ\\TINMAN> REMOVE HOSTMAP WITCH/NETUSER 
 Do you really want to remove host mapping for "WITCH" [YES or NO] (YES) : 
 %PWRK-S-HOSTMAPREM, mapping for user "WITCH" removed 
      

This example removes the user account mapping for the Advanced Server user name WITCH on the server currently being administered (TINMAN). A confirmation is required.

#2

 LANDOFOZ\\TINMAN> REMOVE HOSTMAP STRAWMAN/HOSTUSER/NOCONFIRM 
 %PWRK-S-HOSTMAPSREM, mappings to user "STRAWMAN" removed 
      

This example removes all Advanced Server user account mappings to the OpenVMS user name STRAWMAN on the server currently being administered (TINMAN). A confirmation is not required.


REMOVE PRINT QUEUE

Removes an existing Advanced Server for OpenVMS print queue.

Format

REMOVE PRINT QUEUE queue-name [/qualifiers]

restrictions

This command is valid only to OpenVMS servers. Use of this command requires membership in the Administrators, Server Operators, or Print Operators local group.

Related Commands


Parameters

queue-name

Specifies the name of the print queue to remove.

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 from which to remove the print queue. The default is the server currently being administered.

Example


LANDOFOZ\\TINMAN> REMOVE PRINT QUEUE TOTO 
Do you really want to remove print queue "TOTO" [YES or NO] (YES) : YES 
%PWRK-S-QUEREM, queue "TOTO" removed from server "TINMAN" 
      

This example removes the print queue TOTO from the server currently being administered (TINMAN). A confirmation is required.


REMOVE SHARE

Removes an existing directory or print share from a server's share database. The resource will no longer be available to the network.

Format

REMOVE SHARE share-name [/qualifiers]

restrictions

Membership in the Administrators, Account Operators, or Server Operators local group is required to administer directory shares. Members of the Print Operators local group may administer print shares.

Related Commands


Parameters

share-name

Specifies the name of the share to remove.

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 from which to remove the share. The default is the server currently being administered.

Example


LANDOFOZ\\TINMAN> REMOVE SHARE RAINBOW 
Do you really want to remove share "RAINBOW" [YES or NO] (YES) : YES 
%PWRK-S-SHAREREM, share "RAINBOW" removed from server "TINMAN" 
      

This example removes the share named RAINBOW from the server currently being administered (TINMAN). A confirmation is required.


REMOVE TRUST

Removes the specified domain from the list of domains this domain trusts, or the list of domains that are allowed to trust this domain.

Removing a trust relationship requires two steps on each of the two domains: one domain must stop trusting a second domain, and the second domain must stop permitting the first domain to trust it. Never remove a trust relationship by performing just one of the steps.

When removing a trust relationship, always administer both domains. Once a trust relationship is established, the password used to establish the trust is changed by the system. Because of this, you cannot remove one side of an established trust relationship, and then later reestablish that trust using the original password. You must always remove both sides of a trust relationship, and then completely reestablish it.


Format

REMOVE TRUST trust-domain [/qualifiers]

restrictions

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

Related Commands


Parameters

trust-domain

Specifies the name of the domain for which to remove a trust relationship.

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.

/DOMAIN=domain-name

Specifies the name of the domain from which to remove the trust relationship. The default is the domain currently being administered. Do not specify both /DOMAIN and /SERVER on the same command line.

/PERMITTED

Specifies that the domain should be removed from the list of domains that are permitted to trust this domain. Be sure to administer the specified domain and remove this domain from its list of trusted domains. You must specify either the /PERMITTED or /TRUSTED qualifier, but not both.

/SERVER=server-name

Specifies the name of a server that is a member of the domain from which to remove the trust relationship. Do not specify the /SERVER qualifier with the /DOMAIN qualifier.

/TRUSTED

Specifies that the domain should be removed from the list of domains that this domain trusts. Be sure to administer the specified domain and remove this domain from its list of permitted to trust domains. You must specify either the /PERMITTED or /TRUSTED qualifier, but not both.

Examples

The following two examples together show how to remove a one-way trust relationship between the domain currently being administered (LANDOFOZ) and the domain called KANSAS. After this trust relationship has been removed, users in the KANSAS domain will no longer have access to resources in the LANDOFOZ domain.
#1

 LANDOFOZ\\TINMAN> REMOVE TRUST KANSAS/TRUSTED 
 Removing domain "KANSAS" from the Trusted Domains List will prevent 
 users in domain "KANSAS" from accessing resources in domain 
 "LANDOFOZ". If you choose to continue, you must also administer 
 domain "KANSAS" and remove "LANDOFOZ" from its list of Permitted 
 Domains. 
 
 Do you want to continue with the removal [YES or NO] (YES) : YES 
 %PWRK-S-TRUSTREM, trust between domains "LANDOFOZ" and "KANSAS" 
 removed 
      

This example removes the domain KANSAS from the list of trusted domains on the domain currently being administered (LANDOFOZ). A confirmation is required.

#2

 LANDOFOZ\\TINMAN> REMOVE TRUST LANDOFOZ/DOMAIN=KANSAS/PERMITTED 
 
 Removing domain "LANDOFOZ" from the Permitted Domains List will 
 prevent users in domain "KANSAS" from accessing resources in domain 
 "LANDOFOZ". If you choose to continue, you must also administer 
 domain "LANDOFOZ" and remove "KANSAS" from its list of Trusted 
 Domains. 
 
 Do you want to continue with the removal [YES or NO] (YES) : YES 
 %PWRK-S-TRUSTREM, trust between domains "KANSAS" and "LANDOFOZ" 
 removed 
      

This example removes the domain LANDOFOZ from the list of permitted to trust domains on the domain called KANSAS. This completes the removal of the trust relationship between domains LANDOFOZ and KANSAS initiated in the first example. A confirmation is required.


Previous Next Contents Index