HELPLIB.HLB  —  System Services, $MOD IDENT
    Modifies the specified identifier record in the rights database.

    Format

      SYS$MOD_IDENT  id ,[set_attrib] ,[clr_attrib] ,[new_name]

                     ,[new_value]

    C Prototype

      int sys$mod_ident  (unsigned int id, unsigned int set_attrib,

                         unsigned int clr_attrib, void *new_name,

                         unsigned int new_value);

1  –  Arguments

 id

    OpenVMS usage:rights_id
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Binary value of identifier whose identifier record is modified
    when $MOD_IDENT completes execution. The id argument is a
    longword containing the identifier value.

 set_attrib

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Bit mask of attributes to be enabled for the identifier when
    $MOD_IDENT completes execution. The set_attrib argument is a
    longword containing the attribute mask.

    The attributes actually enabled are the intersection of those
    specified and the attributes of the identifier. If you specify
    the same attribute in set_attrib and clr_attrib, the attribute is
    enabled.

    Symbol values are offsets to the bits within the longword. You
    can also obtain the values as masks with the appropriate bit set
    using the prefix KGB$M rather than KGB$V. The following symbols
    for each bit position are defined in the system macro library
    ($KGBDEF):

    Bit Position           Meaning When Set

    KGB$V_DYNAMIC          Allows holders of the identifier to remove
                           it from or add it to the process rights
                           list by using the DCL command SET_RIGHTS_
                           LIST.
    KGB$V_HOLDER_HIDDEN    Prevents someone from getting a list of
                           users who hold an identifier, unless they
                           own the identifier themselves.
    KGB$V_NAME_HIDDEN      Allows holders of an identifier to have it
                           translated-either from binary to ASCII or
                           vice versa-but prevents unauthorized users
                           from translating the identifier.
    KGB$V_NOACCESS         Makes any access rights of the identifier
                           null and void. This attribute is intended
                           as a modifier for a resource identifier or
                           the Subsystem attribute.
    KGB$V_RESOURCE         Allows holders of an identifier to charge
                           disk space to the identifier. It is used
                           only for file objects.
    KGB$V_SUBSYSTEM        Allows holders of the identifier to
                           create and maintain protected subsystems
                           by assigning the Subsystem ACE to the
                           application images in the subsystem.

 clr_attrib

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Bit mask of attributes to be disabled for the identifier when
    $MOD_IDENT completes execution. The clr_attrib argument is a
    longword containing the attribute mask.

    If you specify the same attribute in set_attrib and clr_attrib,
    the attribute is enabled.

    Symbol values are offsets to the bits within the longword. You
    can also obtain the values as masks with the appropriate bit set
    using the prefix KGB$M rather than KGB$V. The following symbols
    for each bit position are defined in the system macro library
    ($KGBDEF):

    Bit Position           Meaning When Set

    KGB$V_DYNAMIC          Allows holders of the identifier to remove
                           it from or add it to the process rights
                           list by using the DCL command SET_RIGHTS_
                           LIST.
    KGB$V_HOLDER_HIDDEN    Prevents someone from getting a list of
                           users who hold an identifier, unless they
                           own the identifier themselves.
    KGB$V_NAME_HIDDEN      Allows holders of an identifier to have it
                           translated-either from binary to ASCII or
                           vice versa-but prevents unauthorized users
                           from translating the identifier.
    KGB$V_NOACCESS         Makes any access rights of the identifier
                           null and void. This attribute is intended
                           as a modifier for a resource identifier or
                           the Subsystem attribute.
    KGB$V_RESOURCE         Allows holders of an identifier to charge
                           disk space to the identifier. It is used
                           only for file objects.
    KGB$V_SUBSYSTEM        Allows holders of the identifier to
                           create and maintain protected subsystems
                           by assigning the Subsystem ACE to the
                           application images in the subsystem.

 new_name

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       read only
    mechanism:    by descriptor-fixed-length string descriptor
    New name to be given to the specified identifier. The new_
    name argument is the address of the descriptor pointing to the
    identifier name string.

    An identifier name consists of 1 to 31 alphanumeric characters,
    including dollar signs ($)  and underscores (_), and must contain
    at least one nonnumeric character. Any lowercase characters
    specified are automatically converted to uppercase.

 new_value

    OpenVMS usage:rights_id
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    New value to be assigned to the specified identifier. The new_
    value argument is a longword containing the binary value of the
    specified identifier. When the identifier value is changed, $MOD_
    IDENT also changes the value of the identifier in all of the
    holder records in which the specified identifier appears.
Close Help