VMS Help System Services, $ADD PROXY  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Adds a new proxy to, or modifies an existing proxy in, the proxy
    database.

    Format

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

    C Prototype

      int sys$add_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 added to 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. Node names are converted to their DECnet for OpenVMS full
    name unless the PRX$M_BYPASS_EXPAND flag is set with the flags
    argument.

    If you specify a single asterisk (*)  for the rem_node argument,
    the user name specified by the rem_user argument on all nodes is
    served by the proxy.

 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 added to 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.

    If you specify a single asterisk (*)  for the rem_user argument,
    all users from the node specified by the rem_node argument
    are served by the same user names specified by the local_user
    argument.

 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 add to the proxy record specified by the rem_
    node and rem_user arguments in the proxy database as either
    the default user or local user. The local_user argument is the
    address of a character-string descriptor pointing to the local
    user name.

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

    The user name specified by the local_user argument must be a user
    name known to the local system.

    If the PRX$M_DEFAULT flag is specified in the flags argument, the
    user name specified by the local_user argument will be added to
    the proxy record in the proxy database as the default user. If a
    default user already exists for the specified proxy record, the
    default user is placed into the proxy's local user list and is
    replaced by the user name specified by the local_user argument.

    Proxy records can contain no more than 16 local users and 1
    default user. To add multiple users to a single proxy, you must
    call this service once for each local user.

 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 for OpenVMS 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_DEFAULT      The user name specified by the local_user
                       argument is the default user for the proxy.
                       If this flag is not specified, the user name
                       specified by the local_user argument is added
                       to the proxy record's local user list.

    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.