SAP CPS Troubleshooting Guide · SAP CPS Troubleshooting Guide ... 1

SAP CPS Troubleshooting Guide

Version M33.58-58052

Table of Contents1. New Features ......................................................................................................................................... 1

New Features in M33 .......................................................................................................................... 1Sybase Adaptive Server Enterprise Support ..................................................................................... 1Parameter Value Changes Update Submit Wizard ............................................................................. 1New Global Privileges ................................................................................................................ 1Out Parameters are now Set even if the job did not Reach Status Completed .......................................... 1Job Chain Calls Restricted to a Time Window .................................................................................. 1Low Volume Licensing now available ............................................................................................ 1Partial Job File Retrieval .............................................................................................................. 2Financial Process Automation (FPA) .............................................................................................. 2Job Data Archiving ..................................................................................................................... 2IgnoreApplicationReturnCode Registry Keys and Parameters ............................................................. 2New Scorecard for Historical Data ................................................................................................ 2Store Documentation in SAP CPS Documents ................................................................................. 2Better Unattended Install Support for Platform Agents ...................................................................... 3Maximum Restarts and Restart Delay for Job Chain Steps ................................................................. 3Lenient Flag for DateTimeZone .................................................................................................... 3SAP Business Automation Enabler (BAE) Connectors / SAP Inbound .................................................. 3Job Forecasting .......................................................................................................................... 3

New Features in M31 .......................................................................................................................... 4Archiving with the new Archive Server .......................................................................................... 4SAP Module ............................................................................................................................. 4Mail Module ............................................................................................................................. 4Oracle Applications Scheduling .................................................................................................... 4Suppress License Expiration Warning ............................................................................................ 4Customize the Navigation Bar ...................................................................................................... 4

New Features in M28 .......................................................................................................................... 4Import Jobs and Clusters ............................................................................................................. 4New Object Filter Conditions ....................................................................................................... 5Query Filter Parameter Constraints ................................................................................................ 5Improved Security with sudo ........................................................................................................ 5Source Code Fields are Resizable .................................................................................................. 5New Reporting Functionality ........................................................................................................ 5Submit Frames Now Offer a Preview ............................................................................................. 5Platform Agent Network Timeout .................................................................................................. 5Fail-over Timeouts ..................................................................................................................... 5Permalink Module ...................................................................................................................... 6Links in Documentation Fields ..................................................................................................... 6SAP SNC Support ...................................................................................................................... 6Advanced Auditing Rules ............................................................................................................ 6Advanced Search for all Objects ................................................................................................... 6Easy Retrieval of Process Server Logs ............................................................................................ 6Controlling Communication Channels with SAP PI .......................................................................... 6

New Features in M26 .......................................................................................................................... 6SAP Applications API Integration ................................................................................................. 7Mail Job Definition Type ............................................................................................................. 7Period Functions ........................................................................................................................ 7Reports .................................................................................................................................... 7Credentials ............................................................................................................................... 7Dashboard ................................................................................................................................ 7Library and Triggers ................................................................................................................... 7Isolation groups ......................................................................................................................... 7

iii

2. Release Notes ............................................................................................................................ 8Most Important Release Notes .................................................................................................. 8

AS/400: JobAppend is Appended twice if set ....................................................................... 8Sybase Adaptive Server Enterprise Support ......................................................................... 8Reverting from a Chargeable to a Free of Charge Version ....................................................... 8"[Non production use only]" in Application Title Unless Supported DB is Used ......................... 8Redwood Platform and Oracle Prerequisites ........................................................................ 8Tablespace Usage - Upgrading from Version 7 ..................................................................... 9Change in IntelliSearch Prefixes ....................................................................................... 9Change in Time Windows with Offsets ............................................................................. 10Run As Fields and Special Characters in Passwords ............................................................ 10

New MASS_ACTIVITY_DATE_SHIFT Behavior ...................................................................... 10Improved Support for DBMS_OUTPUT ................................................................................... 10Changes in Tables ................................................................................................................. 10Redwood Platform: Redwood Messaging Replaces JMS .............................................................. 11Out Parameters Set even when Job Fails ................................................................................... 11Importing Large CAR Files Can Cause OOME's ........................................................................ 11Navigation Bars in Partitions other then GLOBAL ...................................................................... 11Using Credentials with FTP Job Definition Types ....................................................................... 12Report job gives NPE if parameter OutputFormat is not available .................................................. 12Importing Multiple SAP Jobs with Identical Names .................................................................... 12Jobs Stay in Status PreRunning or PostRunning ......................................................................... 12Runtime Expiration Calculations have been moved to separate threads ........................................... 12Importing SAP System Objects ............................................................................................... 12SAP CPS and other SAP Software ........................................................................................... 13FileInUseCommand Process Server Parameter Changed Default Value on Unix ................................ 13SAP Application Return Codes ............................................................................................... 13Killing RedwoodScript Jobs ................................................................................................... 14Upgrading from M28 ............................................................................................................ 14

Active Monitoring Module ............................................................................................. 14Pre-submit Count ......................................................................................................... 14Impacts Recurrences ..................................................................................................... 14

Job Chain Job Restart ............................................................................................................ 14SQL Server Deadlocks .......................................................................................................... 14Job Chain Status ................................................................................................................... 15Preconditions ....................................................................................................................... 15Job Run Order Change .......................................................................................................... 15OnChange Trigger ................................................................................................................ 16Supported Browsers .............................................................................................................. 16

Firefox 3.6 and Java Plugins ........................................................................................... 16System-wide and Partition-wide Keep Clauses ........................................................................... 16Time Windows and the Custom Library .................................................................................... 21Debian-based Systems and Java Networking .............................................................................. 16Import Jobs and Clusters ........................................................................................................ 17Pre-Submitting many Jobs ...................................................................................................... 17Halloween ........................................................................................................................... 17SQL Server JDBC Driver Settings ........................................................................................... 17SAP Interception .................................................................................................................. 18Statistics and big Repositories ................................................................................................. 18Recurrences Converted to Submit Frames ................................................................................. 18Gantt Chart ......................................................................................................................... 19JVM Time Zone Settings ....................................................................................................... 19HTTP Worker Threads .......................................................................................................... 19Oracle Globalization Support .................................................................................................. 19Restart Behavior Change ....................................................................................................... 19

iv


RestartCount is not Always Decremented .................................................................................. 20SAP Clients Require Time Zone Data ....................................................................................... 20File Event Move Directories ................................................................................................... 20Default Pagesize on DB2 is insufficient on non-NetWeaver Systems .............................................. 20Queues, Time Windows and Time Zones ................................................................................... 20Platform Agent Network Timeout ............................................................................................ 20Fail-over Timeouts ................................................................................................................ 21File:// links and Mozilla Firefox .............................................................................................. 21Time Windows and the Custom Library .................................................................................... 21Wildcards in Auto-Complete Fields .......................................................................................... 22Shell .................................................................................................................................. 22Transport Files ..................................................................................................................... 22Changing the SAP System of a Job with Default Queue ............................................................... 22SAP Notes .......................................................................................................................... 22Upgrade Issues .................................................................................................................... 22

Upgrading from 26 ....................................................................................................... 22SAP Job Definitions ...................................................................................................... 22SAP Job Names ........................................................................................................... 23Application Renames .................................................................................................... 23

Platform Agents on GNU/Linux .............................................................................................. 23Platform Agents on Tru64 ...................................................................................................... 23SAP CPS on GNU/Linux ....................................................................................................... 24

3. Troubleshooting Connections to SAP Systems ................................................................................ 25Use .................................................................................................................................... 25

Setting the Audit Level .................................................................................................. 25Inspecting the Log ........................................................................................................ 25Performance Problems .................................................................................................. 25

Enabling XMI Logging to Troubleshoot Issues ........................................................................... 25Use ............................................................................................................................ 25Procedure ................................................................................................................... 26

Setting the Log Level and Inspecting Log Files in SAP NetWeaver ................................................ 26Use ............................................................................................................................ 26Prerequisites ................................................................................................................ 27Procedure ................................................................................................................... 27See Also ..................................................................................................................... 28

Inspecting Log Files in Redwood Platform ................................................................................ 28Use ............................................................................................................................ 28Procedure ................................................................................................................... 28

System Tools and Platform Agent logging ................................................................................. 28Use ............................................................................................................................ 28Example ..................................................................................................................... 30

Tuning Memory Usage and Garbage Collection ......................................................................... 30Use ............................................................................................................................ 30Problems and Solutions ................................................................................................. 31Getting a GC log .......................................................................................................... 31

Troubleshooting Performance and Memory Problems on NetWeaver .............................................. 37Use ............................................................................................................................ 37Prerequisites ................................................................................................................ 40Procedure ................................................................................................................... 40See Also ..................................................................................................................... 41

4. Troubleshooting SAP CPS or JAVA AS issues ................................................................................ 37Use .................................................................................................................................... 37Troubleshooting Performance Problems on NetWeaver ................................................................ 37

Use ............................................................................................................................ 37Prerequisites ................................................................................................................ 40

v


Procedure ................................................................................................................... 40See Also ..................................................................................................................... 41

5. Common Database Errors ........................................................................................................... 42Use .................................................................................................................................... 42This object has been deleted ................................................................................................... 42

Platform ..................................................................................................................... 42Specific Error message .................................................................................................. 42Resolution .................................................................................................................. 42

6. Common SAP-Related Errors ...................................................................................................... 43Use .................................................................................................................................... 43Error: E XM 034 Internal problem ........................................................................................... 43

Platform ..................................................................................................................... 46Specific Error Message .................................................................................................. 46Resolution .................................................................................................................. 46

Error: E XM 251 Time stamp "FROM_TIMESTAMP" is invalid ................................................... 43Platform ..................................................................................................................... 46Specific Error Message .................................................................................................. 46Resolution .................................................................................................................. 46

Error: ABAP/4 processor: TSV_TNEW_OCCURS_NO_ROLL_MEMORY .................................... 44Platform ..................................................................................................................... 46Specific Error Message .................................................................................................. 46Resolution .................................................................................................................. 46

Error: I:XM:233 BAPI_XBP_NEW_FUNC_CHECK .................................................................. 44Platform ..................................................................................................................... 46Specific Error Message .................................................................................................. 46Resolution .................................................................................................................. 46

Error: You have no authorization to log on to interface XBP .......................................................... 44Platform ..................................................................................................................... 46Specific Error message .................................................................................................. 45Resolution .................................................................................................................. 46

Error Incomplete Layout ........................................................................................................ 45Platform ..................................................................................................................... 46Specific Error Message .................................................................................................. 46Resolution .................................................................................................................. 46

SAP CPS not Listed as Available Package in JSPM ..................................................................... 46Platform ..................................................................................................................... 46Specific Error Message .................................................................................................. 46Resolution .................................................................................................................. 46

7. Common SAP BAE Errors .......................................................................................................... 47Use .................................................................................................................................... 47

0 – OK ....................................................................................................................... 471 - Cannot retrieve the file at the moment; please retry later .................................................. 4765 - User is not authorized ............................................................................................. 4766 - Invalid partition ..................................................................................................... 4767 - Invalid isolation group ............................................................................................. 4769 - Job restart is prohibited ........................................................................................... 4770 - Cannot modify job .................................................................................................. 4771 - Invalid SAP system name ........................................................................................ 4772 - Unsupported start option .......................................................................................... 4773 - Cannot delete event definition ................................................................................... 4874 - Cannot retrieve file ................................................................................................. 4875 - File is empty ......................................................................................................... 4876 - Invalid doc ID ........................................................................................................ 4877 - Invalid application ID .............................................................................................. 4878 - Invalid application name .......................................................................................... 48

vi


79 - Invalid job definition parameter ................................................................................. 4880 - Invalid job filter ..................................................................................................... 4881 - Queue does not exist ............................................................................................... 4882 - Unsupported start type ............................................................................................ 4883 - Unsupported schedule mode ..................................................................................... 4984 - Cannot schedule job ................................................................................................ 4985 - Invalid job definition ............................................................................................... 4986 - Invalid event control mode ....................................................................................... 4987 - Invalid event definition ............................................................................................ 4988 - Invalid user ........................................................................................................... 4989 - Job definition does not exist ..................................................................................... 4991 - An error was encountered while evaluating a default parameter value ............................... 4992 - Invalid job ID ........................................................................................................ 4994 - Error while persisting objects ................................................................................... 4995 - General error ......................................................................................................... 5096 - Session expired ...................................................................................................... 5097 - Invalid session id .................................................................................................... 5098 - Invalid ident .......................................................................................................... 5099 - Not supported ........................................................................................................ 50

8. Common Platform-Related Errors ................................................................................................ 51Use .................................................................................................................................... 51opsys.socket - Connecting socket to localhost port 10180 failed: No connection ............................... 51

Symptoms ................................................................................................................... 51Platform ..................................................................................................................... 53Specific Error Message .................................................................................................. 53Resolution .................................................................................................................. 53

JCS-116012: Warning: Transient communication failure: HTTP response code: 500 .......................... 51Symptoms ................................................................................................................... 51Platform ..................................................................................................................... 53Specific Error message .................................................................................................. 53Resolution .................................................................................................................. 53

id: illegal option u ................................................................................................................ 52Platform ..................................................................................................................... 53Resolution .................................................................................................................. 53

run_KSH: No such file or directory .......................................................................................... 53Platform ..................................................................................................................... 53Specific Error message .................................................................................................. 53Resolution .................................................................................................................. 53

network-processor: OS initialization failed ................................................................................ 53Platform ..................................................................................................................... 53Specific Error Message .................................................................................................. 53Resolution .................................................................................................................. 53

9. Common Redwood Platform-Related Errors ................................................................................... 54Use .................................................................................................................................... 54Address already in use. .......................................................................................................... 54

Symptoms ................................................................................................................... 54Platform ..................................................................................................................... 54Specific Error Message .................................................................................................. 54Resolution .................................................................................................................. 54

10. Common OracleJob Errors ........................................................................................................ 56Use .................................................................................................................................... 56ORA-20800: JCS-02006: user does not exist within database .............................. 56

Symptoms ................................................................................................................... 57Specific Error Message .................................................................................................. 58Resolution .................................................................................................................. 58

vii


ORA-01017: invalid username/password; logon denied ............................................................... 57Symptoms ................................................................................................................... 57Platform ..................................................................................................................... 57Specific Error Message .................................................................................................. 58Resolution .................................................................................................................. 58

JCS-132004: JDBC credential for user @System_Oracle not found. ..................................... 57Symptoms ................................................................................................................... 57Platform ..................................................................................................................... 57Specific Error Message .................................................................................................. 58Resolution .................................................................................................................. 58

11. .......................................................................................................................................... 16812. Resetting the Database of Redwood Platform ................................................................................ 60

Use .................................................................................................................................... 60Procedure ........................................................................................................................... 60

13. Reference .............................................................................................................................. 61SAP RFC User Privileges ....................................................................................................... 61

Use ............................................................................................................................ 61SAP Authorizations for XBP and BW .............................................................................. 61AAAB - Cross-application Authorization Objects ............................................................... 65BC_A - Basis: Administration ......................................................................................... 62SAP Authorizations for BW Process Chains ...................................................................... 64S_DEVELOP - ABAP Workbench ................................................................................... 65AAAB - Cross-application Authorization Objects ............................................................... 65SAP Authorizations for Industry Solutions (ISU) ................................................................ 65SAP Authorizations for SAP Applications ......................................................................... 65

Default SAP Job Definitions ................................................................................................... 66Use .......................................................................................................................... 123SAP_AbapRun ............................................................................................................ 69SAP_AbapRunPrint ...................................................................................................... 72SAP_AbapRunPrintExt ................................................................................................. 75SAP_ACC_Controller ................................................................................................... 78SAP_BObj_DataServicesJobRun .................................................................................... 79SAP_BObj_GenerateReportDefinition ............................................................................. 79SAP_BObj_ImportReportDefinitions ............................................................................... 79SAP_BObj_ReportRun .................................................................................................. 80SAP_BObj_TriggerEvent ............................................................................................... 80SAP_BW_GenerateInfoPackageGroup ............................................................................. 80SAP_BW_GenerateJobDefinition .................................................................................... 81SAP_BW_ImportInfoPackageGroups ............................................................................... 81SAP_BW_ImportInfoPackages ....................................................................................... 82SAP_BW_ImportProcessChainDefinition ......................................................................... 82SAP_BW_ImportProcessChains ...................................................................................... 83SAP_BW_InfopackageRun ............................................................................................ 83SAP_BW_MaintainProcessChainDefinition ...................................................................... 84SAP_BW_Process ........................................................................................................ 84SAP_BW_ProcessChain ................................................................................................ 85SAP_BW_RestartProcess .............................................................................................. 85SAP_BW_RestartProcessChain ....................................................................................... 86SAP_BW_ProcessChainRun .......................................................................................... 86SAP_CcmsJob ............................................................................................................. 87SAP_CcmsJobCheckStatus ............................................................................................ 87SAP_CcmsJobGetApplicationLog ................................................................................... 88SAP_CcmsJobGetApplicationLogHandles ........................................................................ 89SAP_CcmsJobGetLog ................................................................................................... 89SAP_CcmsJobGetSpoollist ............................................................................................ 89

viii


SAP_CcmsJobGetStatistics ............................................................................................ 90SAP_CcmsJobModifyHeader ......................................................................................... 90SAP_CcmsJobGetStatus ................................................................................................ 91SAP_ClosingCockpit_AbapRun ...................................................................................... 91SAP_ClosingCockpit_ManualTask .................................................................................. 94SAP_CopyVariant ........................................................................................................ 94SAP_DeleteCcmsMonitors ............................................................................................. 95SAP_DeleteVariant ....................................................................................................... 95SAP_ExportRFCFunctionModuleInterface ........................................................................ 96SAP_ExternalCommandRun .......................................................................................... 96SAP_ExternalProgramRun ............................................................................................. 98SAP_GenerateCcmsJobDefinition .................................................................................. 100SAP_GetBatchResources ............................................................................................. 100SAP_GetEventHistory ................................................................................................. 101SAP_GetInstalledComponents ...................................................................................... 101SAP_GetSysLog ........................................................................................................ 101SAP_GetXmiLog ....................................................................................................... 101SAP_ImportAbapParameterDefinition ............................................................................ 102SAP_ImportAbapPrograms .......................................................................................... 102SAP_ImportApplicationServers ..................................................................................... 103SAP_ImportArchiveObjects .......................................................................................... 103SAP_ImportBatchEvents .............................................................................................. 103SAP_ImportCalendars ................................................................................................. 104SAP_ImportExternalCommands .................................................................................... 104SAP_ImportCcmsJobs ................................................................................................. 104SAP_ImportCcmsMonitors ........................................................................................... 106SAP_ImportOutputDevices .......................................................................................... 106SAP_ImportRecipients ................................................................................................ 107SAP_ImportVariantDefinition ....................................................................................... 107SAP_ImportVariants ................................................................................................... 108SAP_Info .................................................................................................................. 108SAP_InterceptedJob .................................................................................................... 108SAP_JXBP_GenerateJobDefinition ................................................................................ 109SAP_JXBP_ImportJobDefinitions ................................................................................. 109SAP_MA_CopyParameters .......................................................................................... 110SAP_MA_CreateParameters ......................................................................................... 110SAP_MA_DeleteDunningProposal ................................................................................ 111SAP_MA_ImportMassActivities ................................................................................... 111SAP_MA_ImportMassActivity ..................................................................................... 112SAP_MA_MassActivityRun ......................................................................................... 112SAP_MA_MassActivityTemplateRun ............................................................................. 113SAP_MA_ResumeMassActivity .................................................................................... 113SAP_MA_ShowMassActivity ....................................................................................... 114SAP_MA_StopMassActivity ........................................................................................ 114SAP_MaintainXbpOptions ........................................................................................... 114SAP_PI_GetChannelStatus ........................................................................................... 115Parameters ................................................................................................................ 123SAP_PI_ImportChannels ............................................................................................. 116SAP_PI_StartChannel ................................................................................................. 116SAP_PI_StopChannel .................................................................................................. 116SAP_RaiseEvent ........................................................................................................ 117SAP_ReloadApplicationLinks ....................................................................................... 117SAP_ReleaseInterceptedJobs ........................................................................................ 117SAP_RunTemplateJob ................................................................................................. 118SAP_SetXmiAuditLevel .............................................................................................. 118

ix


SAP_SolutionManager_AbapRun .................................................................................. 118SAP_StoreVariant ....................................................................................................... 120SAP_SwitchOperationMode ......................................................................................... 121SAP_SynchronizeEventHistoryCriteria ........................................................................... 121SAP_SynchronizeInterceptionCriteria ............................................................................. 122SAP_SynchronizeTerminatedCcmsJobs .......................................................................... 123

JCS Errors ......................................................................................................................... 123JCS Errors 101XXX (alert) ........................................................................................... 123JCS Errors 102XXX (api-impl) ..................................................................................... 124JCS Errors 103XXX (api-int) ........................................................................................ 132JCS Errors 104XXX (api) ............................................................................................. 133JCS Errors 105XXX (as400) ......................................................................................... 134JCS Errors 106XXX (audit) .......................................................................................... 134JCS Errors 107XXX (cl-api) ......................................................................................... 134JCS Errors 108XXX (cl-impl) ....................................................................................... 134JCS Errors 109XXX (cluster) ........................................................................................ 134JCS Errors 110XXX (configuration) ............................................................................... 135JCS Errors 111XXX (core) ........................................................................................... 135JCS Errors 112XXX (db-init) ........................................................................................ 136JCS Errors 113XXX (export) ........................................................................................ 137JCS Errors 114XXX (infrastructure) ............................................................................... 138JCS Errors 115XXX (jobchainservice) ............................................................................ 138JCS Errors 116XXX (jobservice) ................................................................................... 139JCS Errors 117XXX (mailservice-api) ............................................................................ 139JCS Errors 118XXX (security) ...................................................................................... 139JCS Errors 119XXX (servlet) ........................................................................................ 140JCS Errors 120XXX (ui) .............................................................................................. 140JCS Errors 121XXX (module-r2w) ................................................................................ 140JCS Errors 122XXX (agent-api) .................................................................................... 141JCS Errors 122XXX (model) ........................................................................................ 141JCS Errors 123XXX (persistence) .................................................................................. 142JCS Errors 124XXX (script-java) ................................................................................... 143JCS Errors 125XXX (constraint) ................................................................................... 143JCS Errors 126XXX (iphone) ........................................................................................ 143JCS Errors 127XXX (rfcconnector) ................................................................................ 143JCS Errors 128XXX (extract-jco) .................................................................................. 144JCS Errors 129XXX (oraapps-service) ............................................................................ 144JCS Errors 129XXX (oraapps) ...................................................................................... 144JCS Errors 130XXX (apns) ........................................................................................... 144JCS Errors 131XXX (dblayer-sql) .................................................................................. 144JCS Errors 131XXX (oraohi-service) .............................................................................. 145JCS Errors 132XXX (dynamicsax-service) ...................................................................... 145JCS Errors 132XXX (jdbc-impl) .................................................................................... 145JCS Errors 132XXX (peoplesoft-service) ........................................................................ 145JCS Errors 133XXX (iphone-public) .............................................................................. 145JCS Errors 134XXX (r2w-comm) .................................................................................. 145JCS Errors 135XXX (publish) ....................................................................................... 146JCS Errors 136XXX (oraclejob-impl) ............................................................................. 146JCS Errors 137XXX (api-plsql-impl) .............................................................................. 146JCS Errors 138XXX (api-plsql-install) ............................................................................ 146JCS Errors 139XXX (bobj-service) ................................................................................ 146

Registry Keys .................................................................................................................... 147Use .......................................................................................................................... 147Configuration Hive ..................................................................................................... 147Active Alerting-Related Registry Keys ............................................................................ 154

x


Archiving Server-Related Registry Keys ......................................................................... 154SAP-Related Registry Keys .......................................................................................... 154Platform Agent-Related ................................................................................................ 157User Hive .................................................................................................................. 157

Common Logging Categories ................................................................................................ 157Use .......................................................................................................................... 157See Also ................................................................................................................... 158

Glossary ........................................................................................................................... 158A ............................................................................................................................. 158B ............................................................................................................................. 159C ............................................................................................................................. 160D ............................................................................................................................. 161E ............................................................................................................................. 161F ............................................................................................................................. 162G H I ........................................................................................................................ 162J .............................................................................................................................. 162K ............................................................................................................................. 164L ............................................................................................................................. 164M ............................................................................................................................ 164N O .......................................................................................................................... 165P Q .......................................................................................................................... 165R ............................................................................................................................. 166S ............................................................................................................................. 166T ............................................................................................................................. 167U V .......................................................................................................................... 167W ............................................................................................................................ 167X Y Z ....................................................................................................................... 167

xi


Chapter 1. New FeaturesThis topic lists the new features for SAP CPS build M33.58-58052, built on Tue May 08 11:45:35 2012.

New Features in M33

Sybase Adaptive Server Enterprise SupportSAP CPS now supports Sybase Adaptive Server Enterprise version 15.5 as an underlying database.

Parameter Value Changes Update Submit WizardWhen you change a parameter value in the submit wizard, the page is re-rendered. This means that parameters thathave values depending on the value that was changed will be updated and allows you to create dependenciesbetween parameters.

New Global PrivilegesNew deactivated global privileges have been introduced:

• Redwood_Shell - can control who can access RedwoodScript

• iPhone_Access - can control who can access SAP CPS with an Apple iPhone

• Default_Navigation_bar - can control who can access the default navigation bar

• Redwood_Script - can control who can use RedwoodScript in job definitions, libraries, triggers and other areasthat use RedwoodScrip.

These three privileges are disabled by default and need to be activated.

Out Parameters are now Set even if the job did not ReachStatus Completed

Previously, when a job did not reach status Completed, Out parameters were not set. This has now changed; if thejob had the time to set the out parameter before it failed, the Out parameter will be set.

Job Chain Calls Restricted to a Time WindowJob Chain calls can now be restricted to a time window, which means that the call will wait until the time windowis open if the time window was closed at start-time.

Low Volume Licensing now availableIf you want to use low volume process servers contact your account representative.

1

Partial Job File RetrievalYou can now retrieve a range of lines, search for strings in output files and email just the matched lines. This allowsyou to retrieve just the last 10 lines of the output file of a job that reached status Error and forward just the errormessage, for example.

Financial Process Automation (FPA)Automate and optimize your closing processes with streamlined processing in multiple systems. End-user friendlyuser interface for document aprroval, process monitoring, and repot inspection. The FPA server should reside ona separate server for performance reasons, the same database can be used, but you should use different databaseschemas for SAP CPS and the FPA server.

Job Data ArchivingYou can now archive old job data to a separate server, allowing you to keep your SAP CPS server optimized. Thearchiving server allows you to easily access the archived job data. The archiving server must be a Microsoft Windowsserver and it is highly recommended to use a second server for archiving purposes as having the archive server.You can use the same database (database instance), however you should not use the same schema.

IgnoreApplicationReturnCode Registry Keys and Paramet-ers

Two new registry keys and parameters have been introduced to force SAP process servers to ignore applicationreturn codes that SAP jobs return and which are used to determine the final status of the job. All can be set totrue or false, SAP CPS processes the settings in the following order::

1. job definition parameter IGNORE_APPL_RC, only valid for all jobs of this job definition

2. process server parameter SAP_IgnoreApplicationReturnCode, only valid for all jobs that run onthe process server

3. registry key /configuration/sap/./xbp/IgnoreApplication-ReturnCode, only valid for the specified SAP system

4. registry key /configuration/sap//xbp/IgnoreApplicationReturnCode, valid for all SAPR3jobs across all SAP systems

The default value of this has changed to false for new installations; when you upgrade from a version prior toM33 and have SAP systems defined, the registry key /configuration/sap//xbp/IgnoreApplication-ReturnCode will be created and set to true, so the behavior will not change.

New Scorecard for Historical DataYou now have the scoreboard that displays historical statistical data. By default, it will keep data for 365 days.The retention period can be set with the registry key /configuration/history/jobhistory.

Store Documentation in SAP CPS DocumentsYou can now store documentation about SAP CPS objects or processes in '"Document objects and link to themfrom Documentation'' fields in objects.

2

New Features

Better Unattended Install Support for Platform AgentsNew switches have been added to the platform agent installers, allowing you to specify all options on the commandline. This is especially useful for unattended installations.

Maximum Restarts and Restart Delay for Job Chain StepsJob chain steps now have two new attributes, Maximum Restarts and Restart Delay Amount/Restart Delay Units,which allow you to specify how many times steps are to be restarted in case according to Final Status Handlers.You can also specify a delay after which each restart should occur.

Lenient Flag for DateTimeZoneYou can now set the lenient flag on DateTimeZone objects in your code, so that dates are evaluated strictly andproduce an error when you enter invalid dates. Note that the default has not changed, invalid dates like 31/11/2011are evaluated and corrected when invalid, in this example, the resulting date is 01/12/2011.

To disable the lenient flag, you can do the following:

{ DateTimeZone dtz = new DateTimeZone(2011,10,31,12,10,10,10); dtz.setLenient(false); jcsOut.println(dtz.toString()); }

SAP Business Automation Enabler (BAE) Connectors / SAPInbound

It is now possible to connect SAP systems with SAP CPS to schedule workload in SAP CPS from within an SAPinstance without the use of process servers. Previously, an SAP System object was required in SAP CPS whichused a process server key. This had an impact on the licensing costs of Chargeable version SAP CPS installationswhen you did not schedule workload from within SAP CPS on that SAP instance. With SAP Inbound, you haveseparate objects which are free of charge and allow you to control SAP CPS from within SAPGui. Although a licencekey defines the maximum amount you can create, you may request additional ones at any time.

Note

The BAE Connectors are only available when you purchased SAP CPS from SAP AG.

Job ForecastingYou can now create a forecast for given jobs; this allows you to plan workload better and gives you a better overviewof system load.

3

New Features

New Features in M31

Archiving with the new Archive ServerYou can now archive old jobs and their output to the archive server to offload the central scheduling server. TheArchive Server also has a report-friendly interface, allowing you to quickly locate the desired job and its output.The Archive Server is built on Redwood Report2Web technology.

SAP ModuleYou can now set the user that runs Mas Activities. In previous releases, the account used to run Mass Activitieswas the RFC user. When you fill the parameter SAP_USER_NAME on job definitions SAP_MA_MassActivityRunand SAP_MA_MassActivityTemplateRun, the mass activity will be started from a batch job that has the specifieduser as a step user, forcing the Mass Activity to run as that user.

Mail ModuleSAP CPS will now create the smtp credential protocol automatically.

Oracle Applications SchedulingYou can now schedule Oracle Applications (aka Oracle EBS) workload with SAP CPS. This feature requires aspecific license key, see the License topic ( see the Administration Guide ) for more information.

Suppress License Expiration WarningYou can now suppress the license expiration warning with the registry key user//ui/config-uration/ExpirationNotification. The default value is 28 days, the minimum is 7 days, lower valueswill result in 7 days. It has to be set by users.

user//ui/configuration/ExpirationNotification

Customize the Navigation BarWith this release, you can now customize the navigation bar to include frequently used items only. This is especiallyhandy for operators or other users with limited privileges, as you can reduce number of items in each group, whichincreases efficiency.

New Features in M28These features appeared in M28 and are listed here for your convenience.

Import Jobs and ClustersIn previous releases, when you ran a job to import a car file, for example, the file would be saved in the currentworking directory of the cluster node. This can cause issues if the actual job is run on another node, as it cannotaccess the file.

4

New Features

A new registry key /configuration/jcs/upload/UploadedFilesPath has been introduced to specifythe location where uploaded files, not only car files, are saved. This directory must be accessible to all nodes inthe cluster.

New Object Filter ConditionsA lot of objects can now be filtered on owner or partition.

Query Filter Parameter ConstraintsYou can now use object filters to create list of values for job parameters ( see the Administration Guide ).

Improved Security with sudoWhen you use sudo for user-switching on Unix, you can now specify your chown command and check parametersfor validity, making sure a rogue user who gained access to the SAP CPS OS account cannot access files ownedby root. SAP CPS ship with an example chown.sh script which can be used as a basis. See Configuring PlatformAgents ( see the Administration Guide ) for more information.

Source Code Fields are ResizableSource code fields are now resizable, you can toggle the stub code field as well to allow the source code field toalmost cover the entire window. Resizing the window now resizes the source code field to allow you write complexcode with greater ease.

New Reporting Functionality1. Reports now have a preview window, where you can see a preview of a report before you save it.

2. The report job definition type has been introduced to allow you to change parameters easily.

3. Report parameters have been introduced to allow you to use Redwood Expression Language ( see the Admin-istration Guide ) in selections with greater ease.

Submit Frames Now Offer a PreviewYou can now see when jobs will be submitted according to the submit frame, if you were to submit them at thecurrent time, much like time windows show the times of the day they are open.

Platform Agent Network TimeoutA network timeout has been introduced to solve networking issues, when no message has been received in at mosttwice the MessageInterval ( see the Administration Guide ), the platform agent will attempt to reconnect.

Fail-over TimeoutsIt is now possible to configure fail-over timeouts with the SAP CPS registry key: /configuration/jcs/clus-tering/lockTimeoutThreshold the value is in seconds.

The default value is 300 seconds and will be used if this registry key is not set or its value is invalid.

5

New Features

Permalink ModuleThe Permalink Module ( see the Administration Guide ) allows third-party applications to interact with SAP CPS.

Links in Documentation FieldsThe Documentation fields of all objects now support the following URL's:

• http[s]:// - any HTTP or HTTPS URL

• file:// - a file URL, the file should be accessible from that unique path from the perspective of the user

Note

Due to security settings in Mozilla Firefox, file:// URL's must first be enabled, see the ReleaseNotes for more information.

SAP SNC SupportSAP CPS can now use Single Sign On (SSO) over RFC connections, making the connection encrypted. See theConnect to an SAP System with SNC topic ( see the Administration Guide ) for more information.

Advanced Auditing RulesYou may now define advanced auditing rules ( see the Administration Guide ), for objects of a given name or beingin a specific application.

Advanced Search for all ObjectsSAP CPS now offers the quick and easy search feature available in previous versions for job search on most objects.When you are in an object view, for example in Definitions > Job Definitions you can quickly locate the jobdefinition by entering a distinctive part of its name into the search field. The search field is context-sensitive, soit will only search for objects in the currently selected tab.

Easy Retrieval of Process Server LogsProcess servers and jobs now offer a new action to retrieve log files and system information, this is especiallyuseful for support queries.

Controlling Communication Channels with SAP PISAP CPS now allows you to control communication channels via the SAP PI interface. This functionality givesyou advanced control of when which transformation take place and requires a Chargeable Version.

New Features in M26These features appeared in M26 and are listed here for your convenience.

6

New Features

SAP Applications API IntegrationSAP CPS has an RFC server that you can use to connect to SAP CPS from ABAP stacks via an RFC destinationand submit jobs from Closing Cockpit or Solution Manager. Other SAP components are being adapted to makeuse of this new feature.

Mail Job Definition TypeThe Mail job definition type ( see the Administration Guide ) has been introduced to allow you to create customemails from within a job chain.

Period FunctionsIt is now possible to create period functions ( see the Administration Guide ). You have to specify a library con-taining a valid JAVA 1.4.2 package that can be used with period functions. Period functions allow you to createcomplex schedules.

ReportsThe reporting has been improved in this release. The Report object ( see the Administration Guide ) allows youto specify filters or custom queries and displays the output in csv or html.

CredentialsCredentials ( see the Administration Guide ) have been introduced to allow you to securely save login informationfor external systems. There is also a new virtual user, which allows you to work with many different user namesand passwords across several systems by mapping them to one virtual user. Jobs will then execute as the correctuser on any of the systems, regardless of the real user name on the target system. You could have a virtual userdb_user that would be jdoe on server1 and jdupont on server2.

DashboardThe dashboard ( see the Administration Guide ) has been introduced to allow you to monitor components andsystems from within one window. The dashboard allows you to have graphs and tachometers to display the currentstatus.

Library and TriggersThe scripting module has been extended with libraries ( see the Administration Guide ) and triggers ( see the Ad-ministration Guide ). Libraries provide a central location for your RedwoodScript ( see the Administration Guide) packages and are available in all objects that provide scripting capabilities. Triggers allow you to execute codeglobally when a job reaches a specific status or an object is changed by a user, for example.

Isolation groupsIsolation groups ( see the Administration Guide ) allow you to isolate objects from users. They are also used toisolate SAP Systems from each other when you have the Free of Charge license.

7

New Features

Chapter 2. Release NotesMost Important Release Notes

AS/400: JobAppend is Appended twice if setIf you set JobAppend, it will be appended twice, which will prevent the job from retrieving log files.

Sybase Adaptive Server Enterprise SupportSAP CPS now supports Sybase Adaptive Server Enterprise version 15.5 as an underlying database.

Reverting from a Chargeable to a Free of Charge VersionReverting from a Chargeable to a Free of Charge version is not supported. This is due to the fact that there arerestrictions in the Free of Charge version which do not exist in the Chargeable version.

"[Non production use only]" in Application Title UnlessSupported DB is Used

The caption "[Non-production use only]" is displayed after the product name unless the database is on the followinglist.

• DB2 - AS/400, OS/390, Linux/Unix/Windows

• SQL Server

• Oracle

• SAPDB

• Sybase

Redwood Platform and Oracle PrerequisitesThe documentation previously stated that you should use the roles CONNECT and RESOURCE to grant the Oracleuser that SAP CPS uses to access the database the required privileges. After further investigation, it turns out thatthese roles grant not only too many privileges, but also hidden privileges. The RESOURCE role includes UNLIMITEDTABLESPACE which is not what most customers would want. Note that you can only see UNLIMITED TA-BLESPACE in the user's session privileges after granting the user the RESOURCE role. When you grant UNLIMITEDTABLESPACE to a user, then grant and revoke the RESOURCE role, the user loses the UNLIMITED TABLESPACEprivilege!

Note that no issues have been reported regarding this, but SAP recommends you grant the following privilegesonly:

• CREATE SESSION

• CREATE TABLE

8

Also, the user needs unlimited quota on the default tablespace for that user, as that is the tablespace used by SAPCPS.

So, to edit an existing user perform the following:

$ sqlplus system/mypassword@orclSQL> alter user masalan 2 quota unlimited on users;SQL> revoke CONNECT, RESOURCE from masalan;

Revoke succeeded.

SQL> grant create session, create table to masalan;

To create a user with the required privileges:

$ sqlplus system/mypassword@orclSQL> create user masalan identified by mypassword 2 default tablespace users 3 quota unlimited on users;SQL> grant create session, create table to masalan;

Note that in these examples, orcl is the connect string, masalan is the user and users is the tablespace.

Note, also, that mypassword is not a very safe password and just used here for illustration purposes.

Tablespace Usage - Upgrading from Version 7When you upgrade from SAP CPS version 7.0.4 to SAP CPS, you need to plan for potentially greater tablespaceusage.

SAP CPS version 8.0.0 has the following differences that may affect tablespace sizes:

• use of a UTF characterset is highly recommended; it potentially uses more space to save characters than others- it has the advantage, though, that it can store a much greater number of different characters

• objects can have longer names, this was increased from 30 to 80 characters

• default job definitions have more job parameters which provide new functionality

Change in IntelliSearch PrefixesNew intelliSearch prefixes have been introduced::

• status, st

• req

The following intelliSearch prefixes have changed!

• run start - used to be s: and has been changed to rs:

• run end - use to be e: and has been changed to re:

This change was necessary for the introduction of the new status prefix.

9

Release Notes

Change in Time Windows with OffsetsPreviously, when you had a time window defined with a time-range (like 10AM to 5PM, for example) and offseton a time window element, the time window could potentially be open all day, regardless of the specified time-range. This has been changed. If you are upgrading and have time windows with time-ranges and offsets, pleasecheck them to see if they still function the way you expect.

Run As Fields and Special Characters in PasswordsCustomers have reported that when they specify a user/password in a Run As User field in a job definition andhave special characters (/ and @) used in the Run As User field in their passwords, the jobs reach status Error.This is due to the fact that both / and @ are used as field separators in Run As User fields.

Specifying a username with password in a Run As User field is deprecated in favor of credentials, which offer asecure central store for passwords.

New MASS_ACTIVITY_DATE_SHIFT BehaviorThe behavior of MASS_ACTIVITY_DATE_SHIFT parameter has been changed:

• if left blank, dates will be automatically shifted the number of days between source and target date ID's, inaccordance with the old behavior

• if set to 0, dates will not be shifted; this is the new behavior

Improved Support for DBMS_OUTPUTSupport for Oracle dbms_output when written to log files has been improved:

• If output is printed (still controlled by JDBCOracleDBMSOutput) it is always at the end.

• New parameters:

• JDBCOracleDBMSOutputDestination - either stderr.log or stdout.log. Defaults to stderr.log forCSV, and stdout.log for all others.

• JDBCOracleDBMSOutputHeader - header to print before the dbms output. Defaults to Out-put for HTML, for XML and nothing for all others.

• JDBCOracleDBMSOutputFooter - footer to print after the dbms output. Defaults to forHTML, for XML and nothing for all others.

The text update count: is now only printed for DML statements, like insert, delete, and updatestatements.

Changes in TablesThe following changes have been made to tables:

• TableValue.ColumnValue is now optional.

• TableValue.ColumnValue maximum length is now 1000 instead of 255.

10

Release Notes

• When persisting a TableValue for a column all omitted TableValues for optional TableDefinition-Columns are also created, to ensure the table is fully populated. Besides all existing tables will be fullypopulated after the upgrade.

• Table.TableValues() will return the TableValues sorted by: Key, DisplayOrder, previouslythey were only odered by key

• TableDefinitionColumn.Datatype can not be changed for existing tables.

• TableDefinitionColumn.Optional can not become mandatory for existing tables.

• TableDefinitioColumn.ColumnName must be unique for the TableDefinition

• TableDefinitionColumn.DisplayOrder must be unique for the TableDefinition

Redwood Platform: Redwood Messaging ReplacesJMS

In Redwood Platform, the default cluster messaging infrastructure has changed. JMS has been replaced by a morerobust built-in messaging mechanism.

You can use SAP CPS registry settings or system properties, also known as JVM parameters, to set the InstanceIdand messaging port.

JVM parameters will have precedence over the registry keys. To set system properties, you replace the /config-uration/boot/cluster with com.redwood.scheduler.boot.cluster for example:

com.redwood.scheduler.boot.cluster...bindAddress will override/configuration/boot/cluster////bindAddress.

Note

The system property com.redwood.scheduler.cluster.rwm.InstanceId is deprecated!

Out Parameters Set even when Job FailsPreviously, Out parameters were only set when the job reached status Completed; this has changed. All Out para-meters that have been set by the job are now set regardless of the final status, as long as the final status is one ofCompleted, Unknown, Error, or Killed. This means that if the job had the time to set the Out parameter before itfailed, the Out parameter will be set.

Importing Large CAR Files Can Cause OOME'sWhen you import large CAR files dependencies must be calculated and this can cause OutOfMemoryException's.SAP recommends you split large CAR files up into multiple smaller files.

Navigation Bars in Partitions other then GLOBALNavigation bars that were not stored in the GLOBAL partition could previously not be used properly, as a refreshor log off and successive log on would cause the default navigation bar to be loaded. This was because the registrykey in which the current navigation bar was saved only specified the name of the navigation bar, not its partition;the navigation bar could thus not be found.

11

Release Notes

The registry key has been changed to require the business key, as in ., instead of justthe name. You specify your preferred navigation bar in the Options menu.

Using Credentials with FTP Job Definition TypesWhen you use credentials, the connection is already established when the job definition source is evaluated. Thismeans that you cannot specify a non-standard port in your job definition source while using credentials, in thiscase you need to specify the port in the Endpoint of the credential as follows: @:or [email protected]:2021.

Report job gives NPE if parameter OutputFormatis not available

Report jobs would reach status Error when the OutputFormat was not defined; this has been fixed, the OutputFormatjob definition parameter is now optional.

Importing Multiple SAP Jobs with Identical NamesErrors can occur when you attempt to import multiple, different, SAP jobs with the same name during a singleimport. When, for example, you have two jobs in an SAP instance with the same name but a different number ofsteps, the import will fail. This is due to the fact that SAP CPS does not overwrite job definitions and is a knownlimitation. The workaround is to use the SAP job count to import the desired job definition, then rename it in SAPCPS and import the other with the other job count.

Jobs Stay in Status PreRunning or PostRunningWhen you make extensive use of actions, the thread pool for executing actions can be saturated, in which case alot of jobs will remain in a pre-running or post-running status.

You can configure the number of threads to be used to execute actions. A change requires a restart of the web ap-plication. SAP recommends to only change the number of threads when you are instructed to do so from SAPCustomer Support Services.

The number of threads is set to 20 by default, you may specify a value using the following registry key:

/configuration/requestQueueSize/action

Runtime Expiration Calculations have been movedto separate threads

Runtime calculations have been moved to separate threads to increase the performance on systems where theseare heavily used. You can specify the number of threads to allocate to these with the following registry key:

/configuration/requestQueueSize/runtime

Importing SAP System ObjectsWhen you import SAP system objects, note that Monitor values cannot be imported. This means that the importwill fail if the CAR archive references SAP Application Servers and these monitors do not exist. If you experience

12

Release Notes

this, expand the archive with jar or with a zip program (you might need to rename the CAR file to zip), open theSAP System XML file and remove any references to SAP Application Servers. Note that this also means that youcannot import load factors of an SAP system.

SAP CPS and other SAP SoftwareSpecial attention must be paid when you install Redwood Platform on a server where SAP software is installed.SAP CPS uses the librfc library to connect to SAP systems, which can also be found in SAP software like SAPGui.On some Windows systems with installed SAPGui, librfc has been found in %WINDIR%\System32, whichprevents SAP CPS from loading JCo to connect to SAP systems. If you experience this, move the librfc out of theSystem32 directory and into another directory, like the bin directory of SAPGui.

FileInUseCommand Process Server ParameterChanged Default Value on Unix

The FileInUseCommand process server parameter now has the full path to the fuser file as the default value onUnices (except GNU/Linux), just like it was the case for Oracle Solaris.

The new default value has become /usr/sbin/fuser ${Filename}, it was set to fuser ${Filename}on Unix, except for Oracle Solaris and GNU/Linux.

This change was made to allow customers to remove /usr/sbin from the ${PATH} of the user. The defaultfor GNU/Linux is lsof ${Filename}. Note that lsof is on the default user path, usually located in /usr/bin.

SAP Application Return CodesSAP application return codes will now be ignored by default with new installations. When you upgrade from M31or earlier, a registry key will be created and set to true so as not to change the behavior of SAP CPS. Ignore-ApplicationReturnCode Registry Key

The registry can be set to true or false at the following locations:

• /configuration/sap/xbp/IgnoreApplicationReturnCode - all SAP systems are affected

• /configuration/sap/./xbp/IgnoreApplicationReturnCode- only the SAP instance for which this registry key is defined is affected

The settings are processed in this order, the first setting found has precedence:

1. job definition parameter IGNORE_APPL_RC, only valid for all jobs of this job definition

2. process server parameter SAP_IgnoreApplicationReturnCode, only valid for all jobs that run onthe process server

3. registry key /configuration/sap/./xbp/IgnoreApplication-ReturnCode, only valid for the specified SAP system

4. registry key /configuration/sap//xbp/IgnoreApplicationReturnCode, valid for all SAPR3jobs across all SAP systems

13

Release Notes

Killing RedwoodScript JobsWhen you have short infinite loops, like {while (true){}} you will not be able to kill the RedwoodScriptjob. To stop this job you will have to restart SAP CPS. Note that this problem does not occur for {while(true){Thread.sleep(1);}}.

Upgrading from M28

Active Monitoring ModuleWhen you upgrade from M28 and are using alert sources, make sure all alert sources have a Default Escalationor an Escalation Expression. The Default Escalation field has become mandatory when no Escalation Expressionhas been defined.

Pre-submit CountWhen you upgrade from M28 or lower, you will not have a value in the registry key /configuration/jcs/re-currence/DefaultPreSubmit. An operator message will be generated about this. Please set the registrykey.

The operator message will be:

No recurrence presubmit count registry entry at /configuration/jcs/recurrence/DefaultPreSubmit

Note

When you use submit frames, the restart count is set to 1.

Impacts RecurrencesIn M28, when you edited a job which was part of a recurrence and the change the start time, the job is removedfrom the job group. In M33 and later, the job is also removed from the job group, but a new job is created to replaceit. You should delete the newly created job that replaced your edited job. In the future, when you want to delay ajob, use the delay action.

Job Chain Job RestartNew properties have been added to job chain jobs to automatically restart the job; a delay can be configured. Notethat the restart behavior configured on job definition-level now also holds in job chains; this was not the case inreleases prior to M33.6. This means that if a