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 TWS_home/methods and the
mapping files you want to implement.
- TWS_home/methods/rcm/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 joblog are
ignored.
The format of the mapping file is:
where program_pattern is the external program that produced the output shown in the job log and message_id_pattern is the message class. For example, the following line appended in the job log:message_text_pattern [program_pattern[message_number_pattern[message_id_pattern]]]=RCvalue
will match the following pattern line in TWS_home/methods/rcm/r3batch-joblog.rcm:04/26/2005 10:08:04 00 550Step 001 started (program BTCTEST, variant GIULIO, user name TWSDEV)
because:"*Step*" "*" "550" "*"=5
- message_text_pattern
- "Step 001 started (program BTCTEST, variant GIULIO, user name TWSDEV)"
- program_pattern
- "*"
- message_number_pattern
- "550"
- message_id_pattern
- "*"
- TWS_home/methods/rcm/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
- TWS_home/methods/rcm/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
- TWS_home/methods/rcm/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 of r3batch to ON (the default is OFF).
- TWS_home/methods/rcm/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 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.message_number=RCvalue