Chapter Contents

Previous

Next
FILEEXT=

FILEEXT=



Specifies how to handle file extensions when accessing members of partitioned data sets

Default: IGNORE
Valid in: configuration file, SAS invocation, OPTIONS statement, OPTIONS window
Category: File Control: EXTFILES
OS/390 specifics: all


Syntax
Details
Example of FILEEXT=VERIFY
Example of FILEEXT=IGNORE
Example of FILEEXT=ASIS

Syntax

FILEEXT=VERIFY | IGNORE | INVALID | ASIS

VERIFY
verifies that the part of the name after the period corresponds to the last level of the partitioned data set name.

IGNORE
ignores the part of the name after the period and specifies that only the part before the period is to be used.

INVALID
disallows any member name with an extension.

ASIS
accepts the member name as it is. These member names must conform to the naming conventions of partitioned data sets, as described below.


Details

For compatibility with SAS on other platforms, the FILEEXT= system option enables you to write portable SAS programs that will run on systems that support file extensions and on systems that do not support file extensions.

Portable SAS programs can access external files with file extensions when you run those programs in environments such as PC and UNIX. When you run those programs in OS/390, and when the program accesses members in partitioned data sets, the value of FILEEXT= determines how the file extensions are interpreted.

Member names in partitioned data sets must consist of one to eight alphanumeric characters starting with a letter or with one of the following national characters: $, #, @. A member name extension is an optional part of the member name that follows a period.


Example of FILEEXT=VERIFY

In this example, SAS verifies that the part of the name that follows the period corresponds to the last level of the partitioned data set name. If it does not, an error message is written to the SAS log:

options fileext=verify;

   /* allocate a PDS */
filename out2 'myid.fileext.sas' disp=old; 
data _null_;

      /* the member name is 'versas'*/
   file out2(versas.sas);
        put 'text';
run;


Example of FILEEXT=IGNORE

Using the IGNORE value causes the extension, if present, to be ignored:

options fileext=ignore;

   /* allocate a PDS */
filename out2 'myid.fileext.testsrc' disp=old;
 data _null_;

      /* the member name is 'dotnd' */
   file out2(dotnd.some);
   put 'text';
run;


Example of FILEEXT=ASIS

With the ASIS parameter, the member name is accepted as-is:

options fileext=asis;

   /* allocate a PDS */
filename out2 'myid.fileext.testsrc' disp=old;
data _null_;

      /* the member name is 'mem.as' */
   file out2(mem.as);
   put 'text';
run;


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.