Configuring pconfig settings

/SSM/SYSTEMS/AutoCreateKM

1

Whether the dynamic KMs, which are responsible for the discovery of CCMS parameters, are created automatically. Values are 1 for automatic creation on and 0 for automatic creation off.

/SSM/SYSTEMS/CycleRequest

3

Number of cycles that the product attempts to perform the actions that are controlled by the following parameters:

• MaxContextDiscoveryTimeout
• MaxContextDiscoveryTreeTimeout
• MaxContextGetNonPerfValuesTimeout
• MaxContextGetPerfValuesTimeout
• MaxGetPerfUnitTimeout
• MaxSolmanContextDiscoveryTimeout

/SSM/SYSTEMS/DebugDiscoveryFileName

<full path>

Location of the debug file for discovery traces

/SSM/SYSTEMS/DebugMenuFileName

<full path>

Location of the debug file for menu traces

/SSM/SYSTEMS/DebugParamFileName

<full path>

Location of the debug file for parameter traces

/SSM/SYSTEMS/DiscoveryCollectionInterval

86400

Frequency in seconds for the discovery of SAP systems and CCMS contexts

/SSM/SYSTEMS/DiscoveryDiagnostic

none

Controls the creation of the CCMS Discovery Diagnostics (SSM_DIAGNOSTIC_CONT) application class 
for self-monitoring of the discovery of CCMS data. By default, the CCMS Discovery Diagnostics application 
class is created. To deactivate the creation of this application class, manually create the DiscoveryDiagnostic 
variable and set its value to 0.

/SSM/SYSTEMS/JavaCollectorSuspend

0

Whether the Java Data Collector is suspended 
The following values are available:

• 0 or any number except 1-- Not suspended
• 1-- Suspended

 /SSM/SYSTEMS/javaExecuteArguments

none

Modifies the Java executable command when the Java Data Collector is initiated with the command.
For examples of Java arguments that you can use to troubleshoot problems, see JCo problems impact data collection 
andJava problems impact data collection.

/SSM/SYSTEMS/JavaPath

none

Default path of the Java executable file

 /SSM/SYSTEMS/jcoBitType32

none

( UNIX only, for Java that does not work with 32 bits ) Enables the Java Data Collector to work 
with a 32-bit SAP JCo, when set to a value of 1. For more information, see troubleshooting instructions 
in JCo causes configuration failure on 32-bit UNIX.

/SSM/SYSTEMS/LibPath

none

The path to the lib directory used by the JCo. Specify this path if you want to override the path defined
by system variables, and have set the SetLibPath variable to 1.

/SSM/SYSTEMS/LibPathCommand

none

A system command for setting the path to the lib directory used by the JCo. Use this variable if you 
want to override the path defined by system variables, and have set the SetLibPath variable to 1.

/SSM/SYSTEMS/MaxAvailabilityTimeout

20

Number of seconds to wait for a connection to a SAP system for checking availability

/SSM/SYSTEMS/MaxContextDiscoveryTimeout

40

Number of seconds to wait for successful discovery of CCMS Contexts from SAP systems
that report to the SAP Solution Manager

/SSM/SYSTEMS/MaxContextDiscoveryTreeTimeout

20

Number of seconds to wait for successful discovery of CCMS context trees

/SSM/SYSTEMS/MaxContextGetNonPerfValuesTimeout

360

Number of seconds to wait for successful retrieval of values of non-performance CCMS parameters

/SSM/SYSTEMS/MaxContextGetPerfValuesTimeout

360

Number of seconds to wait for successful retrieval of values of performance-type CCMS parameters

/SSM/SYSTEMS/MaxDebugTimeout

20

Number of seconds to wait for a reply from the Java Data collector, for debug purposes

/SSM/SYSTEMS/MaxGetPerfUnitTimeout

360

Number of seconds to wait for successful retrieval of units of performance-type CCMS parameters

/SSM/SYSTEMS/MaxGetTIDTimeout

120

Number of seconds to wait for successful discovery of transaction IDs

/SSM/SYSTEMS/MaxLogonSleepTimeout

120

Number of seconds to wait for a successful logon to SAP Solution Manager

/SSM/SYSTEMS/MaxReadEmptyInfinityLine

1000

Number of empty lines that the PATROL Agent reads from the Java Data Collector when no data exists

/SSM/SYSTEMS/MaxReadEmptyInfinityWithNewLine

1000

Number of empty lines containing \n that PATROL Agent reads from the Java Data Collector when no data exists

/SSM/SYSTEMS/MaxReadEmptyLine

30

Number of empty lines that PATROL Agent reads from the Java Data Collector when some data exists

/SSM/SYSTEMS/MaxSidDiscoverSleepTimeout

120

Number of seconds to wait for successful discovery of SAP systems

/SSM/SYSTEMS/MaxSolmanContextDiscoveryTimeout

40

Number of seconds to wait for successful discovery of CCMS contexts from the configured SAP system

 /SSM/SYSTEMS/NotAllowedInstCharacters

none

Lists unsupported, locale-specific characters that exist in CCMS Contexts or container nodes below CCMS 
Contexts and must be replaced in PATROL for proper discovery. Specify each character on a separate line. 
For more information, see troubleshooting instructions in CCMS Context with unsupported characters not monitored.

/SSM/SYSTEMS/SetAnnotateForDataCollector

1

Determines whether annotation is set for the Java Data Collector 
Available values are as follows:

• 0-- Disable
• 1 or any number except 0-- Enable

/SSM/SYSTEMS/SetLibPath

0

Whether to set the default path to the lib directory used by the JCo according to either the LibPath
variable or the LibPathCommand variable. Use this variable if you want to override the path defined 
by system variables. Values are 1 for yes and 0 for no.

/SSM/SYSTEMS/SystemList

none

A list of SAP Solution Manager systems configured for monitoring, identified by their labels (one on each line)

/SSM/SYSTEMS/TimeMeasure

none

Controls the creation of two additional instances of the SSM_DIAGNOSTIC_CONT application class for 
self-monitoring of data collection regarding CCMS parameters - one instance for time measurements regarding 
the collection of performance-type parameters and another instance for non-performance parameters. By default, 
these instances of the SSM_DIAGNOSTIC_CONT application class are not created. To create them for
troubleshooting purposes, create the TimeMeasure variable and set its value to 1.

/SSM/SYSTEMS/UseFullDParamName

0

Whether to include the name of the parent CCMS node (as presented in the label of the parent SSM_PARAM_CONT 
instance) in the dynamic name of an application class for a CCMS parameter. The full names of application class 
instances would be:

• Performance-type CCMS parameter:SSM_DPARAM_parentName_parameterName _parameterUnit
• Non-performance CCMS parameter: SSM_DPARAM_parentName _textType_parameterName

Values are 1 for the longer name and 0 for a name without the extra parentNamestring.

 /SSM/SYSTEMS/systemLabel/AnnotateNonPerfValues

0

Whether to include annotated datapoints inccmsNonPerformanceParameterparameters. The annotated datapoints display the message texts for the non-performance CCMS parameters and enable you to maintain a history of textual messages over time. This history is stored in your file system. Values are 1 (active) and 0 (inactive).

/SSM/SYSTEMS/systemLabel / DefaultMonitor

none

The specific CCMS monitor set and CCMS monitor selected for monitoring, as described in Filtering Priority Monitoring by selecting a CCMS monitor.

/SSM/SYSTEMS/systemLabel /DisableSetByTime

1

Whether to display the time stamps of the most recent values measured in the SAP CCMS for performance parameters using the UTC-based SAP time (value of 0 ) or the local PATROL Agent time (default value of 1 ). Create this variable if you want to override the default time stamp display, which is based on the local PATROL Agent time.

/SSM/SYSTEMS/systemLabel /SSMDetails

none

Configuration details defined for the specific SAP Solution Manager system

/SSM/SYSTEMS/systemLabel /SidList

none

A list of SAP systems discovered for the configured SAP Solution Manager system (one on each line)

/SSM/SYSTEMS/ systemLabel / systemLabel|RemovedSID

none

A list of SAP systems removed from monitoring under the specific SAP Solution Manager system

/SSM/SYSTEMS/ systemLabel / systemLabel ! SID|DisabledContext

none

A list of CCMS Contexts under a specific SID for which data collection was disabled

/SSM/SYSTEMS/ systemLabel / systemLabel ! SID|RemovedContext

none

A list of disabled CCMS Contexts under a specific SID that were removed from display

/SSM/SYSTEMS/ systemLabel / SID/MaxRetryDiscoveryOver

none

The maximum number of cycles to wait for the full discovery of CCMS data to complete before the collection of data regarding CCMS parameters can begin. The default number of cycles is 8. To change this value, manually create the MaxRetryDiscoveryOver variable and set it to a different value.

/SSM/SYSTEMS/ systemLabel / SID/
ParameterActivationNonPerfParam

2

Whether to retrieve non-performance CCMS parameters from the SAP Solution Manager for the whole SAP system. Values are 1 for active collection and 2 for no collection.

/SSM/SYSTEMS/ systemLabel / SID/
ParameterActivationNonPerfParam_Active

none

A list of the CCMS contexts for which collection of non-performance CCMS parameters is active (overriding the SID-level configuration).

 /SSM/SYSTEMS/ systemLabel / SID/
ParameterActivationNonPerfParam_Inactive

none

A list of the CCMS contexts for which collection of non-performance CCMS parameters is inactive (overriding the SID-level configuration).

/SSM/SYSTEMS/ systemLabel / SID/
ParameterActivationPerfParam

1

Whether to retrieve performance-type CCMS parameters from the SAP Solution Manager for the whole SAP system. Values are 1 for active collection and 2 for no collection.

/SSM/SYSTEMS/ systemLabel / SID/
ParameterActivationPerfParam_Active

none

A list of the CCMS contexts for which collection of performance-type CCMS parameters is active (overriding the SID-level configuration).

/SSM/SYSTEMS/ systemLabel / SID/
ParameterActivationPerfParam_Inactive

none

A list of the CCMS contexts for which collection of performance-type CCMS parameters is inactive (overriding the SID-level configuration).

/SSM/SYSTEMS/ systemLabel / SID/
PerfParamThreshold_Active

2

Whether to obtain thresholds from the CCMS for performance-type CCMS parameters for the whole SAP system. Values are 1 for active retrieval and 2 for no retrieval.

/SSM/SYSTEMS/ systemLabel / SID/
PerfParamThreshold_ActiveContextList

none

A list of the CCMS contexts for which retrieval from the CCMS of thresholds for performance-type CCMS parameters is active (overriding the SID-level configuration)

/SSM/SYSTEMS/ systemLabel / SID/
PerfParamThreshold_InactiveContextList

none

A list of the CCMS contexts for which retrieval from the CCMS of thresholds for performance-type CCMS parameters is inactive (overriding the SID-level configuration)

 /SSM/SYSTEMS/ systemLabel / SID /SAPVersion

none

The SAP Basis version of the discovered SAP system. This pconfig variable is required only for discovered SAP 7.30 systems, due to changes introduced into SAP Basis 7.30. You must create it manually for each discovered SAP 7.30 system, and set its value to 730. This pconfig variable enables the successful monitoring of external availability of SAP 7.30 systems. For more information, see troubleshooting information in Availability monitoring fails on SAP 7.30 systems.

/SSM/SYSTEMS/ systemLabel / SID/
WaitForSidDiscCompletedPct

none

The percentage of SAP system discovery that must complete before the collection of data regarding CCMS parameters can begin. The default percentage is 100%. To change this value, manually create the WaitForSidDiscCompletedPct variable and set it to a different value.

/SSM/SYSTEMS/ systemLabel / SID/
WaitForContextDiscCompletedPct

none

The percentage of CCMS Context discovery that must complete before the collection of data regarding CCMS parameters can begin. The default percentage is 100%. To change this value, manually create the WaitForContextDiscCompletedPct variable and set it to a different value.

/SSM/SYSTEMS/ systemLabel / SID/
WaitForContextTreeDiscCompletedPct

none

The percent of discovery of CCMS context tree nodes that must complete before the collection of data regarding CCMS parameters can begin. The default percentage is 90%. To change this value, manually create the WaitForContextTreeDiscCompletedPct variable and set it to a different value.

/SSM/SYSTEMS/ systemLabel / SID/PIMonitoring/PIAdminUser

none

Details of the configured connection to the System Landscape Directory (SLD) for obtaining SAP PI system data, as described in Configuring the monitoring of an SAP PI system

/SSM/SYSTEMS/ systemLabel / SID/PIMonitoring/PIProtocol

none

/SSM/SYSTEMS/ systemLabel / SID/PIMonitoring/RWBUser

none

/SSM/SYSTEMS/ systemLabel / SID/PIMonitoring/SLDHost

none

/SSM/SYSTEMS/ systemLabel / SID/PIMonitoring/SLDPort

none

/SSM/SYSTEMS/ systemLabel / SID/PIMonitoring/SLDProtocol

none

/SSM/SYSTEMS/ systemLabel / SID/
PIMonitoring/DisableBussinessSystem

none

Options for disabling the monitoring of specific types of SAP PI components at a specific SAP PI system. Create such variables if you do not want to monitor certain types of SAP PI components, and set each variable to a value of 1. The range of values for these variables is: 1 for disable and 0 forenable.

/SSM/SYSTEMS/ systemLabel / SID/
PIMonitoring/DisableIntegrationDirectory

none

/SSM/SYSTEMS/ systemLabel / SID/
PIMonitoring/DisableIntegrationMappingRuntime

none

/SSM/SYSTEMS/ systemLabel / SID/
PIMonitoring/DisableIntegrationRepository

none

/SSM/SYSTEMS/ systemLabel / SID/
PIMonitoring/DisableIntegrationServer

none

/SSM/SYSTEMS/ systemLabel / SID/
PIMonitoring/DisableJ2EEAdapterFramework

none

/SSM/SYSTEMS/ systemLabel / SID/
PIMonitoring/DisableJ2SEAdapterFramework

none

/SSM/SYSTEMS/ systemLabel / SID/
PIMonitoring/DisableSLD

none

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /AltHost

none

Alternative connection details to the host of SAP PI components. Create this folder and variables if you need to override the discovered host details (for example, if the true host is located behind a firewall). For more information, see troubleshooting instructions in SAP PI components discovered but cannot be accessed.

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /AltPort

none

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /AltProtocol

none

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /AltUser

none

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /AltPass

none

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /Pipeline/AltHost

none

Alternative connection details for the pipelines of the SAP PI Integration Server. Create this folder and variables if you need to override the discovered details (for example, if the pipelines listen to a port that differs from the port of the Integration Server). For more information, see troubleshooting instructions in SAP PI components discovered but cannot be accessed.

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /Pipeline/AltPort

none

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /Pipeline/AltProtocol

none

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /Pipeline/AltUser

none

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /Pipeline/AltPass

none

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /AEStatusList

all available statuses

Option for disabling and enabling the monitoring of messages of certain statuses from a specific Adapter Engine. By default, all message statuses are monitored and analyzed for compliance with the various filters that you define. The default value of this pconfig variable includes all available statuses, as listed below: 
TBDL|ToBeDelivered 
DLNG|Delivering 
NDLV|NotDelivered 
FAIL|Failed 
WAIT|Waiting 
HOLD|Holding Use this pconfig variable to remove the message statuses that you are not interested in. Messages with the statuses that you remove are not analyzed for compliance with defined filters. To subsequently return to the default of all statuses, empty the value of all statuses.

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /DisableMsgFilter

none

Option for disabling the monitoring of messages for the specific SAP PI component (Integration Server, Business System, or Adapter Engine). Create this variable if you do not want to monitor messages for this component, and set the variable to a value of 1. Range of values: 1 for disable and 0 forenable.

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /ScanBackMinInterval

5 minutes

The number of minutes to scan back for message data from this SAP PI component (Integration Server, Business System, or Adapter Engine). Create this variable if you want a value that differs from the default 5 minutes.

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /Filters/FilterList

none

A list of message filters defined for this SAP PI component (Integration Server, Business System, or Adapter Engine).

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /Filters/ filterName / filterCriterion

none

The value defined for each of the filter criteria for monitoring of messages from the specific SAP PI component.

/SSM/SYSTEMS/ systemLabel / SID /
PIMonitoring/componentName /Filters/ filterName / filterCriterionOper

none

The operator chosen for comparison of the values of each of the filter criteria with the corresponding message attribute in messages from the specific SAP PI component. Values are 1 for contains or 2 forequals.

/SSM/SYSTEMS/ systemLabel / SID / ccmsContexts... (multiple) / ccmsParameter /EventAlertData or /SSM/SYSTEMS/NonPerf/ ccmsContexts... (multiple) /ccmsParameter /EventAlertData

none

A list of conditions configured to raise alarm-level events in PATROL Event Manager for the specific non-performance CCMS parameter. Each condition (on a separate line) is identified by a combination of comparison operator and textual string. The path to this variable depends on whether the event was configured for a specific SAP system or was applied to all SAP system instances.

/SSM/SYSTEMS/ systemLabel / SID / ccmsContexts... (multiple) / ccmsParameter /EventWarnData or /SSM/SYSTEMS/NonPerf/ ccmsContexts... (multiple) /ccmsParameter /EventWarnData

none

A list of conditions configured to raise warning-level events in PATROL Event Manager for the specific non-performance CCMS parameter. Each condition (on a separate line) is identified by a combination of comparison operator and textual string. The path to this variable depends on whether the event was configured for a specific SAP system or was applied to all SAP system instances.

/SSM/SYSTEMS/ systemLabel / SID / ccmsContexts... (multiple) / ccmsParameter /EventOptions or /SSM/SYSTEMS/NonPerf/ ccmsContexts... (multiple) /ccmsParameter /EventOptions

none

Whether events for the specific non-performance CCMS parameter are generated repeatedly for consecutive occurrences of the same CCMS paramter that contain the same message (as controlled by the Consistentcheck box in the Alert Configuration dialog box). Values are 1 for consistent repeats, and 0 for no repeats. The path to this variable depends on whether the event was configured for a specific SAP system or was applied to all SAP system instances.

/SSM/SYSTEMS/ systemLabel / SID/ITEvents/AbapDumps/SapVersion

SAP Version as 640, 700

The version of connected SAP system, help to determine how parsing of the dump as text.

/SSM/SYSTEMS/ systemLabel / SID/Availability/AltJ2EEPort

Valid SAP port

Creates SAP external availability for complex SAP environment that is not automatically discovered by the KM.

/SSM/SYSTEMS/ systemLabel /ActiveList

List of SAP SIDs to be monitored divided by /n

/SSM/SYSTEMS/ systemLabel / SID /ActiveList

List of monitoring Contexts to be monitored divided by /n

/SSM/SYSTEMS/ systemLabel / SID / ccmsContexts/ActiveList

List of active parameter contexts to be monitored divided by /n

/SSM/SYSTEMS/ systemLabel /RemovedSID

List of SAP SIDs that are not to be monitored divided by /n

/SSM/SYSTEMS/ systemLabel / SID /RemovedContext

List of monitoring contexts that are not to be monitored divided by /n

/SSM/SYSTEMS/ systemLabel / SID/ccmsContexts/RemovedParameters

List of active parameters that are not to be monitored divided by /n

/SSM/SYSTEMS/ systemLabel/DefaultDiscoveredObjects

1, 2 
1-create (active list) 
2-do not create (removed list)

The new discovered SAP SIDs will be added to the active or inactive list. 
The new discovered SAP SIDs are added to the active list by default.

/SSM/SYSTEMS/ systemLabel / SID/DefaultDiscoveredObjects

1, 2 
1-create (active list) 
2-do not create (removed list)

The new discovered monitoring Contexts will be added to the active or inactive list. 
The new discovered monitoring Contexts are added to the active list by default.

/SSM/SYSTEMS/ systemLabel / SID /
ccmsContexts/DefaultDiscoveredObjects

1, 2 
1-create (active list) 2-do not create (removed list)

The new discovered parameters will be added to the active or inactive list. 
The new discovered parameters are added to the active list by default.

/SSM/SYSTEMS/ SID /ApplServerCheckType /SSM/SYSTEMS/ApplServerCheckType

STANDARD EXCEPTIONAL (by default) RFC_ONLY

The extent of the availability check. Maintained as general value for all SAP SID, or for a single SAP SID.

/SSM/SYSTEMS/ SID /MaxApplServerAvailTimeout /SSM/SYSTEMS/MaxApplServerAvailTimeout

60 seconds

The timeout period for ABAP Processes and Availability BAPI response. This pconfig parameter can be used as a general value for all the SAP SIDs or for a single SAP SID.

/SSM/SYSTEMS/ SID /MaxAvailabilityTimeout /SSM/SYSTEMS/MaxAvailabilityTimeout

20 seconds

The timeout period for J2EE status, SAP Aborted Updates, and ABAP Dumps. This pconfig parameter can be used as a general value for all the SAP SIDs or for a single SAP SID.

/SSM/SYSTEMS/ SID /MaxJobsTimeout /
SSM/SYSTEMS/MaxJobsTimeout

20 seconds

The timeout period for SAP System Job Collector. This pconfig parameter can be used as a general value for all the SAP SIDs or for a single SAP SID.

/SSM/SYSTEMS/ SID /ApplServerAvailTimeout /SSM/SYSTEMS/ApplServerAvailTimeout

60 seconds

The timeout period for R3Server_Availibility command timeout response. This pconfig parameter can be used as a general value for all the SAP SIDs or for a single SAP SID.

/SSM/SYSTEMS/ systemLabel / SID /Availability/appSrvName /J2EEHost /SSM/SYSTEMS/systemLabel / SID /Availability/ appSrvName /J2EEPort /SSM/SYSTEMS/ systemLabel / SID /Availability/appSrvName /J2EEPath /SSM/SYSTEMS/systemLabel / SID /Availability/ appSrvName/J2EEProtocol

none

This pconfig parameter to bypass the connection details when the http availability call returns the following message: host not reached message

/SSM/SYSTEMS/ systemLabel/UseIdForLongInstanceNames Or /SSM/SYSTEMS/systemLabel / SID /UseIdForLongInstanceNames

1

This pconfig parameter generates a unique instance name BMCIDxxxx, when the metric path is more than 127 characters long.

/SSM/ systemLabel /ForceDiscOnStartup 
/SSM/ systemLabel /J2eeForceDiscOnStartup 
/SSM/SYSTEMS/R3ForceDiscOnStartup

0

When the SAP System, ABAP Stack, or J2EE Stack is restarted, the discovery collector does not always check the occurrence of the discovery cycle. These pconfig parameters control the force discovery based on the external availability status.