Advanced Server for OpenVMS
Commands Reference Manual


Previous Contents Index


SET PASSWORD

Sets a new password for a user account in a domain.

Format

SET PASSWORD [user-name [old-password [new-password]]] [/qualifier]

restrictions

Use of this command does not require special group membership.

Passwords entered on the SET PASSWORD command line are accepted as caseless. See restrictions regarding the old-password and new-password parameters.


Parameters

user-name

Specifies the user account name of the user whose password is to be changed. If you do not enter a user name on the command line, you will be prompted to enter one.

old-password

Specifies the current password for the user account. If you do not enter a password, or you enter it as an asterisk (*), a prompt is issued, and the password is not displayed as it is entered. Passwords entered on the command line are uppercased unless they are enclosed within quotation marks. If the password contains lowercase letters, enclose it in quotation marks unless you enter it in response to the password prompt.

new-password

Specifies the new password for the user account, which may be up to 14 characters in length. If you omit the new password, or you specify it as an asterisk (*), you are prompted for the new password and a confirmation, which will not be displayed as they are entered. New passwords are accepted as caseless. For a new password that includes lowercase letters, use the MODIFY USER command with the /PASSWORD qualifier (requires administrative privileges).

Qualifiers

/DOMAIN=domain-name

Specifies the domain in which to change the password. The default is the domain of the local server.

Examples

#1

 LANDOFOZ\\TINMAN> SET PASSWORD LION GOLD SILVER 
 %PWRK-S-PSWCHANGED, password changed for user "LION" in domain "LANDOFOZ" 
      

The example changes the password for the user LION from GOLD to SILVER. The password is changed on the domain of the local server, which in this example is LANDOFOZ.

#2

 LANDOFOZ\\TINMAN> SET PASSWORD WIZARD/DOMAIN=KANSAS 
 Old password: 
 New password: 
 New password verification: 
 %PWRK-S-PSWCHANGED, password changed for user "WIZARD" in domain 
 "KANSAS" 
      

This example changes the password for user WIZARD on the domain KANSAS. Since the old and new passwords were not specified on the command line, prompts were issued for the old password, the new password, and a verification of the new password.


SET PRINT JOB

Modifies the attributes of an existing Advanced Server print job. Use the SHOW PRINT JOBS command to display the list of available print jobs.

Format

SET PRINT JOB job-id [/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

job-id

Specifies the job identification number of the print job to be affected. To determine the job-id for a particular print job, use the SHOW PRINT JOBS command.

Qualifiers

/DELETE

Deletes the specified print job from its print queue. Do not specify this qualifier with the /FIRST, /HOLD, /LAST or /RELEASE qualifiers.

/FIRST

Moves the specified print job to the first position in its print queue. The print job starts after the current print job has completed. Do not specify this qualifier with the /DELETE, /HOLD, /LAST or /RELEASE qualifiers.

/HOLD

Holds the specified print job in its print queue for printing at a later time. The print job stays in its print queue, and other print jobs can print. To allow the held print job to print, use the SET PRINT JOB/RELEASE command. Do not specify this qualifier with the /DELETE, /FIRST, /LAST, or /RELEASE qualifiers.

/LAST

Moves the specified print job to the last position in its print queue. The print job is printed after all other print jobs in the queue are completed. Do not specify this qualifier with the /DELETE, /FIRST, /HOLD, or /RELEASE qualifiers.

/RELEASE

Releases a print job that has been held; the job can then print. Do not specify this qualifier with the /DELETE, /FIRST, /HOLD, or /LAST qualifiers.

/SERVER=server-name

Specifies the name of the server on which to set the print job. The default is the server currently being administered.

Examples

#1

 LANDOFOZ\\TINMAN> SET PRINT JOB 351/HOLD 
 %PWRK-S-JOBSET, print job 351 held on server "TINMAN" 
      

This example holds print job 351. The print job will not be printed until it is released.

#2

 LANDOFOZ\\TINMAN> SET PRINT JOB 351/RELEASE 
 %PWRK-S-JOBSET, print job 351 released on server "TINMAN" 
      

This example releases print job 351, and makes it available to be printed.

#3

 LANDOFOZ\\TINMAN> SET PRINT JOB 351/DELETE 
 %PWRK-S-JOBSET, print job 351 deleted on server "TINMAN" 
      

This example deletes print job 351.


SET PRINT QUEUE

Modifies the attributes of an existing Advanced Server print queue. Use the SHOW PRINT QUEUES command to display the list of available print queues.

Format

SET PRINT QUEUE queue-id [/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 be affected.

Qualifiers

/ABORT

Stops printing the currently printing job in the specified print queue. Do not specify this qualifier with the /CONTINUE, /PAUSE, /PURGE, or /RESTART qualifiers.

/CONTINUE

Continues printing from the specified print queue which has been paused. Do not specify this qualifier with the /ABORT, /PAUSE, /PURGE, or /RESTART qualifiers.

/DESCRIPTION=string

/NODESCRIPTION

Specifies a string of up to 48 characters used to provide descriptive information about the queue. Enclose the string in quotation marks to preserve case (the default is uppercase). /NODESCRIPTION indicates that the description is to be blank. If the /DESCRIPTION qualifier is not specified, the current description remains unchanged.

/PAUSE

Pauses printing from the specified print queue after the current job finishes printing. Do not specify this qualifier with the /ABORT, /CONTINUE, /PURGE, or /RESTART qualifiers.

/PURGE

Removes all print jobs from the specified print queue except for any job that is currently printing. Do not specify this qualifier with the /ABORT, /CONTINUE, /PAUSE, or RESTART qualifiers.

/PRINTER=device-name

Changes the physical device name or port to which the printer associated with the specified printer queue is connected. This is the actual OpenVMS system device to which the printer is connected (for example, OPA0, TTA2, TXA7, or LTA201). You can use the /PRINTER qualifier only if the specified print queue is a printer queue.

/RESTART

Restarts printing of the current print job from the specified print queue. The job restarts printing from the beginning. Do not specify this qualifier with the /ABORT, /CONTINUE, /PAUSE, or /PURGE qualifiers.

/ROUTE_TO=(printer-queue[,...])

Indicates that jobs for the specified routing queue should now be routed to the specified printer queues. The printer-queue specifies one or more printer queues to which to route the print jobs. You can use the /ROUTE_TO qualifier only if the specified print queue is a routing queue.

/SERVER=server-name

Specifies the name of the server where the specified print queue resides. The default is the server currently being administered.

/TYPE=printer-type

Changes the printer type of the printer associated with the specified printer queue. The printer-type keyword can be one of the following:
Printer-Type Type of Printer
DL1100 DEClaser 1100
DL2100 DEClaser 2100
DL2100P DEClaser 2100 Plus
DL2200 DEClaser 2200
DL2200P DEClaser 2200 Plus
DL3200 DEClaser 3200
LN03 DIGITAL LN03
LN03P DIGITAL LN03 Plus
LA50 DIGITAL LA50
LA70 DIGITAL LA70
LA75 DIGITAL LA75
LA210 DIGITAL LA210
LA324 DIGITAL LA324
LG01 DIGITAL LG01
LG02 DIGITAL LG02
LG06 DIGITAL LG06
LG31 DIGITAL LG31
LJ250 DIGITAL LJ250
FX850 EPSON FX850
FX1050 EPSON FX1050
HP_LASERJET Hewlett-Packard LaserJet IID
PROPRINTER IBM Proprinter
SILENTWRITER NEC Silentwriter 2, model 290 (not PostScript)
GENERIC All other printer types (the default).

You can use the /TYPE qualifier only if the specified print queue is a printer queue.


Examples

#1

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

This example pauses the print queue TOTO. Any print job that is currently printing is allowed to finish. No further print jobs in the queue will be printed until the queue is continued.

#2

 LANDOFOZ\\TINMAN> SET PRINT QUEUE TOTO/CONTINUE 
 %PWRK-S-QUESET, queue "TOTO" continued on server "TINMAN" 
      

This example continues the paused print queue TOTO. Any jobs in the print queue are allowed to print.

#3

 LANDOFOZ\\TINMAN> SET PRINT QUEUE TOTO/PURGE 
 %PWRK-S-QUESET, queue "TOTO" purged on server "TINMAN" 
      

This example removes all print jobs from the print queue TOTO. Any print job that is currently printing is allowed to finish.


SHOW ACCOUNT POLICY

Displays account policy information for the domain. The policy information includes:

Format

SHOW ACCOUNT POLICY [/qualifier]

restrictions

Use of this command does not require special group membership.

Related Commands


Qualifiers

/DOMAIN=domain-name

Specifies the name of the domain for which to show the account policy. 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 for which to show the account policy. Do not specify both /DOMAIN and /SERVER on the same command line.

Example


LANDOFOZ\\TINMAN> SHOW ACCOUNT POLICY 
 
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 displays the account policy information for the domain currently being administered (LANDOFOZ).


SHOW ADMINISTRATION

Displays information about the domain and server currently being administered, and information about the current user. The administration information includes:

Format

SHOW ADMINISTRATION

restrictions

Use of this command does not require special group membership.

Related Commands


Example


LANDOFOZ\\TINMAN> SHOW ADMINISTRATION 
 
Administration information: 
 
The domain being administered is: LANDOFOZ 
The domain controller for the domain is: TINMAN 
The domain controller type is: Advanced Server 3.51 for OpenVMS 
 
The server being administered is: TINMAN 
The server type is: Advanced Server 3.51 for OpenVMS 
 
The user name is: SCARECROW 
The user is logged on to domain LANDOFOZ and has been authenticated. 
The user's privilege level on this domain is: ADMIN 
The user's workstation is TINMAN and is in domain LANDOFOZ. 
      

This example displays information about the domain and server being administered, and information about the current user.


SHOW AUDIT POLICY

Displays whether auditing is enabled for the domain, and what events are being audited.

Format

SHOW AUDIT POLICY [/qualifiers]

restrictions

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

Related Commands


Qualifiers

/DOMAIN=domain-name

Specifies the name of the domain for which to show the audit policy. 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 for which to show the audit policy. Do not specify both /DOMAIN and /SERVER on the same command line.

Example


LANDOFOZ\\TINMAN> SHOW AUDIT POLICY 
 
Audit Policy for domain "LANDOFOZ": 
 
Auditing is currently Enabled. 
 
Audit Event states: 
 
Audit Event         Success   Failure 
------------------  --------  -------- 
ACCESS              Disabled  Disabled 
ACCOUNT_MANAGEMENT  Disabled  Disabled 
LOGONOFF            Disabled  Disabled 
POLICY_CHANGE       Enabled   Enabled 
PROCESS             Disabled  Disabled 
SYSTEM              Disabled  Disabled 
USER_RIGHTS         Enabled   Enabled 
      

This example displays the audit policy information for the domain currently being administered (LANDOFOZ).


SHOW COMPUTERS

Displays a list of computers that are members of the domain and participate in domain security, and computers that are listed by the Computer Browser service as active in the domain. The basic display includes, in tabular form:

A usage summary for each computer can optionally be included in the display. If a computer does not support remote administration, is unavailable to the network (for example, it is turned off), or the /TYPE=DOMAIN_MEMBERS qualifier is specified, the display symbol appears in lowercase letters, the description and usage summary are blank, and the network operating system type may be incomplete or inaccurate.


Format

SHOW COMPUTERS [computer-name] [/qualifiers]

restrictions

Use of this command in its default form does not require special group membership; however, the use of certain qualifiers may require special group membership. See the specific qualifier for any group membership requirements.

Related Commands


Parameters

computer-name

Indicates that only information for the specified computer should be displayed. If you omit the computer-name, then the display contains information about all computers in the domain which match any filtering criteria. Do not specify the computer-name parameter on the same command line as the /DOMAIN or /TYPE qualifiers.

Qualifiers

/DOMAIN=domain-name

Specifies the name of the domain for which to show computer information. The default is the domain currently being administered. Do not specify both the /DOMAIN qualifier and the computer-name parameter on the same command line.

/FULL

/NOFULL

Controls whether a usage summary is included for each computer in the display. The default, /NOFULL, omits the usage summary. The usage summary contains the number of:

Obtaining the usage summary requires a connection to be made to the computer, which may take several seconds to complete. Use of this qualifier requires membership in the Administrators local group.

/TYPE=computer-type

Specifies the types of computers to include in the display. Precede computer-type with NO to exclude the specified computer type from the display. The value of computer-type can be one or more of the following:
Computer-Type Description
ALL All types of computers (default).
[NO]BACKUP_DOMAIN_CONTROLLERS
  Computers that are currently acting as backup domain controllers.
[NO]DOMAIN_MEMBERS
  Only computers that are members of the domain, not computers listed by the Computer Browser service as active in the domain.
[NO]MACINTOSH Computers running the Apple File Protocol service.
[NO]PATHWORKS OpenVMS servers.
[NO]PRIMARY_DOMAIN_CONTROLLER
  The primary domain controller for the domain.
[NO]SERVERS Computers acting as servers on the network.
[NO]WORKSTATIONS Computers acting as workstations on the network.

Do not specify both the /TYPE qualifier and the computer-name parameter on the same command line.


Example


LANDOFOZ\\TINMAN> SHOW COMPUTERS/FULL 
 
Computers in domain "LANDOFOZ": 
 
Computer          Type                      Description 
----------------  ------------------------  -------------------------- 
[PD] TINMAN       OpenVMS 3.51 Primary      Advanced Server V7.2 for 
                                            OpenVMS 
    Sessions: 5   Open Files: 0   File Locks: 0   Open Named Pipes: 1 
[BD] DOROTHY      OpenVMS 3.51 Backup       Advanced Server V7.2 for 
                                            OpenVMS 
    Sessions: 2   Open Files: 2   File Locks: 0   Open Named Pipes: 0 
 
Total of 2 computers 
 
 
 
 
      

This example displays a list of all computers in the domain LANDOFOZ, and includes a usage summary for each computer.


Previous Next Contents Index