set

Definition

To change the values of an SAP CC system parameter

Command Usage

Syntax

set <PARAM_NAME> <PARAM_VALUE> [<SCOPE> [<INST_TARGETS> ...]]

Command Arguments
Name Description
<PARAM_NAME> The technical name of the system parameter available in the running SAP CC Core Server system or in some specific system instances
<PARAM_VALUE> The value to set up
<SCOPE> Optional: The scope (MEMORY, PERSISTENT, ALL); By default: ALL.
<INST_TARGETS> Optional: The target instances of the command (instance IDs or instance types); By default: All the possible instances for the parameter.

Detailed Information

The set command allows you to change the values of an SAP CC system parameter in the connected SAP CC Core Server system. Depending on the system parameter, you can set up the:

  • runtime value
  • restart value
  • or both values

If you change only the runtime value, the system applies the change immediately but this change is temporary. When the system restarts after maintenance operations or after a general failure, it uses the parameter value just before your change.

The parameter name and the new value must be specified as arguments. You can specify the instances that must change their configuration settings.

Note

Immediate change is possible for few parameters. Refer to the SAP CC System Parameter Reference for more information about the immediate changes of parameters.

You can change a parameter, but you cannot change an indicator.

Use the following scope options depending on your task:

  • ALL (default): Immediate and permanent change of the parameter, include the changes of both the runtime value and the restart value.
  • MEMORY: Immediate and temporary change of the runtime value - The system instance uses immediately the new value. But when it restarts (after a failure, a manual restart, an implementation of a patch or a support package), it will re-use the previous value. You use this option to test the behavior of an instance of the SAP CC system with a different parameter value.
  • PERSISTENT: Deferred and permanent change - The system instance uses the new value only when it restarts.

Example

Type one of the following commands to change both the runtime and restart values of the password set for the SLD user defined for your SAP CC system:

  • Admin+> set SLD_PASSWORD '' ALL ALL

Tip: To improve your user experience, simply type: set SLD_PASSWORD and the SAP CC system will process the command successfully.

Type one of the following commands to change the restart value of the password set for the SLD user:

  • Admin+> set SLD_PASSWORD '' PERSISTENT dispatcher

Syntax

Use the ISO 8601 format (yyyy-MM-ddTHH:mm:ss) to set up a date.

Customizing

You use this command to configure the SAP CC system or to determine the best configuration by testing some parameter values.

Administration

You use this command to change the configuration of the SAP CC Core Server system. Depending on the changed parameter, you configure a business function or a technical function of the SAP CC system.

Troubleshooting Operations (System and User)

You use this command to:

  • enable the log and trace functions
  • test the behavior of the system with a new parameter value that can be changed immediately

Authorization

You must have a specific role in your SAP CC user profile. Refer to the SAP CC Security Guide for more information about the necessary authorizations.

See Also

get - To view the values of an SAP CC system parameter, a parameter list, or indicators
reset - To reset an SAP CC system parameter to its default value (factory settings)

Additional Information

System configuration: Consult the SAP CC System Parameter Reference (SAP site) and the SAP CC Configuration Guide for more information when implementing or operating the systems.

Technical operations: Consult the SAP CC Operations Guide for more information and user assistance.

Messages

Code Message Action
err.missing_parameter Error: This command requires {number} argument(s).  
err.unknown_parameter Error: The parameter "{}" is unknown to the SAP CC system.  
err.unknown_scope Error: The scope "{scope}" is unknown.  
err.bad_targets Error: The target instance "{target}" is bad in the command.  
exception.indicator_notmodifiable Error: The parameter "{parameter}" is not modifiable because it is an indicator.  
exception.indicator_notmodifiable Error: The parameter "{parameter}" is not modifiable because it is an indicator.  
exception.invalid Error: The input for the parameter "{parameter}" is not valid.  
exception.memory_notmodifiable Error: The parameter "{parameter}" is not modifiable in memory.  
exception.persistent_notmodifiable Error: The persistent value of the parameter "{parameter}" is not modifiable.  
exception.unknown Error: The parameter {parameter} is unknown to the SAP CC Core Server system.  
exception.persistent_access Error: It is forbidden to access to the persistent value of an indicator.  
exception.bad_target Error: The target instance "{target}" is bad in the command.  
exception.constraint_violation Error: Constraint violation: invalid value "{}" for parameter "{1}": {2}.  
exception.invalid_persistent_access Error: It is forbidden to modify a persistent value when targeting a specific instance by its ID:  
exception.concurrent_access Error: Concurrent access to the parameter {parameter}.  
parameter.name PARAMETER  
parameter.access ACCESS  
parameter.value.memory MEMORY VALUE  
parameter.value.persistent PERSISTENT VALUE  
parameter.value.default DEFAULT VALUE  
parameter.value.init INITIAL VALUE  
scope.memory MEMORY  
scope.persistent PERSISTENT  
parameter.access.rw Read & Write (RW)  
parameter.access.r Read-Only (RO)  
parameter.value.unset <--Unset-->  
parameter.value.unknown <Unknown>  
parameter.value.hidden <Hidden>