Special-Purpose Engines

The character variable padding (CVP) engine expands character variable lengths, using a specified expansion amount, so that character data truncation does not occur when a file requires transcoding. Character data truncation can occur when the number of bytes for a character in one encoding is different from the number of bytes for the same character in another encoding, such as when a single-byte character set (SBCS) is transcoded to a double-byte character set (DBCS) or a multi-byte character set (MBCS).

The CVP engine is a read-only engine for SAS data files only. You can request character variable expansion by either of the following methods:

For more information about using the CVP engine to avoid character data truncation and for details about the CVP engine options in the LIBNAME statement, see SAS National Language Support (NLS): Reference Guide.

The new SAS Information Maps LIBNAME Engine provides a read-only way to access data generated from a SAS Information Map and to bring it into a SAS session. Once you retrieve the data, you can run almost any SAS procedure against it.

To use the Information Maps engine, specify INFOMAPS as the engine name, along with specific arguments and options in the LIBNAME statement.

For information about how to use the Information Maps engine, see Base SAS Guide to Information Maps.

The SAS JMP LIBNAME engine enables you to read and write JMP files in a Base SAS session. A JMP file is a file format that the JMP software program creates. JMP is an interactive statistics package that is available for Microsoft Windows and Macintosh. For more information about a JMP concept or term, see the JMP documentation that is packaged with your system.

To use the JMP engine, specify JMP as the engine name, along with the location of a SAS library in the LIBNAME statement. For example, the following code reads and prints five observations from the JMP file Baseball.jmp:

libname b jmp 'c:\JMP\SampleData';

proc print data=b.baseball (obs=5);
run;

For information about how to use the JMP engine, see LIBNAME Statement for the JMP Engine in SAS/ACCESS Interface to PC Files: Reference.

The metadata engine accesses metadata that is stored on the SAS Metadata Server within a specific SAS Metadata Repository. The metadata is information about the structure and content of data, and about the applications that process and manipulate that data. The metadata contains details such as the location of the data and the SAS engine that is used to process the data.

The metadata engine works in a similar way to other SAS engines. That is, you execute a LIBNAME statement in order to assign a libref and specify an engine. You then use that libref throughout the SAS session where a libref is valid. However, instead of the libref being associated with the physical location of a SAS library, the metadata libref is associated with specific metadata objects that are stored in a specific repository on the metadata server. The metadata objects define the SAS engine and options that are necessary to process a SAS library and its members.

When you execute the LIBNAME statement for the metadata engine, the metadata engine retrieves information about the target SAS library from the metadata. The metadata engine uses this information in order to construct a LIBNAME statement for the underlying engine and assigns it with the appropriate options. Then, when the metadata engine needs to access your data, the metadata engine uses the underlying engine to process the data.

You invoke the metadata engine by explicitly specifying the engine name META, along with specific arguments and options for the metadata engine (for example, in the LIBNAME statement or in the New Library window).

For information about how to use the metadata engine, see SAS Language Interfaces to Metadata.

The SAS XML LIBNAME engine imports an XML document as one or more SAS data sets and exports a SAS data set as an XML document.

To use the XML engine, specify either the XML or XMLV2 engine nickname, along with specific arguments and options (for example, in the LIBNAME statement or in the New Library window).

For information about how to use the XML engine, see the SAS XML LIBNAME Engine: User's Guide.