Return code mapping file names for r3batch
r3batch
uses the global
return code mapping files listed below. You must manually create the rcm
directory
under the following path:- On UNIX operating systems
TWA_DATA_DIR/methods
- On Windows operating systems
TWA_home\methods
rcm
directory: - r3batch-joblog.rcm
- Maps messages from the R/3 job log of a job into return code values. If this file is not
present, the messages in the job log are ignored. The format of the mapping file is:
wheremessage_text_pattern [program_pattern[message_number_pattern[message_id_pattern]]]=RCvalue
program_pattern
is the external program that produced the output shown in the job log andmessage_id_pattern
is the message class. For example, the following line appended in the job log:
will match the following pattern line in04/26/2005 10:08:04 00 550Step 001 started (program BTCTEST, variant VAR1, user name TWSDEV)
r3batch-joblog.rcm
:
because:"*Step*" "*" "550" "*"=5
- message_text_pattern
"Step 001 started (program BTCTEST, variant VAR1, user name TWSDEV)"
- program_pattern
"*"
- message_number_pattern
"550"
- message_id_pattern
"*"
- r3batch-pchainlog.rcm
- Maps messages from the protocol of a Process Chain into return code values. If this file is not
present, the messages in the protocol are ignored. The format of the mapping file is:
message_number_pattern [message_id_pattern[message_variable1[message_variable2 [message_variable3[message_variable4[message_type]]]]]]=RCvalue
- r3batch-spoollist.rcm
- Maps messages in the job spool list of an R/3 job into return code values. If this file is not
present, the messages in the spool list are ignored. The format of the mapping file is:
spool_list_row_pattern=RCvalue
- r3batch-syslog.rcm
- Maps messages in the syslog of an R/3 system into return code values. The R/3 system log should
be checked only when R/3 returns the generic 552 error to
r3batch
.If this file is not present, the messages in the system log are ignored.
The format of the mapping file is:system_log_row_pattern=RCvalue
If you plan to map system log messages, be sure to set the
log_r3syslog
option ofr3batch
toON
(the default isOFF
). - r3batch-msgrc.rcm
- Maps ABAP exceptions and BAPI return codes of RFC function modules into return code values. If
this file is not present, the mapping is done using a hardcoded table. The format of the mapping file is:
message_number=RCvalue
message_number
is the error message number. The last message number is always used. That is, if two error messages are generated, only the second one is checked against the mapping file.