HELPLIB.HLB  —  DELETE
    The DELETE command performs the following functions:

    o  Deletes one or more files from a mass storage disk volume (see
       subtopic "file"). Included under the DELETE subtopic, file,
       is information on the following qualifiers: /BACKUP, /BEFORE,
       /BY_OWNER, /CONFIRM, /CREATED, /ERASE, /EXCLUDE, /EXPIRED,
       /IGNORE, /LOG, /MODIFIED, /SINCE, /STYLE, /SYMLINK, and /TREE.

    o  Deletes one or more active bitmaps (see /BITMAP).
       (Alpha/Integrity servers only)

    o  Deletes the definition of a queue characteristic previously
       established with the DEFINE/CHARACTERISTIC command (see
       /CHARACTERISTIC).

    o  Deletes one or more print or batch jobs. The jobs can be in
       progress or waiting in the queue (see /ENTRY).

    o  Deletes a form (for printer or terminal queues) previously
       established with the DEFINE/FORM command (see /FORM).

    o  Removes an entry from the break-in database (see /INTRUSION_
       RECORD).

    o  Deletes key definitions that have been established by the
       DEFINE/KEY command (see /KEY).

    o  Deletes a specified mailbox (see /MAILBOX). (Alpha/Integrity
       servers only)

    o  Deletes a print or batch queue created by the INITIALIZE/QUEUE
       command, and deletes all the jobs in the queue (see /QUEUE).

    o  Deletes a queue manager on a node or OpenVMS Cluster system
       (see /QUEUE/MANAGER).

    o  Deletes one or all symbol definitions from a local or global
       symbol table (see /SYMBOL).

                                   NOTE

       Any displays associated with the DELETE command will show
       sizes in blocks or bytes, depending on the current default
       setting. You can use SHOW PROCESS/UNITS to display the
       current default. To change the default, execute the DCL
       command SET PROCESS/UNITS=BYTES or SET PROCESS/UNITS=BLOCKS.

1  –  file

    Deletes one or more files from a mass storage disk volume.

    Requires delete (D) access to the file and write (W) access to
    the parent directory.

    Format

      DELETE  filespec[,...]

1.1  –  Parameter

 filespec[,...]

    Specifies the names of one or more files to be deleted from a
    mass storage disk volume. The first file specification must
    contain an explicit or default directory specification plus an
    explicit file name, file type, and version number. Subsequent
    file specifications need contain only a version number; the
    defaults will come from the preceding specification. The asterisk
    (*)  and the percent sign (%) wildcard characters can be used in
    any of the file specification fields.

    If you omit the directory specification or device name, the
    current default device and directory are assumed.

    If the file specification contains a null version number (a
    semicolon (;)  followed by no file version number), a version
    number of 0, or one or more spaces in the version number, the
    latest version of the file is deleted.

    If an input-file specification parameter is a symbolic link, the
    symbolic link itself is deleted.

    To delete more than one file, separate the file specifications
    with either commas (,)  or plus signs (+).

1.2  –  Qualifiers

1.2.1    /BACKUP

    Modifies the time value specified with the /BEFORE or the
    /SINCE qualifier. The /BACKUP qualifier selects files according
    to the dates of their most recent backups. This qualifier
    is incompatible with the /CREATED, /EXPIRED, and /MODIFIED
    qualifiers, which also allow you to select files according
    to time attributes. If you specify none of these four time
    qualifiers, the default is the /CREATED qualifier.

                                   NOTE

       Using this qualifier with DELETE/TREE command results in an
       error.

1.2.2    /BEFORE

       /BEFORE[=time]

    Selects only those files dated prior to the specified time. You
    can specify time as absolute time, as a combination of absolute
    and delta times, or as one of the following keywords: BOOT,
    LOGIN, TODAY (default), TOMORROW, or YESTERDAY. Specify one of
    the following qualifiers with the /BEFORE qualifier to indicate
    the time attribute to be used as the basis for selection:
    /BACKUP, /CREATED (default), /EXPIRED, or /MODIFIED.

    For complete information on specifying time values, see the
    OpenVMS User's Manual or the online help topic Date.

                                   NOTE

       Using this qualifier with DELETE/TREE command results in an
       error.

1.2.3    /BY_OWNER

       /BY_OWNER[=uic]

    Selects only those files whose owner user identification code
    (UIC) matches the specified owner UIC. The default UIC is that of
    the current process.

    Specify the UIC by using standard UIC format as described in the
    VSI OpenVMS Guide to System Security.

                                   NOTE

       Using this qualifier with DELETE/TREE command results in an
       error.

1.2.4    /CONFIRM

       /CONFIRM
       /NOCONFIRM (default)

    Controls whether a request is issued before each delete operation
    to confirm that the operation should be performed on that file.
    The following responses are valid:

    YES      NO       QUIT
    TRUE     FALSE    Ctrl/Z
    1        0        ALL
             <Return>

    You can use any combination of uppercase and lowercase letters
    for word responses. Word responses can be abbreviated to one or
    more letters (for example, T, TR, or TRU for TRUE), but these
    abbreviations must be unique. Affirmative answers are YES, TRUE,
    and 1. Negative answers include: NO, FALSE, 0, and pressing
    Return. Entering QUIT or pressing Ctrl/Z indicates that you want
    to stop processing the command at that point. When you respond by
    entering ALL, the command continues to process, but no further
    prompts are given. If you type a response other than one of
    those in the list, DCL issues an error message and redisplays
    the prompt.

                                   NOTE

       Using this qualifier with DELETE/TREE command results in an
       error.

1.2.5    /CREATED

       /CREATED (default)

    Modifies the time value specified with the /BEFORE or the /SINCE
    qualifier. The /CREATED qualifier selects files based on their
    dates of creation. This qualifier is incompatible with the
    /BACKUP, /EXPIRED, and /MODIFIED qualifiers, which also allow
    you to select files according to time attributes. If you specify
    none of these four time qualifiers, the default is the /CREATED
    qualifier.

                                   NOTE

       Using this qualifier with DELETE/TREE command results in an
       error.

1.2.6    /ERASE

       /ERASE
       /NOERASE (default)

    When you delete a file, the area in which the file was stored is
    returned to the system for future use. The data that was stored
    in that location still exists in the system until new data is
    written over it. When you specify the /ERASE qualifier, the
    storage location is overwritten with a system specified pattern
    so that the data no longer exists.

1.2.7    /EXCLUDE

       /EXCLUDE=(filespec[,...])

    Excludes the specified files from the delete operation. You can
    include a directory but not a device in the file specification.
    The asterisk (*)  and the percent sign (%) wildcard characters
    are allowed in the file specification. However, you cannot use
    relative version numbers to exclude a specific version. If you
    specify only one file, you can omit the parentheses.

                                   NOTE

       Using this qualifier with DELETE/TREE command results in an
       error.

1.2.8    /EXPIRED

    Modifies the time value specified with the /BEFORE or the /SINCE
    qualifier. The /EXPIRED qualifier selects files according to
    their expiration dates. (The expiration date is set with the
    SET FILE/EXPIRATION_DATE command.) The /EXPIRED qualifier
    is incompatible with the /BACKUP, /CREATED, and /MODIFIED
    qualifiers, which also allow you to select files according
    to time attributes. If you specify none of these four time
    qualifiers, the default is the /CREATED qualifier.

                                   NOTE

       Using this qualifier with DELETE/TREE command results in an
       error.

1.2.9    /GRAND_TOTAL

       /GRAND_TOTAL (Alpha/Integrity servers only)

    Displays the total number of files and blocks or bytes deleted.
    The display is shown as blocks or bytes depending on the current
    default setting. You can use SHOW PROCESS/UNITS to display the
    current default. To change the default, execute the DCL command
    SET PROCESS/UNITS=BYTES or SET PROCESS/UNITS=BLOCKS.

1.2.10    /IGNORE

       /IGNORE=INTERLOCK (Alpha/Integrity servers only)

    Allows you to mark a write-accessed file for deletion. This
    removes the file name entry, and the file is deleted when it
    is closed by the final user.

1.2.11    /LOG

       /LOG
       /NOLOG (default)

    Controls whether the DELETE command displays the file
    specification of each file after its deletion.

1.2.12    /MODIFIED

    Modifies the time value specified with the /BEFORE or the /SINCE
    qualifier. The /MODIFIED qualifier selects files according to
    the dates on which they were last modified. This qualifier
    is incompatible with the /BACKUP, /CREATED, and /EXPIRED
    qualifiers, which also allow you to select files according
    to time attributes. If you specify none of these four time
    modifiers, the default is the /CREATED qualifier.

                                   NOTE

       Using this qualifier with DELETE/TREE command results in an
       error.

1.2.13    /SINCE

       /SINCE[=time]

    Selects only those files dated on or after the specified time.
    You can specify time as absolute time, as a combination of
    absolute and delta times, or as one of the following keywords:
    BOOT, JOB_LOGIN, LOGIN, TODAY (default), TOMORROW, or YESTERDAY.
    Specify one of the following qualifiers with the /SINCE qualifier
    to indicate the time attribute to be used as the basis for
    selection: /BACKUP, /CREATED (default), /EXPIRED, or /MODIFIED.

    For complete information about specifying time values, see the
    OpenVMS User's Manual or the online help topic Date.

                                   NOTE

       Using this qualifier with DELETE/TREE command results in an
       error.

1.2.14    /STYLE

       /STYLE=keyword

    Specifies the file name format for display purposes while
    deleting files.

    The valid keywords for this qualifier are CONDENSED and EXPANDED.
    Descriptions are as follows:

    Keyword     Explanation

    CONDENSED   Displays the file name representation of what is
    (default)   generated to fit into a 255-length character string.
                This file name may contain a DID or a FID in the file
                specification.
    EXPANDED    Displays the file name representation of what is
                stored on disk. This file name does not contain any
                DID or FID abbreviations.

    The keywords CONDENSED and EXPANDED are mutually exclusive. This
    qualifier specifies which file name format is displayed in the
    output message, along with the confirmation if requested.

    File errors are displayed with the CONDENSED file specification
    unless the EXPANDED keyword is specified.

    See the OpenVMS User's Manual for more information.

1.2.15    /SYMLINK

       /SYMLINK=keyword

    The valid keywords for this qualifier are [NO]WILDCARD and
    [NO]ELLIPSIS. Descriptions are as follows:

    Keyword     Explanation

    WILDCARD    Indicates that symlinks are enabled during wildcard
                searches.
    NOWILDCARD  Indicates that symlinks are disabled during directory
                wildcard searches.
    ELLIPSIS    Equivalent to WILDCARD (included for command
                symmetry).
    NOELLIPSIS  Indicates that symlinks are matched for all wildcard
                fields except for ellipsis.

    If the file named in the DELETE command is a symlink, the command
    operates on the symlink itself.

                                   NOTE

       Using this qualifier with DELETE/TREE command results in an
       error.

1.2.16    /TREE

    Recursively deletes all files and sub directories excluding the
    parent directory.

    You can specify only the following qualifiers with the /TREE
    qualifier:

    /ERASE      /GRAND_      /IGNORE     /LOG
                TOTAL
    /STYLE

                                  NOTE

    If DELETE/TREE command finds a symbolic link file, then only
    the symbolic link file is deleted. The symbolic link file cannot
    be traversed. This behavior is true for all the values of symbolic
    link search mode, namely, [NO]WILDCARD and [NO]ELLIPSIS.

1.3  –  Examples

    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 SECURITY/PROTECTION=(OWNER:DELETE) SUBTEST.DIR
      $ 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 SECURITY/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 [;]).

    10$ DELETE/GRAND_TOTAL *.txt;*
      %DELETE-I-TOTAL, 61 files deleted (274KB)

      The output display in this example shows that 61 files were
      deleted for a total of 274KB. The process is currently set to
      display file sizes in bytes. To change future displays to show
      blocks, use the SET PROCESS/UNITS=BLOCKS command.

    11$ DELETE/TREE $5$DKA100:[HOOPS...]*.*;*/LOG
      %DELETE-I-FILDEL, $5$DKA100:[HOOPS]SMG_HP.EXE;2 deleted (32 blocks)
      %DELETE-I-FILDEL, $5$DKA100:[HOOPS]TESTMSG.exe;4 deleted (32 blocks)
      %DELETE-I-FILDEL, $5$DKA100:[HOOPS.DTM.EXAMPLES]TERMTABLE.TXT;1 deleted (16 blocks)
      %DELETE-I-FILDEL, $5$DKA100:[HOOPS.DTM]EXAMPLES.DIR;1 deleted (16 blocks)
      %DELETE-I-FILDEL, $5$DKA100:[HOOPS]DTM.DIR;1 deleted (16 blocks)
      %DELETE-I-TOTAL, 5 files deleted (112 blocks)
      $

      The DELETE/TREE command deletes all the files and sub
      directories recursively excluding the parent directory.

2    /BITMAP

    Valid for Alpha and Integrity server systems only.

    Enables the system manager to delete one or more active bitmaps
    to make memory resources available. If a minicopy bitmap is
    deleted, then former virtual unit members can be added only with
    a full copy operation. For more information about bitmaps, see
    the VSI Volume Shadowing for OpenVMS.

    Requires ownership of the device or VOLPRO (volume protection)
    privilege.

    Format

      DELETE/BITMAP  n[,n,...]

2.1  –  Parameter

 n[,n,...]

    Specifies the bitmap ID for one or more bitmaps to delete.

2.2  –  Qualifier

2.2.1    /LOG

       /LOG
       /NOLOG (default)

    Specifies whether to list each bitmap when it is deleted.

2.3  –  Example

  $ SHOW DEVICE /BITMAP DSA12

  Device   BitMap    Size    Percent     Type of   Master  Active
   Name      ID     (Bytes)  Populated   Bitmap     Node
  DSA12:  00020007     8364       0%    Minimerge  NODE1     Yes
          00040008     8364       0%    Minimerge  NODE2     Yes

  $ DELETE/BITMAP 00020007

      In this example, the SHOW DEVICE command output lists two
      bitmaps. The DELETE command deletes the bitmap with an ID of
      00020007.

3    /CHARACTERISTIC

    Deletes the definition of a queue characteristic previously
    established with the DEFINE/CHARACTERISTIC command. The
    /CHARACTERISTIC qualifier is required.

    Requires OPER (operator) privilege.

    Format

      DELETE/CHARACTERISTIC  characteristic-name

3.1  –  Parameter

 characteristic-name

    Specifies the name of the characteristic to be deleted.

3.2  –  Qualifier

3.2.1    /LOG

       /LOG
       /NOLOG (default)

    Controls whether the DELETE/CHARACTERISTIC command displays the
    name of each characteristic after its deletion.

3.3  –  Example

  $ 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.

4    /ENTRY

    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.

    Format

      DELETE/ENTRY=(entry-number[,...]) [queue-name[:]]

4.1  –  Parameters

 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.

4.2  –  Qualifier

4.2.1    /LOG

       /LOG
       /NOLOG (default)

    Controls whether the DELETE/ENTRY command displays the entry
    number of each batch or print job that it deletes.

4.3  –  Examples

    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.

5    /FORM

    Deletes a form (for printer or terminal queues) previously
    established with the DEFINE/FORM command. The /FORM qualifier
    is required.

    Requires OPER (operator) privilege.

    Format

      DELETE/FORM  form-name

5.1  –  Parameter

 form-name

    Specifies the name of the form to be deleted.

5.2  –  Qualifier

5.2.1    /LOG

       /LOG
       /NOLOG (default)

    Controls whether the DELETE/FORM command displays the name of
    each form after its deletion.

5.3  –  Examples

    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.

6    /INTRUSION_RECORD

    Removes an entry from the break-in database.

    Requires CMKRNL (change mode to kernel) and SECURITY privileges.

    Format

      DELETE/INTRUSION_RECORD  source

6.1  –  Parameter

 source

    Specifies the name of the device or the remote system where the
    user is attempting to log in. The source name can be presented
    in the syntax of another operating system domain, for example,
    one that is case sensitive or conflicts with DCL syntax rules.
    In such cases, you must enclose the source parameter in quotation
    marks.

6.2  –  Qualifiers

6.2.1    /NODE

       /NODE=(node-name[,...])

    Deletes the node information relating to the specified nodes. If
    the specified nodes are the only nodes in the node information
    list, the intrusion record is also deleted.

6.3  –  Examples

    1.$ DELETE/INTRUSION_RECORD TTC2:

      In this example, the DELETE/INTRUSION_RECORD command removes
      all intrusion records generated by break-in attempts on TTC2.
      No user name is specified because none of the login failures
      occurred for valid users.

    2.$ DELETE/INTRUSION_RECORD "AV34C2/LC-2-10":FORGETFUL

      In this example, the source of the break-in is a local terminal
      that is connected to a terminal server. To delete the record
      from the break-in database, you must enclose the terminal
      port name within quotation marks so that the operating system
      interprets the slash as a foreign character and not as a
      qualifier.

    3.$ DELETE/INTRUSION_RECORD NODE1::HAMMER

      This command removes all intrusion entries generated from node
      NODE1 for user HAMMER.

    4.$ DELETE/INTRUSION_RECORD/NODE=(CAPPY,INDI)
      $ SHOW INTRUSION
      NETWORK      SUSPECT       2  26-JUL-2001 08:51:25.66  BARNEY::HAMMER
          Node: TSAVO      Count:   2

      This command removes intrusion entries for the nodes CAPPY and
      INDI.

    5.$ DELETE/INTRUSION_RECORD/NODE=FOOBAR
      $ SHOW INTRUSION
      NETWORK      SUSPECT       2  26-JUL-2001 08:51:25.66  BARNEY::HAMMER
          Node: TSAVO      Count:   2

      This command removes intrusion entries for the node FOOBAR.

    6.$ DELETE/INTRUSION_RECORD/NODE=TSAVO
      $ SHOW INTRUSION
      %SHOW-F-NOINTRUDERS, no intrusion records match specification

      This command attempts to remove intrusion entries for node
      TSAVO, however there were no intrusion records for this node.

7    /KEY

    Deletes key definitions that have been established by the
    DEFINE/KEY command. The /KEY qualifier is required.

    Format

      DELETE/KEY  [key-name]

7.1  –  Parameter

 key-name

    Specifies the name of the key to be deleted. This parameter is
    incompatible with the /ALL qualifier.

7.2  –  Qualifiers

7.2.1    /ALL

    Deletes all key definitions in the specified state; the default
    is the current state. If you use the /ALL qualifier, do not
    specify a key name. Use the /STATE qualifier to specify one or
    more states.

7.2.2    /LOG

       /LOG (default)
       /NOLOG

    Controls whether messages are displayed indicating that the
    specified key definitions have been deleted.

7.2.3    /STATE

       /STATE=(state-name[,...])
       /NOSTATE (default)

    Specifies the name of the state for which the specified key
    definition is to be deleted. The default state is the current
    state. If you specify only one state name, you can omit the
    parentheses. State names can be any alphanumeric string.

7.3  –  Examples

    1.$ DELETE/KEY/ALL
      %DCL-I-DELKEY, DEFAULT key PF1 has been deleted
      %DCL-I-DELKEY, DEFAULT key PF2 has been deleted
      %DCL-I-DELKEY, DEFAULT key PF3 has been deleted
      %DCL-I-DELKEY, DEFAULT key PF4 has been deleted
      $

      In this example, the user has defined keys PF1 to PF4 in
      the default state. The DELETE/KEY command deletes all key
      definitions in the current state, which is the default state.

    2.$ DEFINE/KEY PF3 "SHOW TIME" /TERMINATE
      %DCL-I-DEFKEY, DEFAULT key PF3 has been defined
      $ <PF3>
      $ SHOW TIME
       14-DEC-2001 14:43:59
         .
         .
         .
      $ DELETE/KEY PF3
      %DCL-I-DELKEY, DEFAULT key PF3 has been deleted
      $ <PF3>
      $

      In this example, the DEFINE/KEY command defines the PF3 key on
      the keypad as SHOW TIME. To delete the definition for the PF3
      key, use the DELETE/KEY command. When the user presses PF3,
      only the system prompt is displayed.

8    /MAILBOX

    Valid for Alpha and Integrity server systems only.

    Deletes the specified mailbox.

    Requires PRMMBX (permanent mailbox) privilege.

    Format

      DELETE/MAILBOX  name

8.1  –  Parameter

 name

    Specifies the name of the mailbox device (MBAn) or the logical
    name pointing to the mailbox to be deleted

8.2  –  Qualifier

8.2.1    /LOG

       /LOG
       /NOLOG (default)

    Displays a notice when the mailbox is marked for deletion.)

8.3  –  Example

  $SHOW LOGICAL MY_MBX
     "MY_MBX" = "MBA37:" (LNM$SYSTEM_TABLE)
  $SHOW DEVICE MBA37

  Device                  Device           Error
   Name                   Status           Count
  MBA37:                  Online               0
  $DELETE/MAILBOX/LOG MBA37
  %DELETE-I-MBXDEL, Mailbox MBA37 has been marked for deletion
  $SHOW DEV MBA37
  %SYSTEM-W-NOSUCHDEV, no such device available

      This example shows the status of mailbox MBA37, which is
      pointed to by logical name MY_MBX, before and after it is
      deleted.

9    /QUEUE

    Deletes a print or batch queue created by the INITIALIZE/QUEUE
    command, and deletes all the jobs in the queue. The /QUEUE
    qualifier is required.

    Requires manage (M) access to the queue.

    To delete a queue manager on a node or OpenVMS Cluster system,
    add the /MANAGER qualifier.

    Format

      DELETE/QUEUE  queue-name[:]

9.1  –  Parameter

 queue-name[:]

    Specifies the name of the queue to be deleted.

9.2  –  Qualifier

9.2.1    /LOG

       /LOG
       /NOLOG (default)

    Controls whether the DELETE/QUEUE command displays the name of
    each queue after it is deleted.

9.3  –  Example

  $ INITIALIZE/QUEUE/DEFAULT=FLAG/START/ON=LPA0 LPA0_QUEUE
     .
     .
     .
  $ STOP/QUEUE/NEXT LPA0_QUEUE
  $ DELETE/QUEUE LPA0_QUEUE

      In this example, the first command initializes and starts the
      printer queue LPA0_QUEUE. The STOP/QUEUE/NEXT command stops the
      queue. The DELETE/QUEUE command deletes the queue.

9.4    /MANAGER

    Deletes a queue manager on a node or OpenVMS Cluster system. All
    queues and jobs managed by the specified queue manager are also
    deleted. You must first stop the queue manager. The /NAME_OF_
    MANAGER qualifier is required.

    Requires OPER (operator) and SYSNAM (system logical name)
    privileges.

    Format

      DELETE/QUEUE/MANAGER/NAME_OF_MANAGER=name

9.4.1  –  Qualifier

9.4.1.1    /NAME_OF_MANAGER

       /NAME_OF_MANAGER=string

    Identifies the name of the queue manager to be deleted. The
    /NAME_OF_MANAGER qualifier is required. The required name value
    can be up to 31 characters long and can be a logical name.

9.4.2  –  Example

  $ DELETE/QUEUE/MANAGER/NAME_OF_MANAGER=BATCH_MANAGER

      The DELETE/QUEUE/MANAGER/NAME_OF_MANAGER command in this
      example deletes the queue manager named BATCH_MANAGER. The
      command removes all references to the specified queue manager
      from the shared master file of the queue database and deletes
      the queue and journal files associated with the BATCH_MANAGER's
      database.

10    /SYMBOL

    Deletes one or all symbol definitions from a local or global
    symbol table. The /SYMBOL qualifier is required.

    Format

      DELETE/SYMBOL  [symbol-name]

10.1  –  Parameter

 symbol-name

    Specifies the name of the symbol to be deleted. A name is
    required unless the /ALL qualifier is specified. The symbol-name
    parameter is incompatible with the /ALL qualifier. Symbol names
    can have from 1 to 255 characters. By default, the DELETE/SYMBOL
    command assumes that the symbol is in the local symbol table for
    the current command procedure.

10.2  –  Qualifiers

10.2.1    /ALL

    Deletes all symbols from the specified table. If you do not
    specify either the /LOCAL or the /GLOBAL qualifier, all symbols
    defined at the current command level are deleted. The /ALL
    qualifier is incompatible with the symbol-name parameter.

10.2.2    /GLOBAL

    Deletes the symbol from the global symbol table of the current
    process.

10.2.3    /LOCAL

       /LOCAL (default)

    Deletes the symbol from the local symbol table of the current
    process.

10.2.4    /LOG

       /LOG
       /NOLOG (default)

    Controls whether an informational message listing each symbol
    being deleted is displayed.

10.3  –  Examples

    1.$ DELETE/SYMBOL/ALL

      In this example, the DELETE/SYMBOL command deletes all symbol
      definitions at the current command level.

    2.$ DELETE/SYMBOL/LOG KUDOS
      %DCL-I-DELSYM, LOCAL symbol KUDOS has been deleted

      In this example, the DELETE/SYMBOL command deletes the symbol
      KUDOS from the local symbol table for the current process. In
      addition, the /LOG qualifier causes an informational message,
      listing the symbol being deleted, to be displayed.

    3.$ DELETE/SYMBOL/GLOBAL PDEL

      In this example, the DELETE/SYMBOL command deletes the symbol
      named PDEL from the global symbol table for the current
      process.
Close Help