Controlling the collector via operator commands
The C\Prof collection server can be managed via z/OS MVS system commands MODIFY and STOP (or F and P respectively). The MODIFY command is used to pass information to a started job or task. The STOP command is used to shut down the collector.
The following table describes several common scenarios and how you might use MVS system commands to control the collector. In the following table, substitute collector with your collector's job name and optional identifier. For commands that require a CICS region name or group, use the names defined in your collector's configuration file.
Operator commands that may be used to control the collector
|Shut down the collector. All recording stops.|
|MODIFY collector,START,ALL||Start recording for transaction profiling for all CICS regions defined in the configuration file.|
|MODIFY collector,START,name||Start recording for transaction profiling for a specific CICS region, group, or name pattern. The name must match a name defined in your collector's configuration file using the CICS or GROUP control statement (see GROUP=name and GROUPEND), or it may match multiple CICS regions and groups using a wildcard pattern such as CICS*.|
|MODIFY collector,SNAP,name /* optional comment||Take a snapshot of a specific CICS region, group, or name pattern. The name can be the job name of a CICS region, the name of a group of CICS regions (defined using a GROUP control statement, see GROUP=name and GROUPEND) or a wildcard pattern such as CICS* to match multiple CICS regions. When specifying a CICS region job name, the regions do not need to be defined in the C\Prof collection server's configuration file and can be any CICS region running in the same LPAR as the collector. The optional comment is echoed in the collector job log.
Use this operator command with your automation tools to automatically trigger a C\Prof snapshot when problems are detected in CICS. For more information, see Automatic problem capture with event-driven snap
|MODIFY collector,STOP,ALL||Stop recording for all CICS regions defined in the configuration file.|
|MODIFY collector,STOP,name||Stop recording for a specific CICS region or group. The name must match a name defined in your collector's configuration file using the CICS or GROUP control statement (see GROUP=name and GROUPEND), or it may match multiple CICS regions and groups using a wildcard pattern such as CICS*.|
|MODIFY collector,RESTART||Quiesce all active collection tasks and restart the collector. All recording stops. Use RESTART to introduce a new or updated configuration.|
|MODIFY collector,STATUS||Issue status message TXC0512I to SYSPRINT, followed by a list of the CICS regions defined in the configuration file. For each CICS region, STATUS provides the status of active monitoring and collection, as well as any options that are in effect.|
The following commands are for diagnostic purposes and should only be used if instructed to by Circle Software product support.
Operator commands that may be used to collect diagnostic information
|MODIFY collector,HEARTBEAT||Diagnostic command only.
Issue heartbeat message TXC0305I to SYSPRINT for each CICS region that is actively being monitored. The message provides a summary of how the CICS internal trace is being processed by the collector.
|MODIFY collector,DUMP||Diagnostic command only.
Dump monitoring information to a sysout data set. When the dump is complete, message TXC0515I is issued to SYSPRINT containing the DD name of the sysout data set.