Library /sys$common/syshlp/helplib.hlb  —  System Services, $DELETE PROXY
    Deletes an existing proxy or removes the default user or a local
    user from an existing proxy in the proxy database.

    Format

      SYS$DELETE_PROXY  rem_node ,rem_user ,[local_user] ,[flags]

    D Prototype

      int sys$delete_proxy  (void *rem_node, void *rem_user, void

                            *local_user, unsigned int flags);

1  –  Arguments

 rem_node

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       read only
    mechanism:    by descriptor-fixed-length string descriptor
    Remote node name of the proxy to be deleted from or modified
    in the proxy database. The rem_node argument is the address of
    a character-string descriptor pointing to the remote node name
    string.

    A remote node name consists of 1 to 1024 characters. No specific
    characters, format, or case are required for a remote node name
    string. All node names are converted to their DECnet for OpenVMS
    full name unless the PRX$M_BYPASS_EXPAND flag is set with the
    flags argument.

    Asterisk (*)  and percent sign (%) wildcards are allowed for the
    remote node specification. If you specify wildcards for the rem_
    node argument, the security server searches for an exact match
    to the specified remote node first. If it does not find an exact
    match, the server performs the requested operations on all of the
    matching proxies in the proxy database.

 rem_user

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       read only
    mechanism:    by descriptor-fixed-length string descriptor
    Remote user name of the proxy to be deleted from or modified in
    the proxy database. The rem_user argument is the address of a
    character-string descriptor pointing to the user name string.

    A remote user name consists of 1 to 32 alphanumeric characters,
    including dollar signs ($),  underscores (_), and brackets
    ([ ]).  Any lowercase characters specified are automatically
    converted to uppercase.

    The rem_user argument can be specified in user identification
    code (UIC) format ([group, member]).  Brackets are allowed only
    if the remote user name string specifies a UIC. Group and member
    are character-string representations of octal numbers with no
    leading zeros.

    Asterisk (*)  and percent sign (%) wildcards are allowed for
    the remote user specification. If you specify wildcards for the
    rem_user argument, the server searches for an exact match to
    the specified remote user first. If it does not find an exact
    match, the server performs the requested operations on all of the
    matching proxies in the proxy database.

 local_user

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       read only
    mechanism:    by descriptor-fixed-length string descriptor
    Local user name to delete from the proxy record specified by the
    rem_node and rem_user arguments in the proxy database. The local_
    user argument is the address of a character-string descriptor
    pointing to the local user name.

    A local user name consists of 0 to 32 alphanumeric characters,
    including dollar signs ($)  and underscores (_). If the local_
    user argument is not specified or has a length of 0, the server
    will delete the entire record or records specified by the rem_
    node and rem_user arguments from the proxy database.

    If the local_user argument is specified, the server will delete
    only the user name specified by the local_user argument from
    the record specified by the rem_node and rem_user arguments. The
    local_user argument can specify either the proxy's default user
    or a user name in the proxy's local users list.

 flags

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Functional specification for the service and type of user the
    local_user argument represents. The flags argument is a longword
    bit mask wherein each bit corresponds to an option.

    Each flag option has a symbolic name. The $PRXDEF macro defines
    the following symbolic names:

    Symbolic Name      Description

    PRX$M_BYPASS_      The service should not convert the node name
    EXPAND             specified in the rem_node argument to its
                       corresponding DECnet full name. If this flag
                       is set, it is the caller's responsibility to
                       ensure that the fully expanded node name is
                       passed into the service.

    PRX$M_IGNORE_      The service should not wait for a return
    RETURN             status from the security server. No return
                       status from the server's function will be
                       returned to the caller.
    PRX$M_EXACT        The service should match exactly the remote
                       node and remote user and ignore wildcards.
Close Help