|
HP OpenVMS Systems Documentation |
|
HP OpenVMS DCL Dictionary
In this example, the DEFINE/KEY command defines the PF3 key on the keypad to perform the SHOW TIME command. DEFAULT refers to the default state.
DELETE
Deletes one or more files from a mass storage disk volume. FormatDELETE filespec[,...] Parameter
DescriptionThe DELETE command deletes one or more files from a mass storage disk volume. This command requires delete (D) access to the file and write (W) access to the parent directory. If the target file is itself a directory, the directory must be empty. Qualifiers
|
| #1 |
|---|
$ DELETE COMMON.SUM;2
|
The DELETE command deletes the file COMMON.SUM;2 from the current default disk and directory.
| #2 |
|---|
$ DELETE *.OLD;*
|
The DELETE command deletes all versions of files with file type .OLD from the default disk directory.
| #3 |
|---|
$ DELETE ALPHA.TXT;*, BETA;*, GAMMA;*
|
The DELETE command deletes all versions of the files ALPHA.TXT, BETA.TXT, and GAMMA.TXT. The command uses the file type of the first input file as a temporary default. Note, however, that some form of version number (here specified as the asterisk (*) wildcards) must be included in each file specification.
| #4 |
|---|
$ DELETE /BEFORE=15-APR/LOG *.DAT;*
%DELETE-I-FILDEL, DISK2:[MAIN]ASSIGN.DAT;1 deleted (5 block)
%DELETE-I-FILDEL, DISK2:[MAIN]BATCHAVE.DAT;3 deleted (4 blocks)
%DELETE-I-FILDEL, DISK2:[MAIN]BATCHAVE.DAT;2 deleted (4 blocks)
%DELETE-I-FILDEL, DISK2:[MAIN]BATCHAVE.DAT;1 deleted (4 blocks)
%DELETE-I-FILDEL, DISK2:[MAIN]CANCEL.DAT;1 deleted (2 blocks)
%DELETE-I-FILDEL, DISK2:[MAIN]DEFINE.DAT;1 deleted (3 blocks)
%DELETE-I-FILDEL, DISK2:[MAIN]EXIT.DAT;1 deleted (1 block)
%DELETE-I-TOTAL, 7 files deleted (23 blocks)
|
The DELETE command deletes all versions of all files with file type .DAT that were either created or updated before April 15 of this year. The /LOG qualifier not only displays the name of each file deleted, but also the total number of files deleted.
| #5 |
|---|
$ DELETE A.B;
|
The DELETE command deletes the file A.B with the highest version number.
| #6 |
|---|
$ DELETE/CONFIRM/SINCE=TODAY [MEIER.TESTFILES]*.OBJ;*
DISK0:[MEIER.TESTFILES]AVERAG.OBJ;1, delete? [N]:Y
DISK0:[MEIER.TESTFILES]SCANLINE.OBJ;4, delete? [N]:N
DISK0:[MEIER.TESTFILES]SCANLINE.OBJ;3, delete? [N]:N
DISK0:[MEIER.TESTFILES]SCANLINE.OBJ;2, delete? [N]:N
DISK0:[MEIER.TESTFILES]WEATHER.OBJ;3, delete? [N]:Y
|
The DELETE command examines all versions of files with file type .OBJ in the subdirectory [MEIER.TESTFILES], and locates those that were created or modified today. Before deleting each file, it requests confirmation that the file should be deleted. The default response---N---is given in brackets.
| #7 |
|---|
$ DIRECTORY [.SUBTEST]
%DIRECT-W-NOFILES, no files found
$ SET PROTECTION SUBTEST.DIR/PROTECTION=OWNER:D
$ DELETE SUBTEST.DIR;1
|
Before the directory file SUBTEST.DIR is deleted, the DIRECTORY command is used to verify that there are no files cataloged in the directory. The SET PROTECTION command redefines the protection for the directory file so that it can be deleted; then the DELETE command deletes it.
| #8 |
|---|
$ DELETE DALLAS"THOMAS SECRET"::DISK0:[000,000]DECODE.LIS;1
|
This DELETE command deletes the file DECODE.LIS;1 from the directory [000,000] on device DISK0 at remote node DALLAS. The user name and password follow the remote node name.
| #9 |
|---|
$ DELETE NODE12::"DISK1:DEAL.BIG"
$ DELETE NODE12::DISK1:DEAL.BIG;
|
Either of these DELETE commands can be used to delete the file DEAL.BIG on device ZZZ1 at remote node NODE12. Note that the DELETE command requires an explicit version number in a file specification, but the file to be deleted is on a remote node whose file syntax does not recognize version numbers. (NODE12 is an RT-11 node.) Therefore, the file specification must either be enclosed in quotation marks (" ") or entered with a null version number (that is, a trailing semicolon [;]).
Deletes the definition of a queue characteristic previously established with the DEFINE/CHARACTERISTIC command. The /CHARACTERISTIC qualifier is required.Requires OPER (operator) privilege.
DELETE/CHARACTERISTIC characteristic-name
characteristic-name
Specifies the name of the characteristic to be deleted.
The DELETE/CHARACTERISTIC command deletes a characteristic from the system characteristic table.To modify a characteristic's name or number, you must delete and redefine the characteristic.
/LOG
/NOLOG (default)
Controls whether the DELETE/CHARACTERISTIC command displays the name of each characteristic after its deletion.
$ DEFINE/CHARACTERISTIC BLUE 7
.
.
.
$ DELETE/CHARACTERISTIC BLUE
$ DEFINE/CHARACTERISTIC BLUE_INK 7
|
The DEFINE/CHARACTERISTIC command in this example establishes the characteristic BLUE, with number 7, to mean blue ink ribbons for printers. To change the name of the characteristic, enter the DELETE/CHARACTERISTIC command. Then enter another DEFINE/CHARACTERISTIC command to rename the characteristic to BLUE_INK, using the characteristic number 7.
Deletes one or more print or batch jobs. The jobs can be in progress or waiting in the queue. The /ENTRY qualifier is required.Requires manage (M) access to the queue, or delete (D) access to the specified jobs.
DELETE/ENTRY =(entry-number[,...]) [queue-name[:]]
entry-number[,...]
Specifies the entry number (or a list of entry numbers) of jobs to be deleted. If you specify only one entry number, you can omit the parentheses. If you do not specify a queue name, you can delete entries from multiple queues.The system assigns a unique entry number to each queued print or batch job in the system. By default, the PRINT and SUBMIT commands display the entry number when they successfully queue a job for processing. These commands also create or update the local symbol $ENTRY to reflect the entry number of the most recently queued job. To find a job's entry number, enter the SHOW ENTRY or SHOW QUEUE command.
queue-name[:]
Specifies the name of the queue where the jobs are located. The queue name can refer either to the queue to which the job was submitted or to the queue where the job is executing. The queue-name parameter is optional syntax; however, when you specify a queue name, the operating system uses it to verify an entry in the specific queue before deleting the entry.
The DELETE/ENTRY command deletes one or more jobs from a queue. If you specify a queue name and more than one entry number with a DELETE/ENTRY command, all the jobs must be located in the same queue.You can delete jobs that are currently executing, as well as jobs that are in other states. For example, DELETE/ENTRY can delete a job that is currently in a holding or a pending state.
/LOG
/NOLOG (default)
Controls whether the DELETE/ENTRY command displays the entry number of each batch or print job that it deletes.
| #1 |
|---|
$ PRINT/HOLD ALPHA.TXT
Job ALPHA (queue SYS$PRINT, entry 110) holding
.
.
.
$ DELETE/ENTRY=110 SYS$PRINT
|
The PRINT command in this example queues a copy of the file ALPHA.TXT in a HOLD status, to defer its printing until a SET ENTRY/RELEASE command is entered. The system displays the job name, the entry number, the name of the queue in which the job was entered, and the status. Later, the DELETE/ENTRY command requests that the entry be deleted from the queue SYS$PRINT.
| #2 |
|---|
$ SUBMIT/AFTER=18:00 WEATHER
Job WEATHER (queue SYS$BATCH, entry 203) holding until 14-DEC-2001
18:00
$ SUBMIT/HOLD/PARAMETERS=SCANLINE DOFOR
Job DOFOR (queue SYS$BATCH, entry 210) holding
.
.
.
$ DELETE/ENTRY=(203,210)/LOG
%DELETE-W-SEARCHFAIL, error searching for 203
-JBC-E-NOSUCHENT, no such entry
%DELETE-I-DELETED, entry 210 aborting or deleted
|
The SUBMIT commands in this example queue the command procedures WEATHER.COM and DOFOR.COM for processing as batch jobs. WEATHER.COM is queued for execution after 6:00 P.M. DOFOR.COM is queued in a HOLD status and cannot execute until you enter a SET ENTRY/RELEASE command. Later, the DELETE/ENTRY/LOG command requests that the system delete both these entries from the queue and display a message indicating that the entries have been deleted.
The job WEATHER (entry 203) has completed by the time the DELETE/ENTRY/LOG command is entered; therefore, entry 203 no longer exists. Note that a message indicates that there is no entry 203 in the queue. The job DOFOR (entry 210) is in a HOLD status when the DELETE/ENTRY/LOG command is entered. Thus, the system deletes entry 210 from the queue and displays a message to that effect.
| #3 |
|---|
$ PRINT CHAPTER8.MEM
Job CHAPTER8 (queue SYS$PRINT, entry 25) pending on queue SYS$PRINT
.
.
.
$ SHOW QUEUE SYS$PRINT
Printer queue SYS$PRINT, on PARROT::PARROT$LPA0, mounted form DEFAULT
Entry Jobname Username Status
----- ------- -------- ------
24 CHAPTER7 SMITH Pending
25 CHAPTER8 SMITH Pending
$ DELETE/ENTRY=25 SYS$PRINT
|
The PRINT command in this example submits the file CHAPTER8.MEM to the printer queue SYS$PRINT. Later, user SMITH needs to edit the file again before printing it. Using the SHOW QUEUE command, SMITH verifies that the job is still pending and that the entry number for the job is 25. SMITH then enters the DELETE/ENTRY command to delete the job from the queue.
Deletes a form (for printer or terminal queues) previously established with the DEFINE/FORM command. The /FORM qualifier is required.Requires OPER (operator) privilege.
DELETE/FORM form-name
form-name
Specifies the name of the form to be deleted.
The DELETE/FORM command deletes a form definition from the system forms table. When you delete a form, there can be no outstanding references to the form either in queues that have been mounted with the form or by jobs requesting that form. To locate all references to the form, use the SHOW QUEUE/FULL command.To modify a form's name or number, you must delete and redefine the form. Values for any DEFINE/FORM qualifier can be modified by reentering the DEFINE/FORM command with different values, as long as the form name and number remain the same.
/LOG
/NOLOG (default)
Controls whether the DELETE/FORM command displays the name of each form after its deletion.
| #1 |
|---|
$ DELETE/FORM CENTER
|
The DELETE/FORM command in this example deletes the form named CENTER.
| #2 |
|---|
$ DEFINE/FORM -
_$ /DESCRIPTION="letter size continuous form paper" CFLET 7
.
.
.
$ DELETE/FORM CFLET
$ DEFINE/FORM -
_$ /DESCRIPTION="letter size continuous form paper" LETTER_CONT 7
|
The DEFINE/FORM command in this example establishes the form CFLET with number 7 to mean continuous-form paper 8.5 inches by 11 inches. To change the name of the form, delete the form named CFLET and define a new one named LETTER_CONT.
| Previous | Next | Contents | Index |