02.05.2013 Views

SAS(R) 9.1.3 Companion for z/OS

SAS(R) 9.1.3 Companion for z/OS

SAS(R) 9.1.3 Companion for z/OS

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Syntax<br />

Statements under z/<strong>OS</strong> LIBNAME Statement 393<br />

LIBNAME libref < engine/host-options>;<br />

LIBNAME libref <br />

;<br />

LIBNAME libref | _ALL_ CLEAR;<br />

LIBNAME libref | _ALL_ LIST;<br />

Details<br />

The LIBNAME statement can be used to assign a <strong>SAS</strong> data library, release a library<br />

assignment, or display a list of all library assignments. The LIBNAME function<br />

provides similar functionality. See “LIBNAME Function” on page 268 <strong>for</strong> more<br />

in<strong>for</strong>mation.<br />

Assigning a Library The LIBNAME statement allows you to identify a data library to<br />

<strong>SAS</strong>, specify which engine <strong>SAS</strong> should use to process the library, and identify the z/<strong>OS</strong><br />

resources required to process the library. For a complete discussion of assigning<br />

libraries, see “Assigning <strong>SAS</strong> Data Libraries” on page 53. For direct or sequential access<br />

bound libraries, the LIBNAME statement can be used to specify the options necessary<br />

to allocate the library data set. For detailed in<strong>for</strong>mation about z/<strong>OS</strong> allocation as it<br />

relates to <strong>SAS</strong> data libraries, see “Allocating the Library Data Set” on page 53.<br />

LIBNAME Statement Forms <strong>for</strong> Assigning Libraries<br />

The <strong>for</strong>m of the LIBNAME statement used to assign a <strong>SAS</strong> data library is described<br />

below. See “Examples of Assigning a Library” on page 399 <strong>for</strong> more in<strong>for</strong>mation.<br />

LIBNAME libref ;<br />

LIBNAME libref <br />

;<br />

libref<br />

is a <strong>SAS</strong> name that identifies the library. The libref can be a maximum of eight<br />

characters. The first character must be a letter (A–Z) or an underscore. The<br />

remaining characters can be any of these characters or numerals 0–9. This libref<br />

is used to reference the library throughout <strong>SAS</strong>.<br />

If the libref specified is already assigned, <strong>SAS</strong> deassigns the libref be<strong>for</strong>e<br />

per<strong>for</strong>ming the assignment specified.<br />

Note: <strong>SAS</strong> System 9 <strong>for</strong> z/<strong>OS</strong> supports libref names that begin with or contain<br />

underscores. For example, libref names with <strong>for</strong>mats such as libref_name,<br />

_librefname, or _libref_name are now supported.<br />

Unlike filerefs, librefs cannot include the special characters $, @, and #. R<br />

engine<br />

specifies which engine to use to access the <strong>SAS</strong> data library.<br />

For a list of some of the native library engines that can be specified on the<br />

LIBNAME statement, see “<strong>SAS</strong> Library Engines” on page 36. For general<br />

in<strong>for</strong>mation about these and other engines, see “<strong>SAS</strong> Engines” in <strong>SAS</strong> Language<br />

Reference: Concepts.<br />

It is generally necessary to specify the engine only when creating a library that<br />

will be processed by an engine other than the default engine that is indicated by

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!