SAP ABAP IMG Activity /AIN/VC_DCMSGMAP (Define Device Controller Types)
Hierarchy
☛ AIN (Software Component) AIN 710: Add-On Installation
   ⤷ AIE-AII (Application Component) Infrastructure
     ⤷ /AIN/IF (Package) Auto-ID Interfaces
IMG Activity
ID /AIN/VC_DCMSGMAP Define Device Controller Types  
Transaction Code /AIN/38000007   (empty) 
Created on 20040514    
Customizing Attributes /AIN/VC_DCMSGMAP   Device Settings 
Customizing Activity /AIN/VC_DCMSGMAP   Device Settings 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name /AIN/VC_DCMSGMAP    

    Use

In this IMG activity you define device controller types as well as mappings for different message types per device controller type.

The device controller type defines some particular manufactured controller and contains logic to define message mapping to internal SAP Auto-ID Infrastructure (SAP AII) messages. You can see the delivered messages on the SAP Easy Access screen under Tools -> ABAP Workbench -> Development -> Programming Environment -> Messages.

You must define a unique message pattern for each device controller type. Different methods exist to define such a pattern for XML messages and for some kinds of binary messages. Keep the following rules in mind:   

  • For XML Messages:
    • XML messages issued by devices should be well formed and conform to W3C recommendations (http://www.w3.org/TR/REC-xml)
    • The field External Message Name should contain the XML message name
    • The field External Message Namespace should contain the XML namespace, which should be a uniquely defined XML
  • For other kinds of messages:
    • The field External Message Name should contain a string which uniquely identifies the message type. In cases where the length of the field external message name is not enough, the field External Message Namespace can be used for rest of string.

Each mapping is an ABAP class that implements interface /AIN/IF_DCMSG_MAPPING with methods for converting:

  • External messages (received by the SAP AII communication layer) into activities
  • Activities into external messages

Interface /AIN/IF_DCMSG_MAPPING also contains needed constants to deal with messages and to build activities.

Activities

To create new device controller type:

  1. Enter a device controller type
  2. Enter a description for the device controller type

To create a new message mapping

  1. Select the device controller type
  2. Select Message Mapping
  3. Choose New Entries
  4. Enter the device controller type
  5. Enter the message name
  6. Enter a unique message pattern (using rules mentioned above)
  7. Enter a mapping class name

Business Attributes
ASAP Roadmap ID 105   Define functions and processes 
Mandatory / Optional 2   Optional activity 
Critical / Non-Critical 1   Critical 
Country-Dependency A   Valid for all countries 
Assigned Application Components
Documentation Object Class Documentation Object Name Current line number Application Component Application Component Name
SIMG /AIN/VC_DCMSGMAP 0 /AIN/R1D0000005 Device Integration 
Maintenance Objects
Maintenance object type C   Customizing Object 
Assigned objects
Customizing Object Object Type Transaction Code Sub-object Do not Summarize Skip Subset Dialog Box Description for multiple selections
/AIN/VC_DCMSGMAP C - View cluster SM34  
History
Last changed by/on SAP  20050309 
SAP Release Created in 200