Compaq Advanced Server for OpenVMS
Commands Reference Manual


Previous Contents Index


SET MODE

Determines the output display format and the input mode for ADMINISTER commands. The SET MODE command settings can affect how Unicode or extended character set characters (code points) with values of hexadecimal 0080 or higher are handled on input and output.

Settings made with this command are preserved until you log out from the system. These settings will determine the default modes that take effect each time you invoke the ADMINISTER command interface. The current setting for the ADMINISTER command input mode overrides the current OpenVMS DCL parse style setting.

If you have not yet used the SET MODE command to change input or output mode settings during your present system user login session, the defaults are determined by the current OpenVMS DCL parse style. If the parse style is TRADITIONAL (the OpenVMS default), the input and output modes are RAW; if the parse style is EXTENDED, the input and output modes are VTF7.

You can set permanent defaults by inserting the appropriate SET MODE command in your LOGIN.COM file. The server does not have to be running for this command to execute.


Format

SET MODE [/qualifiers]

restrictions

None

Related Commands

SHOW MODE

Qualifiers

/RAW

For terminals that support the ISO-8859-n character sets, the actual extended character set characters in the Advanced Server's character set are used for input and output. If this qualifier is set for a terminal that does not support ISO-8859-n character sets, and filtering is not enabled, output will be unpredictable. Enable filtering with the /OUTPUT qualifier.

/VTF7

Code point values that map to Unicode hexadecimal values 0080 to 00FF (128 to 255 decimal) are input in either the ^xx or ^Uxxxx format, and displayed in the ^xx format, while code point values 0100 to FFFF (256 to 65,535 decimal) are input and displayed in the ^Uxxxx format.

The extended character set characters for Unicode values 0080 to 00FF (128 to 255 decimal) can be input in either of two different formats: ^xx and ^uxxxx. Unicode values above 00FF (255 decimal) must be entered in the ^uxxxx format.

/INPUT=(mode)

Sets only the input mode. The mode keyword can be one of the following:
Mode Description
RAW The input characters are handled as the actual characters in the Advanced Server's character set.
VTF7 The input characters are handled as VTF-7 characters.

Note that if the input and output modes differ, your command input might appear in one format while being displayed in another.

/OUTPUT=mode[/[NO]FILTER]

Specifies the output mode only. The mode keyword can be one of the following:
Mode Description
RAW The output characters are displayed as the actual characters in the Advanced Server's character set.
VTF7 The output characters are displayed as VTF-7 characters.

Optionally, specify the /FILTER qualifier to convert characters before they are output. If filtering is enabled (the default), the C1 character codes (127 through 160 decimal) are converted to spaces before being output. Specify /NOFILTER to disable filtering; output on some terminals might be unpredictable.

You can specify one mode only. You can specify one mode and the /[NO]FILTER qualifier, or just the /[NO]FILTER.

Note that if the input and output modes differ, your command input might appear in one format while being displayed in another.


Examples

#1

 LAPLAYA\\VALENCIA> SET MODE/VTF7 
 
LAPLAYA\\VALENCIA> SHOW SHARE ^BFESPA^F1OL /FULL 
 
Shared resources on server "VALENCIA": 
 
Name          Type       Description 
------------  ---------  ------------------------------------------------------- 
^BFESPA^D1OL  Directory 
    Path: USER1:[^BFESPA^F1OL] 
    Connections:  Current: 0, Maximum: No limit 
    RMS file format: Stream 
    Directory Permissions: System: RW, Owner: RW, Group: RW, World: R 
    File Permissions: System: RW, Owner: RW, Group: RW, World: R 
    Share Permissions: 
        Everyone                        Full Control 
 
  Total of 1 share 
      

In this example, the output and input modes are set to VTF7. The subsequent SHOW command reveals how certain code point values in the Spanish language's character set are then displayed.

#2

 LAPLAYA\\VALENCIA> SET MODE/OUTPUT=RAW 
 
LAPLAYA\\VALENCIA> SHOW SHARE ^BFESPA^F1OL /FULL 
 
Shared resources on server "VALENCIA": 
 
Name          Type       Description 
------------  ---------  ---------------------------------------------------- 
¿ESPAÑOL      Directory 
    Path: USER1:[¿ESPAÑOL] 
    Connections:  Current: 0, Maximum: No limit 
    RMS file format: Stream 
    Directory Permissions: System: RW, Owner: RW, Group: RW, World: RW 
    File Permissions: System: RW, Owner: RW, Group: RW, World: R 
    Share Permissions: 
        Everyone                        Full Control 
 
  Total of 1 share 
 
 
      

In this example, the output mode is set to RAW mode. The terminal supports the ISO-8859-1 character set (used when the Spanish language is configured), so the actual Spanish characters in the character set are displayed. The input mode is VTF7 by default --- note how the Spanish characters are handled on input differ from the way they are displayed.

#3

 $! User LOGIN.COM file 
   .
   .
   .
$ ADMINISTER SET MODE/VTF7/OUTPUT=NOFILTER 
      

This command, entered in your LOGIN.COM file, sets permanent defaults for each time you log in to your OpenVMS system. This command sets input and output modes to VTF7, with output unfiltered. The server does not have to be running for this command to execute.


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. The password is displayed as you enter it. If you do not enter a password, or you enter it as an asterisk (*), a prompt is issued. The password is not displayed when you enter it at the prompt.

Passwords entered on the command line are converted to uppercase unless they are enclosed within quotation marks. If the password contains lowercase letters, blanks (spaces), or other nonalphanumeric characters, 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. The password is not displayed when you enter it at the prompt.

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. Because 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 OpenVMS 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

SET PRINT QUEUE
SHOW PRINT JOBS
SHOW PRINT QUEUES

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-name [/qualifiers]

restrictions

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

If Windows NT printer management is enabled on the server, do not use this command. Use Windows NT print services.

Related Commands

ADD PRINT QUEUE
CONTINUE PRINT QUEUE
PAUSE PRINT QUEUE
REMOVE PRINT QUEUE
SET PRINT JOB
SHOW PRINT JOBS
SHOW PRINT QUEUES

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 that 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 if it contains lowercase letters, blanks (spaces) or other nonalphanumeric characters. /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 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=(print-queue[,...])

Indicates that jobs for the specified routing queue should now be routed to the specified printer queues. The print-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 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

SET ACCOUNT POLICY

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

SET ADMINISTRATION

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 for OpenVMS 
 
The server being administered is: TINMAN 
The server type is: Advanced Server 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

SET AUDIT POLICY
SHOW EVENTS

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, it 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

ADD COMPUTER
REMOVE COMPUTER
SET COMPUTER

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 that 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 have accounts in the domain's security database; the default is NODOMAIN_MEMBERS, which displays all computers --- both computers in the domain's security database and those listed as active in the domain by the Computer Browser service
[NO]MACINTOSH Computers running the Apple File Protocol service
[NO]PATHWORKS Compaq 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 (NT 4.0) Primary  Advanced Server V7.3 for 
                                            OpenVMS 
    Sessions: 5   Open Files: 0   File Locks: 0   Open Named Pipes: 1 
[BD] DOROTHY      OpenVMS (NT 4.0) Backup   Advanced Server V7.3 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