The CDF_SET_CDF27_BACKWARD_COMPATIBLE procedure allows users of IDL version 6.3 and later to create a CDF file that can be read by IDL 6.2 or earlier, or by CDF version 2.7.2 or earlier. By default, a CDF file created by IDL 6.3 or later cannot be read by earlier versions.

This procedure must be called prior to calling the CDF_CREATE function. It is useful if you need to create and share CDF files with colleagues who access CDF files using IDL version 6.2 or earlier, or using the CDF library version 2.7.2 or earlier.

In CDF version 2.7.2 and earlier, the maximum CDF file size was 2 Gbytes. This limitation was lifted in CDF version 3.0 with the use of a 64-bit file offset. As a result, users who use a CDF library older than CDF version 3.0 cannot read CDF files that were produced by CDF version 3.0 or a later release. CDF versions 3.0 and later can read files that were generated with any of the previous CDF releases.

Note: After calling this routine, the “backward compatible” setting specified persists either until this routine is called again or until the end of the IDL session.

Examples


Use the following command to create a CDF file that can be read by IDL 6.2 or earlier IDL versions.

CDF_SET_CDF27_BACKWARD_COMPATIBLE, /YES
id = CDF_CREATE('myfile.cdf')
CDF_CLOSE, id

Syntax


CDF_SET_CDF27_BACKWARD_COMPATIBLE [, /YES | /NO]

Arguments


None

Keywords


YES

Set this keyword to create a CDF file that can be read by IDL version 6.2 or earlier, or by CDF version 2.7.2 or earlier. If this keyword is set, the maximum file size is 2 Gbytes.

NO

Set this keyword to create a file that can only be read using IDL version 6.3 or later or CDF version 3.0 or later. This is the default when a CDF file is created.

Version History


6.3

Introduced