HP OpenVMS Systems Documentation
HP OpenVMS DCL Dictionary
Enables error checking by the command interpreter after the execution of each command in a command procedure. Specify SET NOON to disable error checking.
During the execution of command procedures, the command interpreter normally checks the status code returned when a DCL command or program image completes and saves the numeric value of this code in the reserved symbol named $STATUS. The low-order 3 bits of this value are also saved in the reserved symbol $SEVERITY. Command procedure execution aborts when either an error or fatal error is detected.
Sets the rate at which output is written to a batch job log file.
SET OUTPUT_RATE [=delta-time]
When you submit a batch job, the output to be written to the log file is stored in an output buffer. Periodically, the buffer is flushed and its contents are written to the batch job log file. By default, the buffer is flushed once a minute; therefore, you can type the log file to determine how much of the job has completed while the job is still executing.
Changes a password or system password. Also, can establish a secondary password or system password, or remove a secondary password.
All user accounts on a system have passwords. A password is required for logging in to the system.
Access to a MSCP/TMSCP class device may be available to an OpenVMS node from more than one host or storage controller. Use the SET PREFERRED_PATH command to specify a particular host or preferred path to access a specific MSCP class disk or TMSCP class tape device.
SET PREFERRED_PATH device-name:
$ SET PREFERRED_PATH $10$DUA10: /HOST=HSC014
Prior to issuing this command, the $10$DUA10: disk device has host HSC015 as its primary path and host HSC014 as its secondary path. Issuing this command selects host HSC014 as the preferred path.
Note that the preferred path has been recorded by the class driver; however, the disk will remain on the current path (HSC015) until the next time the path selection process is initiated.
$ SET PREFERRED_PATH $10$DUA10: /HOST=HSC014 /FORCE
To make the path change occur immediately, include the /FORCE qualifier on the command line with the preferred path specification.
$ SET PREFERRED_PATH $10$DUA10: /FORCE
Issue this command to initiate path selection processing if the specified device has a primary path that differs from the preferred path.
If the preferred path is available, the device moves to that path.
$ SET PREFERRED_PATH $10$DUA10: /NOHOST
Remove the specified preferred path by using the /NOHOST qualifier if the device should no longer have a preferred path.
Allows you to set a prefix control string for verified command lines.
SET [NO]PREFIX string
stringSpecifies the FAO control string to be used in generating a prefix to a verified command line. The following rules apply:
- No more than 64 characters are allowed in the control string.
- The resulting string can be no longer than 64 characters.
- Basic formatting FAO directives can be used ("!/", "!_", "!^", "!!", "!%F", and "!n*c").
- Time and date FAO directives can be used ("!%T" and "!%D").
- Repeat counts can be used ("!n(DD)").
- Output field length specifications can be used ("!lengthDD").
- Combination of repeat count and output field length can be used ("!n(lengthDD)").
- FAO directives that require arguments will always receive a value of zero.
The SET PREFIX command allows you to prefix verified command lines with a custom string. This string is a limited FAO control string that specifies date and time information as well as constant information and formatting controls (that is, tabs, form feeds, and so on). For example, this allows you to use a full date and time prefix (a time stamp) to identify batch runs and to verify that a batch job ran at the expected time.
See the documentation on the F$FAO lexical function for more information about FAO control strings.
The first line of a verified command is prefixed with the result of the control string. The control string is evaluated before the command itself is executed. Any continuation lines are prefixed with a blank string in order to make them flush with the first line of the command. Command input and output are not prefixed. The prefix control string can later be retrieved by using VERIFY_PREFIX with F$ENVIRONMENT.
$ SET VERIFY $ @TEST $ SET DEFAULT SYS$LOGIN $ SHOW DEFAULT USER$:[JENSEN] $ SET PREFIX "(!5%T) " $ @TEST (17:52) $ SET DEFAULT SYS$LOGIN (17:52) $ SHOW DEFAULT USER$:[JENSEN]
This example demonstrates the difference between having and not having a prefix for verification. The first command turns on verification. (Verification must be turned on to see the prefix.) The second command invokes a test procedure to show what the output looks like without a prefix. The third and fourth lines reflect the contents of the test procedure invoked in the preceding command. The third command sets the prefix to an FAO control string so that the first five characters of the standard time will be shown for each command. The last command invokes the test procedure again to demonstrate what the output looks like with a prefix.
Establishes the characteristics of a specific line printer. The default values listed for qualifiers to the SET PRINTER command are the defaults for an initially bootstrapped system.
Requires OPER (operator) privilege. If the printer is a spooled device, LOG_IO (logical I/O) privilege is required to modify its characteristics.
SET PRINTER printer-name[:]
printer-name[:]Specifies the name of a line printer to set or modify its characteristics.
/NOCR (default)Controls whether the printer driver outputs a carriage return character. Use this qualifier for printers on which line feeds do not imply carriage returns.
Specify the /NOCR qualifier for printers where the line feed, form feed, vertical feed, and carriage return characters empty the printer buffer. The /NOCR qualifier causes carriage return characters to be held back and output only if the next character is not a form feed or vertical tab. Carriage return characters are always output on devices that have the carriage return function characteristic set.
/NOFALLBACK (default)Determines whether the printer attempts to translate characters belonging to the DEC Multinational character set into 7-bit equivalent representations. If a character cannot be translated, an underscore (_) character is substituted.
If the /PASSALL qualifier is in effect, it has precedence over the /FALLBACK qualifier.
/NOFFIndicates whether the printer performs a mechanical form feed. Use the /NOFF qualifier when the printer does not automatically perform mechanical form feeds. This qualifier allows the driver to convert form feeds into multiple line feeds and to output them.
/LA11Specifies the printer as an LA11. This qualifier provides information for the SHOW PRINTER command, which, in turn, provides the user with information about specific printers. If no printer type is specified, LP11 is assumed.
/LA180Specifies the printer as an LA180. This qualifier provides information for the SHOW PRINTER command, which, in turn, provides the user with information about specific printers. If no printer type is specified, LP11 is assumed.
/NOLOG (default)Determines whether information confirming the printer setting is displayed at the terminal from which the SET PRINTER command was entered.
/NOLOWERCASEIndicates whether the printer prints both uppercase and lowercase letters or only uppercase. When the operator specifies the /NOLOWERCASE qualifier, all letters are translated to uppercase.
The /[NO]LOWERCASE and /[NO]UPPERCASE qualifiers are complementary; that is, the /LOWERCASE qualifier is equivalent to the /NOUPPERCASE qualifier, and the /NOLOWERCASE qualifier is equivalent to the /UPPERCASE qualifier.
/LP11 (default)Specifies the printer as an LP11. This qualifier provides information for the SHOW PRINTER command, which, in turn, provides the user with information about specific printers. LP11 is the default printer type.
/PAGE=lines-per-pageEstablishes the number of lines per page on the currently installed form; the number of lines can range from 1 to 255 and defaults to 64. The printer driver uses this value to determine the number of line feeds that must be entered to simulate a form feed.
/NOPASSALL (default)Controls whether the system interprets special characters or passes them as 8-bit binary data.
If you specify the /PASSALL qualifier, the printer driver does not expand tab characters to spaces, fill carriage return or line feed characters, or recognize control characters.
/NOPOLLED (default)Instructs the LRDRIVER to run in polled mode instead of interrupt mode.
In polled mode, the printer is checked on a regular basis to determine if it is ready to receive additional data. The polling timer runs only while there is more data to be sent to the printer.
/NOPRINTALL (default)Controls whether the line printer driver outputs printable 8-bit multinational characters.
/RESETResets the USB pipe associated with the USB printer, thereby canceling all print jobs.
/NOTAB (default)Controls how the printer handles TAB characters. The /NOTAB qualifier expands all tab characters to spaces and assumes tab stops at 8-character intervals.
Use the /TAB qualifier when you do not want the system to convert tabs to spaces, but want the printer to process the tab characters. The OpenVMS system requires that printers expand tabs at 8-character intervals.
/NOTRUNCATEControls whether the printer truncates data exceeding the value specified by the /WIDTH qualifier. Note that the /TRUNCATE and /WRAP qualifiers are incompatible.
/UNKNOWNSpecifies the printer as nonstandard. This qualifier provides information for the SHOW PRINTER command, which, in turn, provides the user with information about specific printers. If no printer type qualifier is specified, LP11 is assumed.
/NOUPPERCASEIndicates whether the printer prints both uppercase and lowercase letters or only uppercase ones. When you specify the /UPPERCASE qualifier, all letters are translated to uppercase.
The /[NO]UPPERCASE and /[NO]LOWERCASE qualifiers are complementary; that is, the /UPPERCASE qualifier is equivalent to the /NOLOWERCASE qualifier, and the /NOUPPERCASE qualifier is equivalent to the /LOWERCASE qualifier.
/WIDTH=nEstablishes the number of characters per output line on currently installed forms. The width, n, can range from 0 to 65535 for LP11 controllers, and from 0 to 255 for DMF32 controllers. The default value is 132 characters per line.
/NOWRAP (default)Controls whether the printer generates a carriage return and a line feed when it reaches the end of a line.
If the /NOWRAP qualifier is specified, the printer writes characters out in the last position on the line.
If the /WRAP qualifier is specified, the terminal generates a carriage return and a line feed whenever the end of a line is reached.
Note that the /TRUNCATE and /WRAP qualifiers are incompatible.
$ SET PRINTER/PAGE=60/WIDTH=80 LPA0:
The SET PRINTER command in this example establishes the size of an output page as 60 lines and the width of a line as 80 characters for printer LPA0.
$ SET PRINTER/LA11 LPB0:
The SET PRINTER command in this example establishes the line printer LPB0 as an LA11 printer.
$ SET PRINTER/LOWERCASE LPA0: