Using agentpref
Parameters | Use to... |
|---|---|
--host | Hostname of the agent machine where the MVMM Extensible Agent (qpea) is running. Required unless specified in an eaapi.ini file or agent on the same machine. |
--port | Optional. Port number for the MVMM Extensible Agent. Defaults to 2612 or as specified in an eaapi.ini file. |
--set-agent (pref_name value)* | Optional. You can have one or more set command, each with one or more preferences. |
--set-agent-dynamic (pref_name)* | Optional. Set one or more dynamic preferences for the MVMM Extensible Agent. More than one --set-agent-dynamic can be specified. |
--set-agent RTServer_Port <port number> | Enables you to modify the port number. <port number> is the port number of the RTServer in your installation. |
-set extension_name [-pref_path type_path name_path] (pref_name value)* | Optional. You can have one or more set command, each with one or more preferences. -–pref_path defaults to Default\Default if not specified. type_path has the format of type_path1!type_path2!... name_path has the format of name_path1!name_path2!... The preference path consists of a type path and name path but they aren't the same thing as the type and instance path used to identify objects in the Object Repository but are similar. The type path and name path have the same number of elements delimited by the exclamation point. Together the paths identify a set of preferences that apply to an object and any children. If no preference path is provided, preferences are added to the "Default" level. Further levels are defined by adding a type name to the "Default" type path, for example "Default!ComMQSoftwareWebSphereMQQueueManager" and an object name of that type to the name path, for example "Default!MyQueueManager". An example is to set the SampleInterval at the "Default" level so all queue managers publish using the same sample interval but specify other preferences such as connection preferences per queue manager. |
-set-dynamic extension_name [-pref_path type_path name_path] (pref_name value)* | Optional. Use with extreme care because names are not validated. Set one or more preferences for specified extension where the extension is new and not known to the utility or where the preference name is dynamic or unique to the environment rather than a well-known value listed by --list-preferences. More than one --set_dynamic can be specified. -–pref_path defaults to Default\Default if not specified. type_path has the format of type_path1!type_path2!... name_path has the format of name_path1!name_path2!... |
--get-agent | Optional. Displays currently set preferences for the MVMM Extensible Agent. |
--get extension_name | Optional. Displays currently set preferences for the named extension. |
--notify extension_name | Optional. Notifies specified extension to get preferences. |
--list-preferences | Optional. List the preferences that can be set. |
--version | Optional. Print the version information. |
--export filename | Optional. Export the agent and extension preferences to file name. |
--import filename | Optional. Import the agent and extension preferences from file name. |
--remove-agent (pref_name)* | Optional. Remove one or more preference for the MVMM Extensible Agent. You can have one or more --remove-agent command, each with one or more preferences. |
--remove-agent-dynamic (pref_name)* | Optional. Remove one or more dynamic preferences for the MVMM Extensible Agent. More than one --remove-agent-dynamic can be specified. |
-remove extension_name [-pref_path type_path name_path] (pref_name)* | Optional. Remove one or more preferences for the specified extension. You can have one or more remove commands, each with one or more preferences. -–pref_path defaults to Default\Default if not specified. type_path has the format of type_path1!type_path2!... name_path has the format of name_path1!name_path2!... |
-remove-dynamic extension_name [-pref_path type_path name_path] (pref_name)* | Optional. Use with extreme care because names are not validated. Remove one or more preferences for specified extension where the extension is new and not known to the utility or where the preference name is dynamic or unique to the environment rather than a well-known value listed by --list-preferences. You can have one or more remove-dynamic commands, each with one or more preferences. -–pref_path defaults to Default\Default if not specified. type_path has the format of type_path1!type_path2!... name_path has the format of name_path1!name_path2!... |
--set-remote-qmgr-csv filename | Add remote connection definition from a CSV file. |