Important

   

This documentation space contains information about PATROL Agents when deployed in a TrueSight Operations Management environment. If you are a BMC Helix Operations Management user, see PATROL Agent 22.1 for BMC Helix Operations Management.

Determining the option to use for the task

Use the following table to find the pconfig option for the task you want to perform.

pconfig options

Task to perform

Option to use a

Additional information

Get Help on the options for pconfig.

-help

You can use the -help option with another option to get a description of that option.

Print error and status information to stdout as the utility runs.

+ verbose
+v

None

Set the debugging level for pconfig.

-debug
-d

The default is 0.

Get a list of default variables and their default values from config.default.

+Defaults

None

Specify the configuration change files to be used.

filename1
[filename2...]

You must separate the names of change files with a blank space. This option cannot be used with the +get option. You must specify "-" to enter stdin mode.

Specify the host name of the agents.

-host name
-ho

You can specify either the host name for the agent from which you want to get a configuration or the host name for the agents you want to configure. The default is the name of the local host. You can specify multiple hosts by using a comma-separated list with no intervening spaces. For more information, see Examples of configuring at the command line.

Specify the local port number of the agents.

-lp num

You can specify either the local port for the agent from which you want to get a configuration or the local port for the agents you want to configure. The default local port number is 0.

Specify the port number of the agents.

-port num
-p

You can specify either the port for the agent from which you want to get a configuration or the port for the agents you want to configure. The default port number for version 3.4 or later is 3181. The default port number for version 3.3 or earlier was 1987.

Specify that the changes come from stdin.

--

This option can be used in place of file1 [file2...].

Display the version information of pconfig.

-version

This option provides the version of the pconfig utility.

Authenticate pconfig commands to the agent.

-user
-U

-password
-W

If you set the /AgentSetup/pconfigRequiresAuthentication variable to yes, then you are required to provide a valid account to run pconfig commands. These options allow you to do that at the command line. When you use stdin, the first line must be the password.

Specify the number of seconds before a connection timeout occurs.

-timeout

This option is useful when transferring a configuration file which contains over 2,000 variables.

a Shortcut entries, where available, are listed below the option.

Was this page helpful? Yes No Submitting... Thank you

Comments