MORGAM logo

Data transfer format: Whole blood

  • Form: 42
  • Version: 3
  • Date: 2008-10-28

Valid HTML 4.01!
© National Institute for Health and Welfare and the MORGAM Project investigators
Last updated: 28 October 2008
For more information, please contact Päivi Laiho (firstname.lastname@thl.fi) or Kari Kuulasmaa (firstname.lastname@thl.fi)

The purpose of this transfer format is to provide an exact and common format for the MORGAM Participating Centres (MPCs) to transfer data on blood samples to the MORGAM Central Laboratory (MCL). The transfer of the data should precede the transfer of whole blood from the MPC to the MORGAM Central Laboratory (MCL). If you are transferring DNA which have already been extracted, then you should use Form48 or Form49 instead of this form.

Data in the format specified here should be submitted for every subject on whom whole blood will be sent to MORGAM Central Laboratory (see Form 40). These data should be submitted before or at the time of the shipment of the actual DNA material. The data in this form should be sent through e-mail. The MCL will share the data with the MORGAM Data Centre (MDC) .

Contents



Format specification

NAME SPECIFICATION AND CODES FORMAT or Value
FORM Form number I2 |4|2|
VERSION Version of this form I1 |3|
FROM The sender of the sample material I3 |_|_|_|
KEY0 Identification of the sample printed on the tube
8888888 = irrelevant (the tube is not available in MPC)
C20 free text
KEY1 Identification of individual in MORGAM study:
CENTRE + RUNIT + COHORT + SERIAL
C12 |_|_||_|_||_|_||_|_|_|_|_|_|
AVAIL Availability of the sample
1 = yes
2 = no
I1 |_|
REASON Reason of unavailability of the sample (AVAIL = 2) C100 free text
ORIGINAL_TYPE Type of sample
1 = whole blood
2 = buffy coat
3 = erythrocytes
4 = other
8 = irrelevant (AVAIL = 2)
I1 |_|

Information  on the sample

ANTICOA Type of anticoagulant of the sample
1 = EDTA
2 = heparin
3 = ACD
4 = other
8 = irrelevant (AVAIL = 2)
9 = unknown
I1 |_|
DATE_DRAWING Date of sample drawing:
YYYYMMDD (year month day)
77777777 = same as DEXAM of Form 20
88888888 = irrelevant (AVAIL = 2)
99999999 = unknown
C8 |_|_|_|_||_|_||_|_|
ORIGINAL_TEMP Storage temperature (°C) (e.g. "-80")
888 = irrelevant (AVAIL = 2)
999 = unknown
C3 |_|_|_|
VOLUME Volume of the sample (ml)
888 = irrelevant (AVAIL = 2)
I3 |_|_|_|

Location of the sample in the transfer package

BOX Box number in the shipment I4 |_|_|_|_|
LOCATION Location of the sample in the box (co-ordinates) C20 free text
COMMENT Comments (if any) on this sample C100 free text


General Instructions

The item NAME on the document is a computer variable name used for the item by the MDC.

The item FORMAT specifies the format in which the value should be presented in the transfer data set:

FORMAT Type Format Example Comments
C Character C8 19991210 Used for dates, trailing zeroes are obligatory
C20 "B 17 E" Location of sample in a box, surrounded with double quotes (") if contains spaces. Free text, maximum 20 characters is allowed for this variable.
C3 -80 Storage temperature, includes leading '-' sign
F Float F5.2 13.1
2.18
Variable must include a decimal point (.). Leading and trailing zeroes are not obligatory.
I Integer I3 1
15
180
Leading zeroes are not obligatory

Instructions for making corrections to data that have already been sent to the MDC are given in Section Data communication between the Participating Centres and the MDC.

Please contact the MDC for instructions if you cannot provide information as specified in this document or if you have any problems with the interpretation of the coding for any specific items.


Specific instructions for each item

Follow these instructions carefully when creating a computer file for the data transfer from the MPC to the MDC.

To the top of the form

FORM Form number I2 |4|2|

Number 42 indicates the "Data transfer format: DNA transfer inventory - whole blood".

To the top of the form

VERSION Version of this form I1 |2|

Current version of this data transfer format. If the version number of the data transfer format which you are using is not "2", these instructions do not correspond to the format you are using. Version number changes if some major changes are introduced in the form, for example adding / deleting some variables.

To the top of the form

FROM The sender of the sample material I3 |_|_|_|

Enter appropriate code of your MPC or laboratory from the list of MORGAM centres for DNA transfer. In most cases the sender will be the MPC, but in some cases the MPCs (or possibly many of them) are served by a separate laboratory (e.g. MPCs 34, 54, 55 and 59 are all served by laboratory 912 in Paris). If your laboratory is not directly connected to your MPC, and the laboratory is not listed in the list of MORGAM centres for DNA transfer, please contact the MDC for a code for your laboratory.

To the top of the form

KEY0 Identification of the sample printed on the tube C20 free text

This is the local key on the label fixed on the tube. If the local key includes a personal identification, additional measures should be taken to secure the confidentiality of the person, as specified in the subsection on section DNA Collection Procedure of the MORGAM Manual.

It is important that there are no misprints in this entry because otherwise the genotype derived from the sample will be lost or connected to a wrong individual's phenotypic data.

To the top of the form

KEY1 Identification of individual in MORGAM study (CENTRE RUNIT COHORT SERIAL) C12 |_|_||_|_||_|_||_|_|_|_|_|_|

This is the primary key identifying the individual in the MORGAM database. The first 2 characters correspond to the Form 20 item CENTRE, the next 2 characters correspond to RUNIT, the next 2 to COHORT and the last 6 characters correspond to item SERIAL.

It is important that there are no misprints in this entry because otherwise the genotype derived from the sample will be lost or connected to a wrong individual's phenotypic data.

To the top of the form

AVAIL Availability of the sample
1 = yes
2 = no
I1 |_|

This form should be completed for every subject on whom DNA was requested by the MDC (see Form 40). Enter 1 if the sample for the subject will be sent to the MORGAM Central Laboratory (MCL), and enter 2 if it not.

If AVAIL was coded as 2, the reason for the unavailability of the sample should be described in REASON. If there is a need to give more detailed information, report it to the MDC in a separate e-mail message.

To the top of the form

REASON Reason of unavailability of the sample C100 free text

Describe here a reason why sample was unavailable. If there is a need to give more detailed information, report it to the MDC in a separate e-mail message.

To the top of the form

ORIGINAL_TYPE Type of sample
1 = whole blood
2 = buffy coat
3 = erythrocytes
4 = other
8 = irrelevant (AVAIL = 2)
I1 |_|

Enter the type of the sample being transferred. If you are transferring extracted DNA, then you should use Form48 or Form49 instead of this form.

To the top of the form

ANTICOA Type of anticoagulant of the sample
1 = EDTA
2 = heparin
3 = ACD
4 = other
8 = irrelevant (AVAIL = 2)
9 = unknown
I1 |_|

Enter the type of anticoagulant used for the sample. If anticoagulant is "other" then check that its full description was provided on Form 41: DNA Sample Information Form, § 3.3-2.

To the top of the form

DATE_DRAWING Date of sample drawing
YYYYMMDD (year month day)
77777777 = same as DEXAM of Form 20
88888888 = irrelevant (AVAIL = 2)
99999999 = unknown
C8 |_|_|_|_||_|_||_|_|

Enter the date of drawing of the sample. If the exact date is unknown, an approximate date (e.g. the year) should be given if available. If only the month and year are known, enter 99 for the days. If only the year is known, enter 9999 for the month and the days.


This item can be coded as 77777777 if the date is the same as the date of examination given in the MONICA Survey data (item DEXAM of Form 20).

To the top of the form

ORIGINAL_TEMP Storage temperature (°C) (e.g. "-80")
888 = irrelevant (AVAIL = 2)
999 = unknown
C3 |_|_|_|

Enter the temperature (in degrees Celsius) at which the sample was stored.  Enter the "-" in the first column to indicate a temperature below zero.
If the sample was stored at different temperatures, give here the highest temperature of a long term storage. E.g., if the sample was first stored for 5 years at -80ºC and the 2 years at  -20ºC, then enter here "-20".

To the top of the form

VOLUME Volume of the sample (ml)
888 = irrelevant (AVAIL = 2)
I3 |_|_|_|

Enter here the volume of the sample that will be sent to the MCL.

To the top of the form

BOX Box number in the shipment I4 |_|_|_|_|

Enter the number written on the box in which the sample is sent to the MCL.

To the top of the form

LOCATION Location of the sample in the box (co-ordinates) C20 free text

Enter here the co-ordinates of the sample in the box. Make sure that the co-ordinates are also identifiable in the box.

To the top of the form

COMMENT Comments (if any) on this sample C100 free text

If you have any comments on the sample, please enter them here.


Data transfer Instructions

The data should be prepared in ASCII comma-delimited format using semicolon (;) as delimiter, with the names of the variables in the first row. If the value of a variable contains text with delimiter used inside the text then the value should be surrounded by double quotes ("). A dot (.) shold be used as a decimal point.

To simplify the tracing of data transfers between the MPC and the MDC, the files should be named as follows:

MPCXX_YYYYMMDD_N.CSV, where:

To avoid possible errors in variable naming use the first row from the example below containing variable names. Example of Form 42 ASCII comma-delimited data file:

form;version;from;key0;key1;original_type;anticoa;date_drawing;original_temp;volume;box;location;comments
42;2;99;12345;990121123456;1;1;9;99999999;-70;4;9999;999;
42;2;99;12346;990121123457;2;1;9;99999999;999;999;9999;999;no blood (empty tube)
42;2;99;12347;990121123458;1;1;9;99999999;-70;4;9999;999;

The data files should be archived (ZIP) before sending them to the MDC. The archive names should be the same as the file names. MORGAM data Error checking program will be used to prepare data (will be available later). The data should be sent to the MDC (Zygimantas Cepaitis (firstname.lastname@thl.fi)) as an attachment to an e-mail message. Please make sure to save a copy of the transferred files in the sending MPC or laboratory.

When the data are received in the MDC, an acknowledgement will be sent to the sender. Then the data will be checked for consistency and quality, and after any problems have been resolved, they will be entered into the MORGAM database.