Fonction SAP BAPI_XMI_ENTER_LOGMSG - Enter External Message in XMI Log

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
ARGTYPE1 BAPIXMLOGR-ARGTYPE1 C 1 'C' X Type of 1st message argument
ARGTYPE2 BAPIXMLOGR-ARGTYPE2 C 1 'C' X Type of 2nd message argument
ARGTYPE3 BAPIXMLOGR-ARGTYPE3 C 1 'C' X Type of 3rd message argument
ARGTYPE4 BAPIXMLOGR-ARGTYPE4 C 1 'C' X Type of 4th message argument
EXTUSER BAPIXMLOGR-EXTUSER C 16 X Tool user affected by the message
INTERFACE BAPIXMLOGR-INTERFACE C 3 X Interface affected by the message
MSGARG1 BAPIXMLOGR-MSGARG1 C 128 X 1st message argument
MSGARG2 BAPIXMLOGR-MSGARG2 C 128 X 2nd message argument
MSGARG3 BAPIXMLOGR-MSGARG3 C 128 X 3rd message argument
MSGARG4 BAPIXMLOGR-MSGARG4 C 128 X 4th message argument
MSGID BAPIXMLOGR-MSGID C 30 X Message ID in manufacturer namespace
MSGTEXT BAPIXMLOGR-MSGTEXT C 128 Standard message or text message
OBJECT BAPIXMLOGR-OBJECT C 50 X Object affected by the message

Paramètre Reférence Type Long. Description
RETURN BAPIRET2 u 548

Functionality
Use this method to enter a message in the XMI session log. The logcontains all sessions that are controlled with the XMI interfaceinterface or with the CCMS system administration interfaces.
The log has the following characteristics:

  • You can display the log within the R/3 System using Transaction RZ15.
    • The log can also be read by an external product for display. You canonly reorganize the log using Transaction RZ15.
    • Up to four arguments can be inserted into a message text.

    • If you have uploaded language-specific messages in the R/3 System, the
      • system displays the log in the user's logon language.
      • The XMI interface manages a filter setting (the audit level) for
        • recording messages in the log. If the filter setting specified usingthis method is smaller or equal to the setting in the XMI interface,the system logs the message. If not, the message is not included inlog. The audot level can be determined by the external product usingmethod SystemMngmtSession.SetAuditlevel.

        Further information
        XMI documentation (SAPnet/CCMS)

        Description
        INCLUDE BAPI_TABLE

        Value range
        MSG_NOT_LOGGED_ON: Noone has logged onto the R/3 System.
        MSG_CANT_LOG: the action had to be terminated because the R/3 XMIlogging mechansim reported an error.
        MSG_PROBLEM_DETECTED: A problem occurred in an XMI function modulesthat is not directly connected to the XMI functions. The problem wasprobably caused by a called function module. To analyze the problem,examine the R/3 System log.
        MSG_INVALID_PARAMETERS: The parameter values that are to be shown inthe message text were invalid. For example, a time stamp may notconform to UTC or the specified type does not come from the type list.

        Description
        Type of argument that is to be displayed in a message.

        Value range
        The following data types are permissible:

        • C: Character string

        • I: Integer

        • P: "Packed" decimal number

        • F: Floating point

        • U: UTC (time stamp in universal time code)

        • D: Date

        • T: Time

          • Description
          Type of argument that is to be displayed in a message.

          Value range
          The following data types are permissible:

          • C: Character string

          • I: Integer

          • P: "Packed" decimal number

          • F: Floating point

          • U: UTC (time stamp in universal time code)

          • D: Date

          • T: Time

            • Description
            Type of argument that is to be displayed in a message.

            Value range
            The following data types are permissible.

            • C: Character string

            • I: Integer

            • P: "Packed" decimal number

            • F: Floating point

            • U: UTC (time stamp in universal time code)

            • D: Date

            • T: Time

              • Description
              Type of argument that is to be shown in a message.

              Value range
              The following data types are permitted:

              • C: Character string

              • I: Integer

              • P: "Packed"-Dezimalziffer

              • F: Floating point

              • U: UTC (time stamp in universal time code)

              • D: Date

              • T: Time

                • Description
                The name of the user in the external system who is affected by themessage that is to be entered. The user name is included as part of themessage in the XMI log.

                Value range
                User name in the external system in clear text.

                Description
                Specify here the interface identification code that refers to themessage to be entered. The ID code is included as part of the message.

                Value range
                The CCMS system administration interface ID codes:

                • XBR (DB security)

                • XBP (Background processing)

                • XMB (Basic functions)

                • XOM (Output Management)

                • XDB (DB administration)

                  • Description
                  Argument that can be inserted into the message text. Up to fourarguments can be inserted in place of predefined variables in themessage text.

                  Description
                  Argument that can be inserted into the message text. Up to fourarguments can be inserted in place of predefined variables in themessage text.

                  Description
                  Argument that can be inserted into the message text. Up to fourarguments can be inserted in place of predefined variables in themessage text.

                  Description
                  Argument that can be inserted into the message text. Up to fourarguments can be inserted in place of predefined variables in themessage text.

                  Description
                  Enter here the message AD that is to be entered in the log.
                  You only need to specify the message ID if for the calling program,messages for the XMI log have been uploaded into the R/3 System.
                  The identification is used to display the message in differentlanguages, for example in Spanish if Spanish translations or messageshave been uploaded.

                  Value range
                  The ID is in the namespace that is assigned to the calling program.

                  Description
                  If the message in the required language does not exist in the R/3System, here you can specify a standard version of the message.
                  The standard version should be in English. If the message containsvariables, these variables should be replaced in the standard versionby the values to be displayed.

                  Value range
                  English standard version of the message in clear text.

                  Description
                  Enter here an object name of your choice that can be used as the searchterm or to classify the message that is to be entered. The object nameis included as part of the message.

                  Value range
                  Freely-selectable text that can be used as a search term.
                  Choose the object name according to the following pattern, whereby thecomponents should be comnined in a character string using CONCATENATE:
                  :
                  Examples:
                  JOB: /
                  APPSERVER: