![[OpenVMS documentation]](../../images/openvms_doc_banner_top.gif)
|
![[Site home]](../../images/buttons/bn_site_home_off.gif)
![[Send comments]](../../images/buttons/bn_comments_off.gif)
![[Help with this site]](../../images/buttons/bn_site_help_off.gif)
![[How to order documentation]](../../images/buttons/bn_order_docs_off.gif)
![[OpenVMS site]](../../images/buttons/bn_openvms_off.gif)
![[Compaq site]](../../images/buttons/bn_compaq_off.gif)
|
| Updated: 11 December 1998 |
|
|
|
|
| Updated: 11 December 1998 |
OpenVMS DCL Dictionary
| Previous | Contents | Index |
The terminal types and characteristics that can be set are listed in Figure DCLII-2.
Controls whether the terminal modem is hung up when you log out.
The SET TERMINAL/INQUIRE command works correctly on DIGITAL supplied VT100 and later terminals. Some personal computer terminal emulators may not work correctly, since they do not correctly emulate all VT100 escape sequences. Compaq recommends that users who experience problems with these terminal emulators contact the terminal emulator supplier. |
You can include the SET TERMINAL/INQUIRE command in your LOGIN.COM file to detect the terminal type automatically.
If you specify /INQUIRE=OLD, OpenVMS sets the terminal window to 24 lines by 80 columns and ignores the real terminal size. (This is the behavior of the SET TERMINAL/INQUIRE command prior to OpenVMS Version 6.2.)
This qualifier clears the type-ahead buffer. If the response sequence is unrecognized, no action message or error message is displayed. The /INQUIRE qualifier should be used only on DIGITAL terminals. However, the LA36 and VT05 terminals do not support this feature. |
When logging in to terminals with the LOCAL_ECHO characteristic, the OpenVMS system has no control over the echoing of passwords. |
Make sure that you spell both these qualifiers exactly as they appear in the text.
Sets characteristics on a permanent basis, that is, over terminal sessions. However, the characteristics revert to their initial values if the system is halted and restarted. Use in a system startup file to establish characteristics for all terminals on the system.
SET TERMINAL/READSYNC should not be used on LAT terminal lines. Setting this characteristic may cause unexpected results. |
The default is the /NOREADSYNC qualifier; the system does not use the Ctrl/S and Ctrl/Q functions to control reads to the terminal. The /READSYNC qualifier is useful for certain classes of terminals that demand synchronization or for special-purpose terminal lines where data synchronization is appropriate.
Controls whether the Break key on the terminal logs out the current process (except on a virtual terminal). With the /SECURE_SERVER qualifier in effect, pressing the Break key when there is no current process initiates the login sequence. With the /NOSECURE_SERVER qualifier in effect, the break is ignored.
On terminals with the AUTOBAUD and SECURE_SERVER characteristics, pressing the Break key disconnects the current process, but is not required to start a new login sequence. However, when the NOAUTOBAUD characteristic is set, the SECURE_SERVER characteristic requires a break to initiate a new login sequence.
Controls whether the /SPEED qualifier can be used to change the terminal speed.
Not all terminals support different input and output baud rates. For specific information on baud rates for your terminal, consult the manual for that terminal.
The default transmission rates are installation dependent.
The valid values for input and output baud rates are as follows:
50 150 1800 4800 38400 75 300 2000 7200 57600 110 600 2400 9600 76800 134 1200 3600 19200 115200 |
Determines whether the terminal requires that a system password be entered before the Username: prompt.
When you specify the /NOTYPE_AHEAD qualifier, the terminal accepts input only when a program or the system issues a read to the terminal, such as for user input at the DCL prompt ($). When you specify the /TYPE_AHEAD qualifier, the amount of data that can be accepted is governed by the size of the type-ahead buffer. That size is determined by system generation parameters.
If the specified width on an ANSI terminal is 132, the screen is set to 132-character mode. If the terminal does not have advanced video option (AVO), the page length limit is set to 14 lines.
| #1 |
|---|
$ SET TERMINAL/DEVICE=VT102
|
In this example, the SET TERMINAL command establishes the current terminal as a VT102 terminal and sets the default characteristics for that terminal type.
| #2 |
|---|
$ SET TERMINAL/WIDTH=132/PAGE=60/NOBROADCAST
$ TYPE MEMO.DOC
.
.
.
$ SET TERMINAL/DEVICE=LA36
|
In this example, the first SET TERMINAL command indicates that the width of terminal lines is 132 characters and that the size of each page is 60 lines. The /NOBROADCAST qualifier disables the reception of broadcast messages while the terminal is printing the file MEMO.DOC. The next SET TERMINAL command restores the terminal to its default state.
Resets the system clock, which is used as a timer to record intervals between various internal events and as a source clock for displaying the time of day.Requires both OPER (operator) and LOG_IO (logical I/O) privileges.
SET TIME [=time]
time
Specifies a date in the format day-month-year, or a time in the format hour:minute:second.hundredth, or both. These fields accept the following values:
Field Type Values Day Integer 1 to 31 Month String JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, or DEC Year Integer 1858 to 9999 - VAX only Year Integer 1957 to 2056 - Alpha only Hour Integer 0 to 23 Minute Integer 0 to 59 Second Integer 0 to 59 Hundredth Integer 0 to 99 The hyphens (-), colons (:), and period (.) are required delimiters. Separate the date and time, when both are specified, with a colon. The syntax is sometimes specified as follows:
[dd-mmm-yyyy[:]] [hh:mm:ss.cc]
Alpha systems also allow a 2-digit year format:
[dd-mmm-yy[:]] [hh:mm:ss.cc]
The century applied to the 2-digit year format is determined by the corresponding year in the supported Alpha date range (1957-2056).
If the explicit time value is not specified, the interval system clock is automatically reset according to the time-of-year clock.
Note that the time-of-year clock is optional for some VAX processors. For further information about the time-of-year clock, refer to the hardware documentation for your computer.
Alpha systems maintain system time during power failures and system down time. When a system is booted, if the time is known to be earlier than the time value of the last time modification, or greater than five years in the future, you are prompted to enter the time at the console prompt. |
Resets the system clock, which is used as a timer to record intervals between various internal events and as a source clock for displaying the time of day.
Note
The SET TIME command will not work if there is a time service available on your system or OpenVMS Cluster.
/CLUSTER
Requires OPER and LOG_IO privilege, and in an OpenVMS Cluster environment, SYSLCK privilege.Sets the time on all nodes in a cluster to the same system time. The format of the SET TIME /CLUSTER command is the following:
SET TIME[=time] [/CLUSTER]
| #1 |
|---|
$ SET TIME=14-DEC-1998:19:31:0.0
|
The SET TIME command in this example sets the date and time to December 14, 1998, 7:31 P.M.
| #2 |
|---|
$ SET TIME
$ SHOW TIME
14-DEC-1998 03:21:27.53
|
The SET TIME command in this example sets the system time according to the time-of-year clock. The SHOW TIME command requests a display of the current time.
| #3 |
|---|
$ SET TIME=14-DEC-1998:15:31:0.0/CLUSTER
|
This example sets the date and time to December 14, 1998, 3:31 P.M. on all nodes in the cluster where the command was entered.
Controls whether command lines and data lines in command procedures are displayed at the terminal or are printed in a batch job log. The information displayed by the SET VERIFY command can help you in debugging command procedures.
SET VERIFY [=([NO]PROCEDURE, [NO]IMAGE)]
SET NOVERIFY
([NO]PROCEDURE, [NO]IMAGE)
Specifies one or both types of verification. Procedure verification causes each DCL command line in a command procedure to be written to the output device. Image verification causes data lines (input data that is included as part of the SYS$INPUT input stream) to be written to the output device.By default, both types of verification are set or cleared with SET VERIFY and SET NOVERIFY. If you specify only one keyword, the other is not affected. If you specify only one keyword, omit the parentheses.
By default, the SET VERIFY and SET NOVERIFY commands set or clear both types of verification. The default setting for command procedures executed interactively is SET NOVERIFY. System responses and error messages are, however, always displayed. The default for batch jobs is SET VERIFY.If you use the SET VERIFY command to override the default setting, the system displays each command and data line in the command procedure as it reads it. When verification is in effect, the command interpreter displays each command line after it has completed initial scanning and before the command is parsed and executed. You see the results of symbol substitution performed during scanning, but not the results of symbol substitution performed during parsing and evaluation.
When you change the verification setting, the new setting remains in effect for all command procedures that you subsequently execute.
A file must have read (R) access to allow the SET VERIFY command to set verification.
| #1 |
|---|
$ SET VERIFY = PROCEDURE
|
In this example, procedure verification is turned on. If image verification was on, it remains on; if image verification was off, it remains off.
| #2 |
|---|
$ SET VERIFY
$ INDEX == "$INDEX.EXE
$ CONTENTS == "$CONTENTS.EXE
$ TABLE == "$TABLE.EXE
$ SET NOVERIFY
$ EXIT
|
Procedure and image verification are turned on at the beginning of the command procedure so that the system displays all the command and data lines in the procedure as it reads them. At the end of the procedure, the SET NOVERIFY command restores the system default (no procedure or image verification).
| #3 |
|---|
$ PROC_VER = F$ENVIRONMENT("VERIFY_PROCEDURE")
$ IMAGE_VER = F$ENVIRONMENT("VERIFY_IMAGE")
$ HOLD_PREFIX = F$ENVIRONMENT("VERIFY_PREFIX")
$ SET PREFIX "(!%T)"
$ SET VERIFY
.
.
.
$ TEMP = F$VERIFY(PROC_VER, IMAGE_VER)
$ SET PREFIX "''HOLD_PREFIX'"
|
This command procedure uses the F$ENVIRONMENT lexical function to save the current procedure and image verification setting, as well as the current verification prefix string. The SET PREFIX command sets the verification prefix to be used in the current command procedure. It uses an FAO control string to produce the time each command is read by the command interpreter (DCL), surrounded by parentheses. Then the SET VERIFY command turns on both procedure and image verification. Subsequently, the F$VERIFY lexical function is used to restore the original verification settings. The SET PREFIX command returns the verification prefix to its previous setting. Note how the symbol HOLD_PREFIX is used in the SET PREFIX command. This preserves casing and special characters in the stored string.
| #4 |
|---|
$ SET VERIFY
$ @TEST
$ RUN AVERAGE
1
2
3
$ EXIT
|
In this example, the SET VERIFY command turns procedure and image verification on. When the command procedure TEST.COM is executed interactively, the command lines and the data lines for the program AVERAGE are displayed on the terminal. The data lines were entered in the command procedure on lines that did not begin with the DCL prompt.
| #5 |
|---|
$ SET VERIFY
$ COUNT = 1
$ IF P'COUNT' .NES. "" THEN GOTO &P'COUNT'
.
.
.
$ EXIT
|
When this command procedure is executed interactively, the SET VERIFY command causes the command and data lines to be displayed. Symbols that are substituted during the first phase of symbol substitution (such as 'COUNT') are displayed by the SET VERIFY command, but other symbols are not. The following lines are displayed when this procedure is executed interactively:
$ COUNT = 1 $ IF P1 .NES. "" THEN GOTO &P1 . . .Although these values are not displayed, the value for P1 is substituted during the third phase of symbol substitution, and the value for &P1 is substituted during the second phase.
| Previous | Next | Contents | Index |
|
|
![[OpenVMS documentation]](../../images/openvms_doc_banner_bottom.gif) |
|
Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal |
9996PRO_060.HTML
|