postprocesssvc command

Purpose

Performs actions on agents after the agent is started by the startsvc command.

Syntax

postprocesssvc AgentName { -attr Attribute[=Value] ... | -ls }

Description

The postprocesssvc command performs actions for an agent based on the set of attributes specified for the command.

Flags

Flag name	Description
-attr	Lists actionable agent options, which can be any of the following attributes: D Generates the stats.send file from the specified date. A value of 0 (zero) specifies to generate data.send from all the available data files. S Prints the absolute path to the stats.send file. A Lists all the stats files in data directory, except the stats.send file. V Prints the version.
-ls	Lists the attributes that can be processed.

perfmgr

The performance manager agent (perfmgr) collects data about system performance and sends it to IBM® support with the Electronic Service Agent™ (ESA) agent for processing.

When the agent is started, it runs a set of utilities to collect metrics to measure performance. This command generates a file from the list of available individual performance data files that the ESA agent can understand.

The list of available attributes for this agent is D, S, A, and V.

IBM License Metric Tool

Performs additional operations on IBM License Metric Tool (ILMT) after the initial configuration with cfgsvc command. The additional operations, which are performed are changing ILMT server, setting port number, and security level.

Attributes

Attribute	Description
capture	Copies all the agent trace, message, and configuration files to the <tivoli_common_dir>\ffdc\agent subdirectory under the Tivoli® Common Directory. These files are available for remote support analysis.
clone	Prepares the agent to be cloned together with the operating system image for serial deployment. The command performs various actions as follows: It stops the agent if it is running. It removes the agent cache and all the data prepared to be uploaded to the server. It removes the agent traces. It replaces the agent ID in the tlmagent.ini file with %AGENT_ID string.
cmds	Displays the most important information about the schedule of the commands in the standard output. The command displays the information as follows: The commands that are currently active. The current period of each command. The time of the last command execution for each command. The planned time of the next command execution for each command. The end of the schedule for a given command.
i	Installs the agent as a service.
impcert=<filename.kdb>:<cms_password>	Imports the agent CMS certificate and the associated private key from the location provided. The required cms_keystore file is the file \outputdirectory\organization_name\cms\agent_id.kdb created by the convertcertificate command during the agent authentication process. The required cms_password is the corresponding CMS password.
p	Plugs into the Asset Discovery for Distributed server. The agent must be active and the task is performed immediately.
r	Removes the agent service from the Services list.
reload	Reloads the agent configuration file and restarts the trace by using the new configuration. The agent must be active.
s	Runs an inventory scan. The result of the scan is sent to the server in a scheduled agent-server communication time window. The agent must be active. This option requests that the scan task be run as soon as possible by the agent.
set=<property_name>:<property_value>	Sets custom data or modifies other properties in the tlmagent.ini file
sslreload	Reloads the security settings from the agent configuration file and attempts to import the private certificate file from the default location by setting the security level to 2 (MAX) and agent ID to the one specified in the private certificate file. This option is valid only if the 0 (MIN) is not used.
v	Displays the agent version.

Exit Status

Return code	Description
0	The command completed successfully
>0	An error occurred.

Examples

To list the available attributes for the perfmgr agent, type the command as follows:
```
postprocesssvc perfmgr -ls
```
To generate the stats.send file from the data available on 06/14/2006, type the command as follows:
```
postprocesssvc perfmgr -attr D=20090614
```
To generate the stats.send file from the data available, type the command as follows:
```
postprocesssvc perfmgr -attr D=0
```
To list the all the stats files in the data directory, type the command as follows:
```
postprocesssvc perfmgr -attr A
```
To print the absolute path to the stats.send file, type the command as follows:
```
postprocesssvc perfmgr -attr S
```
To print the version, type the command as follows:
```
postprocesssvc perfmgr -attr V
```

ILMT

To reload the agent configuration file, type the command as follows:
```
postprocesssvc ILMT  -attr reload
```
To check whether the agent plugs in to the server, type the command as follows:
```
postprocesssvc ILMT  -attr p
```
To perform an inventory scan, type the command as follows:
```
postprocesssvc ILMT  -attr s
```

Related Information

The startsvc command and the stopsvc command.

Last updated: Wed, November 18, 2020