Skip to Content
Information

This site will undergo a brief period of maintenance on Friday, 18 December at 12:30 AM Central/12:00 PM IST. During a 30 minute window, site availability may be intermittent.

Information
Newer version of documentation BMC provides a newer version of the documentation for this version of the product. As a result, BMC no longer accepts comments in this space.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see bao8301.

IMFC SET MOD=MTRAC | ATRAC

This command uses IMFC SET MOD=MTRAC | ATRAC to modify a trace that is running for 

BMC AMI Ops Monitor for IMS

, 

BMC AMI Ops Monitor for CICS

, or 

BMC AMI Ops Monitor for Db2

.

Command

Parameters

IMFC SET MOD=MTRAC|ATRAC

traceid

TARGET=ttttttttt

STOPCNT=nn

SWITCH

The following table describes the parameters:

Parameter

Function

Notes

MOD=MTRAC

Modifies a trace for an IMS object that is being monitored

n/a

MOD=ATRAC

Modifies a trace for a DB2 or CICS object that is being monitored

n/a

traceid

Is the ID of the trace that is to be modified

This value is required.

TARGET=

Is the name of the target that is to be modified

This value is required.

STOPCNT=

Is the number of minutes after which the trace will stop

This value is a decimal number between 1 and 99 and is a required value when the SWITCH option is not specified.

SWITCH

Is the action to request a switch of the trace log data set for the trace

This value is optional and can be specified with the STOPCNT parameter.

For this parameter to work, you must have a license for one of the following solutions:

  • BMC AMI Ops for CICS
  • BMC AMI Ops for Db2
  • BMC AMI Ops for IMS

Condition codes are listed in the following table:

IMFCC value

IMFRC value

Description

0

0

Command was executed successfully.

8

0

One of the following situations occurred:

  • TARGET= is missing.
  • An error in the monitor or analyzer service occurred (Msg PM0334E issued).
  • Syntax error occurred in SET command (Msg PM0337E issued).

8

8

Failed because the named trace could not be found.

16

0

Handling program was not found.

20

0

License for a solution was not found.

Examples

This example shows using the IMFEXEC IMFC MOD=MTRAC command to cause an IMS trace named TRC0001 for target database named PRIMEDB to  be stopped after the next one minute interval.

/*REXX*/
"IMFEXEC IMFC SET MOD=MTRAC TRC0001 TARGET=PRIMEDB STOPCNT=1"

This example shows using the IMFEXEC IMFC MOD=ATRAC command to cause a CICS trace named TRC0001 for target region TESTCICS to be stopped after the next one minute interval.

/*REXX*/
"IMFEXEC IMFC SET MOD=ATRAC TRC0001 TARGET=TESTCICS STOPCNT=1"

This example shows using the IMFEXEC IMFC MOD=ATRAC command to cause a CICS trace named TRC0001 for target region TESTCICS to effect a switch of the trace log data set.

/*REXX*/
"IMFEXEC IMFC SET MOD=ATRAC TRC0001 TARGET=TESTCICS SWITCH"

Related topic

Using-the-IMFEXEC-statements


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Ops Automation 8.3