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