DESCRIPTION 1 (5) MAIL-2-TRACY USER GUIDE This document replaces revision D of this document. Abstract This document describes the use of MAIL-2-TRACY to transfer tracability data from Contract Manufacturers ( CM ) to the Ericsson central tracability database TRACY. This document does not cover the interface between the local system Bartrack and TRACY. Please ask the supplier for Bartrack (Prevas AB) for information about Bartrack. The interface between the CM and Ericsson is built on email. The email sent from the CM will be processed automatically by the MAIL-2-TRACY server. A message will be returned from the MAIL-2-TRACY server to acknowledge that the tracability data has been received by Ericsson. This message will always be sent back to the original sender. Results from request and subscriptions will also be sent to the CM using the Mail-2-TRACY server.
DESCRIPTION 2 (5) 1 FORMAT OF THE TRACABILITY (TRACY) FILE The file sent to MAIL-2-TRACY shall follow the format defined for tracability files as described in the Ericsson Corporate Standard document Transmission of Information on Individual Marking to the central Data Base TRACY (Ericsson document no 160 02-CRL 107 028 Uen). All records types may be mixed in the same transfer, if needed. The files with the TRACY information should have unique names as they are saved as a backup in MAIL-2-TRACY. Max length of file name = 30! 2 MAIL FORMAT Depending on the platform used at the client side, a number of differentmethods and tools may be used to transfer the TRACY file to Ericsson. The table below gives an overview of this for three different client types : Client typ Direction File compression tool Mail encoding PC / Windows To Ericsson PKZIP / WinZip MIME attachment PC / Windows From Ericsson PKZIP / WinZip MIME attachment UNIX To Ericsson Compress or ZIP uuencode UNIX From Ericsson Compress or ZIP uuencode OpenVMS To Ericsson ZIP MFTU OpenVMS From Ericsson ZIP MFTU 2.1 NOTES ABOUT THE PC CLIENT TYPE Before being sent, the file should be compressed by PKZIP or WinZip. Note that gzip will not work and should be avoided. When sent, the ZIP file shall be attached to the mail as a MIME compliant BASE64 encoded attachment (standard attachment format in most mail client tools, such as Microsoft Outlook). Each ZIP file should contain just one (1) TRACY file. Each mail should contain just one (1) ZIP file.
DESCRIPTION 3 (5) 2.2 NOTES ABOUT THE UNIX CLIENT TYPE The Compress/Uncompress and UUencode/UUdecode tools are standard tools included in most or all different UNIX implementations. ZIP can also be used instead of Compress. Since there may be minor differences between UNIX es, some testing may be needed to verify that all is working as expected. Each compressed file should contain just one (1) TRACY file. Each mail should contain just one (1) compressed file. 2.3 NOTES ABOUT THE OPENVMS CLIENT TYP ZIP and UNZIP is the version of ZIP/UNZIP that is ported to OpenVMS. (Note that this is not the same tool as the gzip. gzip should not be used.) MFTU (Mail File Transfer Utility) is a tool for OpenVMS that codes binary files in a way so they can be sent by email. Each ZIP file should contain just one (1) TRACY file. Each mail should contain just one (1) ZIP file.
DESCRIPTION 4 (5) 3 THE SUBJECT OF THE MAIL The Subject of the mail should include a string consisting of the site code and the text -FILE. E.g. if the site code is A01, the Subject must include A01-FILE. It could include other text, but the string as described above must also be included in the subject. N.B. Do not replace the text -FILE with the actual filename in the mail! 4 MAIL ADDRESS The mail shall be sent to: m2t@npbcg1.ericsson.se 5 RESULT MAIL When the mail have been processed by the MAIL-2-TRACY server, a result mail with a log is returned to the sender of the mail. An example of one of this messages follows: 2001-11-05 23:21 Processing of MAIL-2-TRACY started... 2001-11-05 23:21 Mail received from : [mail address] 2001-11-05 23:21 Subject of mail : [file name} 2001-11-05 23:21 Site code : [site code] 2001-11-05 23:21 (Using new TRACY format) 2001-11-05 23:21 Unique ID : 2001110523210785 2001-11-05 23:21 Bartrack ID : 2001110516053372 2001-11-05 23:21 Processing of file TRCY2001110516053372.SAV started... 2001-11-05 23:21 Number of E-records in file : 10 2001-11-05 23:21 Transferred to TRACY OK. 2001-11-05 23:21 File TRCY2001110516053372.SAV sent... 2001-11-05 23:21 Processing of MAIL-2-TRACY ended... -------------------------------------------------------- Any questions about Mail-2-TRACY can be forwardedto: m2t_support@npbcg1.ericsson.se Regards Mail-2-TRACY operations. -------------------------------------------------------- The actual content of this message may vary depending on the content of the file sent to Ericsson. The texts [mail address], [site code], [file name] are replaced with values from the actual transfer. There may be one or more lines with Number of?-records in file : nnn depending on the record types sent in the TRACY file. The text Transferred to TRACY OK shows that all has been processed successfully.
DESCRIPTION 5 (5) The Unique ID : is used to identify each transfer and may be used in communications with the Mail-2-TRACY support at Ericsson to make fault tracing easier. 6 REQUEST ANSWER When sending Y-records, a mail will be sent back to the sender with the basic individual information that corresponds to the actual Y-records. The subject of the mail will be TRACY-file <site> <Unique-ID>, where <site> is the actual site code and <Unique-ID> is the same unique ID as in the Result mail described in chapter 4. The TRACY file will be coded according to the table in chapter MAIL FORMAT depending on the client type of the actual site. 7 SUBSCRIPTIONS External sites that have subscriptions set up in TRACY to receive tracability information from other sites, will get this as emails coded according to the table in chapter MAIL FORMAT depending on the client type of the actual site. 8 GETTING HELP 8.1 SUPPORT. Problems and other questions regarding the use of MAIL-2-TRACY, may be sent the MAIL-2-TRACY support mail address. See mail address below. Problems or questions regarding tracability in general or other matters regarding the business relation between the Contract Manufacturer and Ericsson, must be directed through proper channels, not through the support mail address mentioned below. Matters about MAIL-2-TRACY may be sent (by the local contact person) to : m2t_support@npbcg1.ericsson.se Specify the following in the mail : The Unique ID :, if available. Your site code. A description of the actual problem or question. The name of the file transmitted and when the original mail was sent.