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

    Verifies that a proxy exists and returns a valid local user for
    the caller to use to create a local login.

    Format

      SYS$VERIFY_PROXY  rem_node ,rem_user ,[proposed_user]

                        ,local_user ,local_user_length ,[flags]

    C Prototype

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

                            *proposed_user, void *local_user,

                            unsigned short int *local_user_len,

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

    Wildcards are not recognized. If you specify a wildcard character
    in the rem_node argument, it is ignored and assumed to be part of
    the requested node name.

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

    Wildcards are not allowed for the remote user specification. If
    wildcard characters are present in the string specified by the
    rem_user argument, the service returns SS$_BADPARAM.

 proposed_user

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       read only
    mechanism:    by descriptor-fixed-length string descriptor
    Local user the caller suggests be used for the proxy login.
    The proposed_user argument is the address of a character-string
    descriptor pointing to the proposed local user name.

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

    See the $VERIFY_PROXY Description section in the OpenVMS System
    Services Reference Manual for information about the interaction
    of this argument with the return value of the local_user
    argument.

 local_user

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       write only
    mechanism:    by descriptor-fixed-length string descriptor
    Local user the caller must use for a proxy login. The local_user
    argument is the address of a 32-byte character-string descriptor
    pointer to receive the local user name the caller must use for a
    proxy login for the proxy with the remote node name specified by
    the rem_node argument and the remote user name specified by the
    rem_user argument.

    A local user name is a 32-character blank padded string of
    alphanumeric characters, including dollar signs ($)  and
    underscores (_).

 local_user_length

    OpenVMS usage:output length
    type:         word (unsigned)
    access:       write only
    mechanism:    by reference
    Length of the returned local user name in the local_user
    argument. The local_user_length argument is the address of an
    unsigned word to receive the length, in bytes, of the character
    string returned in the local_user argument.

 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 name:

    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.