Handling Process Chains

You previously imported the definition of a process chain to be able to maintain restart-related properties of the process chain within Redwood Server. These properties are available on the Maintain Object dialog of the SAP system inside Redwood Server.

Using SAP_BW_MaintainProcessChainDefinition

The SAP_BW_MaintainProcessChainDefinition Process Definition allows you to modify process chain properties relating to restability.

SAP_BW_MaintainProcessChainDefinition Parameters

Parameter Description Direction Data Type Default Expression Default List of Values
SAP_SYSTEMS SAP System In String

PCHAIN_NAME Technical name of the SAP BW Process Chain In String

BW_PROCESS_TYPE Type of the SAP BW process In String

BW_PROCESS_VARIANT Variant (name) of the SAP BW process In String

BW_MAX_RESTARTS Number of automatic restarts on error In Number

BW_RESTART_DELAY Delay needed to restart. In Number 10

BW_RESTART_DELAY_TIME_UNIT Unit of the delay (seconds or minutes) In String M(Minutes) M (Minutes) S (Seconds)
BW_RESTART_UNCHECKED Restart unchecked In String

BW_ERROR_PROCESS_TYPE Type of the SAP BW process to restart on error In String

BW_ERROR_PROCESS_VARIANT Variant (name) of the SAP BW process to restart on error In String

See table below for the settings that can be modified.

Using Maintain Objects on the SAP System

A dialog is available to allow you to change the process Chain Definition. In the SAP systems overview you see a list of all connected SAP systems you can access. You expand an SAP system to see one or more of the following groups:

  • ABAP Programs - lists all imported ABAP programs
  • Application Server - lists all application servers
  • Process Chains - lists all imported BW/BI process chains
  • Mass Activities - lists all imported IS mass activities
  • Languages - lists all languages

In the context menu of the SAP system, the Maintain Objects action opens an editor where you can modify process Chain Definitions.

The process chains are ordered by technical name/description; process chains for which you have imported the definition can be expanded in this overview. The processes of the process chain are listed by Process Type Name/Variant/Process Type; for each you can set the restart behavior.

Field Description
Process Variant Description The description of the variant in SAP
Process Type The process type as defined in SAP
Process Variant The technical name of the variant; as defined in SAP
Max Number Of Restarts Allows you to specify the maximum number of automatic restarts that Redwood Server can perform on the process chain
Restart Delay Allows you to specify a delay between automatic restarts, to allow you to fix the issue
Restart Delay Units Used in combination with Restart Delay; the units of time to use for the delay
Restart Unchecked Allows you to override the restart behavior in SAP; your chain is only repeatable in SAP BW and you are sure you can repair the problem, set this to Yes
On Error Process Type Allows you to specify a process type and variant to start when this process chain fails
On Error Process Variant Used in combination with On Error Process Type; allows you to choose a variant for the previously selected process type.

Note: If you import process chains as Process Definitions, the startup behavior will be read from the parameters and not from the SAP System.

Process Chain Process Definitions

When you import a process chain as a Process Definition, you set the restart ability of the process chain in the CHAIN_RESTARTABLE parameter.

  • N - process chain is not restartable
  • F - failed processes can be restarted; this is equivalent to repairable process chain in SAPGui
  • A - process chain can be fully restarted; this is equivalent to repeatable process chain in SAPGui

Sending Spool Files to Financial Closing Cockpit

You can make all output of the process chain available in Financial Closing Cockpit (FCc) by specifying the parameter SAP_APPSAPI_CHAIN_GET_OUTPUT.

This parameter accepts two values:

  • A - to be set on the parent Process Definition of the process chain; will force all output to be available in FCc.
  • M - to be set on the parent Process Definition and the child Process Definition of which you want the output.

See Also