NAME

pmx-rpc-enduser - Query and testing tool for the end user RPC server.


SYNOPSIS

 pmx-rpc-enduser <command> [options]


DESCRIPTION

The pmx-rpc-enduser command provides an interface to query and test the PureMessage end user libraries.

Commands

The following subcommands are recognized by the pmx-rpc-enduser script:

console
Opens an interactive session to the RPC server.

For a description of the various console commands see the CONSOLE.

batch script
Use the passed script file as input to the console.

Options

The following options are recognized:

--help
Displays help.

--host hostname
Host to connect to.

--port port
Port to connect to.

--proto HTTP|HTTPS
Protocol to use when connecting.

--verbose
Show extra information (for example, debugging content).

--force
Assume default answers to questions. It is suggested you use this option in batch mode, for example:
  pmx-rpc-enduser batch myscript --force --fatal

--fatal
All RPC errors are fatal, and processing is stopped. It is suggested you use this option in batch mode.

--timeout seconds
The number of seconds to wait for a response before timing out.


CONSOLE

The console opens an interactive session that can be used to execute RPC calls.

RPC calls (see PureMessage::RPC::Response::Enduser) can be executed by entering the call name and all paramaters to be passed.

auth calls that result in authentication tokens are automatically intercepted and the value cached. RPC calls that require authentication tokens have the cached value automatically appended to the arguments sent.

For example:

 auth user@localhost 87e1e27b795f623ec2032c8ab503275
 get_features
 get_qview visible
 quit

Console Commands

%set [ key value ]
With no arguments displays the RPC connection paramaters. If key and value are passed, then it sets that key.

help or %help
Displays help

command [ arguments .. ]
Any valid RPC command as detailed in PureMessage::RPC::Response::Enduser


SEE ALSO

PureMessage::RPC::Response::Enduser


COPYRIGHT

Copyright (C) 2000-2008 Sophos Group. All rights reserved. Sophos and PureMessage are trademarks of Sophos Plc and Sophos Group.