Matchcode utility

Matchcode Utility

In physical matchcodes (update types A, S or P), the matchcode data is stored redundantly as its own table in the system. These tables must be constructed after you have created and activated the matchcode object and the matchcode IDS and created the matchcode pool in the database. These tables are constructed and deleted using the matchcode utility (SAPMACO report). The table construction is the same for all the physical update types (A, S or P).

Remark: Transparent matchcode IDs (update type I) and classification matchcode IDs (update type K) are not stored physically. Therefore they cannot be constructed with the matchcode utility. If the matchcode utility is called for a transparent ID, only the matchcode view is created on the database.

The matchcode utility works globally for all clients. A parameter controls whether the matchcodes should be constructed or deleted for a specific client or for all clients. The utility also permits the construction of matchcodes for all the matchcode objects in one run.

Using the matchcode utilties

In the display Maintain Matchcode Object (Attributes), select the function Utilities -> Matchcode data and the required function (Construct, Delete, Restart, Delete selected ). The matchcode utility is called in this way.

Alternatively, you can start the matchcode utility by calling the SAPMACO report.

In the display Matchcode utility you can set the following parameters:

Matchcode object name

You can maintain one or more matchcode objects. If a matchcode object is to be handled, you must enter the name. Otherwise enter a LIKE pattern usual for an ABAP/4 Open SQL. All the matchcode objects are maintained if "*" is entered.

If you want to maintain exatly one matchcode object, you must select the matchcode IDs to be maintained during program execution. If you want to maiantain more than one matchcode object, it is assumed that you want to edit all the matchcode IDs of the matchcode objects to be maintained.

Client

Client-dependent matchcode objects can be maintained for a certain client or for all clients. The default value is the logon client.

If this parameter is not changed, the matchcodes are only maintained in the corresponding client. All other clients remain unchanged.

If a matchcode is to be maintained in a client which is not the same as the logon client, the corresponding client code must be entered. If "*" is entered, a matchcode is constructed in all clients.

Function

You can select a function to be executed by the matchcode utility. This function is executed for all the matchcode IDs or for selected matchcode IDs. There is a corresponding query later on.

The following functions are possible:

A function is standardly entered when the matchcode utility is called from the Maintain Matchcode Object (Attributes) display. If necessary, you can overwrite the standard entry.

When you call Utilities -> Matchcode data ->:

With background processing

The functions of the matchcode utilities can be executed online or in the background. If an 'X' is entered, the function is executed in the background, otherwise online.

The name of the background task is: ASYN_MC_function_mconame (e.g. construction of the matchcode object DEBI: ASYN_MC_CRE_DEBI). A job repetition period can be defined in days for background processing.

Immediate background execution

If the selected function is processed in the background, the background job can be executed immediately or at a certain time. If execution is to be immediately, enter an 'X'. If no entry is made, you must define a start date in the next lines.

If a job repetition period is defined in days, the defined time of day is also valid for the job repetition.

Date for the background execution

Enter the planned execution date and the planned execution time of a background job here. Note that the construction of the matchcode records might possibly overload the system. In such cases it would be better to plan the background job for a time when the system is not so busy, e.g. at night.

Job repetition period in days

Period (days) for a background job. The background job is executed repeatedly at the same time after the given number of days.

Remark: The flow of matchcode construction is logged. The corresponding log name is SAPMACO MC objectname>. You can display this log in the screen Maintain Matchccode Object (Attributes) with Utilities -> Display log -> Construct MC.

Remark: A variant is generated for report RSMCBTCH for each job to be executed in the background. It has the name SAP_<function>_ <MC object name>. You can change the time scheduled for this background job using transaction SM37.

Status of the matchcode IDs

You can display the status of the individual matchcode IDs in the table TMCIR in the general table maintenance screen. Proceed as follows:

1. Go to the general table maintenance screen with System -> Utilities -> Table maintenance .
2. Enter TMCIR.
3. Select Table -> Display.

The data contained in the table TMCIR is displayed. The following status information can be displayed in the field MCID-St:

A constructed

N not constructed

D deleted

R construction is cancelled

L deleted for several clients

U undefined

If a matchcode ID has the status R, construction of the matchcode data can be restarted by selecting the function REC (restart) in the matchcode utility.

The table also tells you the number of constructed/deleted tuples, the start and end of such a process (begin function, end function). The table entry for the number of tuples is not changed for the necessary adjustments for matchcodes maintained synchronously or under program control.

You are also given information about records with deletion flags for matchcode IDs, the time stamp for the last deletion of a record with a deletion flag, the message number in case of an error and the time when the function modules were generated.

Flags of the constructed matchcode data

You can display the constructed matchcode data for a matchcode ID. Select the function Utilities -> Matchcode data -> Flags in the screen Maintain Matchcode Object (Attributes) .

A popup window appears listing all the IDs of the matchcode object. Select one of the IDs by marking the corresponding line and pressing the Choose pushbutton.

An interactive window appears in which you can limit the value range for the records to be output by entering selection conditions for the fields of the ID. Then press the Continue pushbutton. All the records which fit the defined selection condition are now listed.