HELPLIB.HLB  —  System Services, $DELLNM
    Deletes all logical names with the specified name at the
    specified access mode or outer access mode, or it deletes all
    the logical names with the specified access mode or outer access
    mode in a specified table.

    On Alpha and Integrity server systems, this service accepts 64-
    bit addresses.

    Format

      SYS$DELLNM  tabnam ,[lognam] ,[acmode]

    C Prototype

      int sys$dellnm  (void *tabnam, void *lognam, unsigned char

                      *acmode);

1  –  Arguments

 tabnam

    OpenVMS usage:logical_name
    type:         character-coded text string
    access:       read only
    mechanism:    by 32- or 64-bit descriptor-fixed-length string
                  descriptor
    Name of a logical name table or a list of tables to be searched
    for the logical name to be deleted. The tabnam argument is the
    32- or 64-bit address of a descriptor that points to the table
    name. This argument is required.

    If tabnam is not the name of a logical name table, it is assumed
    to be a logical name and is translated iteratively until either
    the name of a logical name table is found or the number of
    translations allowed by the system has been performed.

    If tabnam translates to the name of a list of tables, $DELLNM
    does the following:

    o  If you specify the lognam argument, $DELLNM searches (in
       order) each table in the list until it finds the first table
       that contains the specified logical name. If the logical
       name is at the specified access mode, $DELLNM then deletes
       occurrences of the logical name at the specified access mode
       and at outer access modes within the table.

    o  If you do not specify the lognam argument, $DELLNM deletes all
       of the logical names at the specified access mode or at outer
       access modes from the first table in the list whose access
       mode is equal to or less privileged than the caller's access
       mode.

 lognam

    OpenVMS usage:logical_name
    type:         character-coded text string
    access:       read only
    mechanism:    by 32- or 64-bit descriptor-fixed-length string
                  descriptor
    Logical name to be deleted. The lognam argument is the 32- or
    64-bit address of a descriptor that points to the logical name
    string.

 acmode

    OpenVMS usage:access_mode
    type:         byte (unsigned)
    access:       read only
    mechanism:    by 32- or 64-bit reference
    Access mode to be used in the delete operation. The acmode
    argument is the 32- or 64-bit address of a byte containing this
    access mode. The $PSLDEF macro defines symbolic names for the
    four access modes.

    You determine the access mode actually used in the delete
    operation by maximizing the access mode of the caller with the
    access mode specified by the acmode argument; that is, the less
    privileged of the two is used.

    However, if you have SYSNAM privilege, the delete operation is
    executed at the specified access mode regardless of the caller's
    access mode.

    If you omit this argument or specify it as 0, the access mode
    of the caller is used in the delete operation. The access mode
    used in the delete operation determines which tables are used and
    which names are deleted.
Close Help