XMLDG Project Website

The XMLDG (Dangerous Goods Manifest Submission with ebXML Message Service) project is a joint initiative between the Marine Department (MD) and Information Technology Services Department of the HKSAR Government and the Center for E-Commerce Infrastructure Development (CECID) of the University of Hong Kong. While helping to establish an ebXML Software Infrastructure in Hong Kong, the initiative aims to facilitate shipping companies to automate submission of Dangerous Goods (DG) Manifest to MD in the form of XML messages through the Internet using the ebXML messaging service protocol. In the course, XML document schema has been specified for the DG Manifest according to the International Maritime Organization's (IMO) recommendation. As a result, this project creates a new system-to-system submission channel in addition to the existing paper-based and web-based DG manifest submission channels being provided.


  1. Copyright & Limitation of Liability

  2. Frequently Asked Questions

  3. Documentation
  4. Related Software
  5. XMLDG XML Schema

  6. Sample DG Manifest XML File

  7. Testing Driver

  8. Presentation


All copyright in this Project Website ("Website") is owned by The Government of the Hong Kong Special Administrative Region ("Government").

All correspondence relating to this Website should be addressed to the Government.

As a consequence of the copyright, no person may reproduce this Website or any part thereof without the prior written permission of the copyright holder.

©The Government of the Hong Kong Special Administrative Region


The contents of this Website are provided for the information and use of all users of the Electronic Submission of Dangerous Goods Manifests Service (the Service), including vessel owners, agents and masters. All information contained in this Website is believed to be accurate but neither the copyright holder nor any person or organisation concerned in the preparation or publication of this Website accepts any liability of any nature whatsoever for any loss suffered either directly or indirectly as a consequence of the use by users of the Service or this Wesbite or any trading activity flowing therefrom. For full details of legal requirements related to the Service, it should refer to the section 4 of the Dangerous Goods (Shipping) Regulations.


  1. XMLDG Schema Specification (SS) (867KB)
  2. XMLDG Implementation Instructions (II) (670KB)
  3. XMLDG Technical Implementation References (TIR) (275KB)
  4. XMLDG Vocabulary Library User Guide (256KB)


  1. XMLDG Frequently Asked Questions (49 KB)


  1. XMLDG Vocabulary Library (2 MB)

  2. Hermes MSH version (24MB)
    For more details, please visit www.freebxml.org

  3. Hermes MSH Heartbeat Tools [for Hermes MSH] (6MB)
    * documentation is included in the zip file

    This is a tool that can send a loop back message to a MSH, check the response, and the result will write to a log. You can execute this tool as a scheduled job (e.g. runs every 1 hours). When the heartbeat is failed, it will send out an alert email. Also, the script is NOT necessary place under the same machine of MSH.

    Before execute this tool, please make the follow modification on hb.properties

    1. <ToMshUrl>
      change it to the URL of MSH that want to run Heartbeat

    2. msh.properties
      This is same as msh.properties.xml that inside DataHandler directory. <Request><Config><URL> should point to the MSH that want to run Heartbeat

    3. RunHeartbeat.sh
      change the "cd" path and the "Java" path

    4. heartbeat.pl
      modify $progPath, $logFile, $alertEmail
      Actually, you can modify this script that fit your environment and requirement

  4. Hermes MSH System Commander [for Hermes MSH] (5 MB)

    1. checkdb
      Check database connections

    2. resetdb
      Reset database connection pool

    3. suspend
      Suspend MSH

    4. term
      Terminate MSH and the send -ve ACK for all pending message

    5. resume
      Resume MSH

    6. backup
      Backup MSH files and database entries
      Guideline (71KB)

    7. restore
      Restore MSH from backup

    8. reportenv
      Report MSH environment

    9. checkfs
      Check persistent storage used by MSH

    10. archive
      Archive-related functions. Options and argument
            date Archive by date
                -s <start_date> The starting date of archive in (UTC)
                -e <end_date> The ending date of archive (UTC)
            appcontext Archive by application context
                <cpa_id> Application context CPA ID
                <conv_id> Application context Conversation ID
                <service> Application context Service
                <action> Application context Action
            delete Delete the archived messages.

    11. housekeep
      Housekeep startup files. Options and arguments
            delete Delete unreferenced startup files.

  5. Hermes MSH Webmin [for Hermes MSH]
    Technical References (930 KB)

    User Manual (200 KB)


  1. Download (zip)


  1. Sample "broken" DG Manifest XML files


  1. Shipping agent test driver [for Hermes MSH] (7.2 MB)

    This is a test driver for shipping agent to test their dangerous goods manifest submission. After receiving the manifest, a business acknowledge will be sent without processing the manifest document.

  2. Marine department test driver [for Hermes MSH] (7.2 MB)

    This is a test driver for marine department to test their data handler. This driver acts as a shipping agent. When the driver starts, it will send an ebXML message (including Credential and Dangerous goods manifest) periodically, and then wait for business acknowledgment. While creating the ebXML message, the Credential object is created at runtime and the manifest is read from a file.


  1. 2004.02.25 XMLDG Business Orientation Meeting (download)

Version : 1.0.1
Date : 2004.02.25


Website Change Log

2003.10.14 v1.0.0 first release
2004.02.25 v1.0.1 add 2004.02.25 meeting presentation