Chapter Contents

Previous

Next

PROC CIMPORT Statement

To do this			Use this option
Identify the input transport file
	Specify a previously defined fileref or the filename of the transport file to read		INFILE=
	Read the input transport file from a tape		TAPE
Select files to import
	Exclude specified entry types from the import process		EET=
	Specify entry types to import		ET=
Control the contents of the transport file
	Specify whether to extend by 1 byte the length of short numerics (less than 8 bytes) when you import them		EXTENDSN=
	Specify that only data sets, only catalogs, or both, be moved when a library is imported		MEMTYPE=
Enable access to a locked catalog			FORCE
Create a new catalog for the imported transport file, and delete any existing catalog with the same name			NEW
Import SAS/AF PROGRAM and SCL entries without edit capability			NOEDIT
Suppress the importing of source code for SAS/AF entries that contain compiled SCL code			NOSRC

Required Arguments

destination=libref | < libref. >member-name

identifies the type of file to import and specifies the specific catalog, SAS data set, or SAS data library to import.

destination

identifies the file or files in the transport file as a single catalog, as a single SAS data set, or as the members of a SAS data library. The destination argument can be one of the following:

	CATALOG | CAT | C
	DATA | DS | D
	LIBRARY | LIB | L

libref | <libref. > member-name

specifies the specific catalog, SAS data set, or SAS data library as the destination of the transport file. If the destination argument is CATALOG or DATA, you can specify both a libref and a member name. If the libref is omitted, PROC CIMPORT uses the default library as the libref, which is usually the WORK library. If the destination argument is LIBRARY, specify only a libref.

Options

EET=(etype(s))

excludes specified entry types from the import process. If the etype is a single entry type, then you can omit the parentheses. Separate multiple values with spaces.

Interaction:

You cannot specify both the EET= option and the ET= option in the same PROC CIMPORT step.

ET=(etype(s))

specifies the entry types to import. If the etype is a single entry type, then you can omit the parentheses. Separate multiple values with spaces.

Interaction:

You cannot specify both the EET= option and the ET= option in the same PROC CIMPORT step.

EXTENDSN=YES | NO

specifies whether to extend by 1 byte the length of short numerics (fewer than 8 bytes) when you import them. You can avoid a loss of precision when you transport a short numeric in IBM format to IEEE format if you extend its length. You cannot extend the length of an 8-byte short numeric.

Default:	YES
Restriction:	This option applies only to data sets.
Tip:	Do not store fractions as short numerics.

FORCE

enables access to a locked catalog. By default, PROC CIMPORT locks the catalog that it is updating to prevent other users from accessing the catalog while it is being updated. The FORCE option overrides this lock, which allows other users to access the catalog while it is being imported, or allows you to import a catalog that is currently being accessed by other users.

CAUTION:

The FORCE option can lead to unpredictable results. The FORCE option allows multiple users to access the same catalog entry simultaneously.  

INFILE=fileref | 'filename'

specifies a previously defined fileref or the filename of the transport file to read. If you omit the INFILE= option, then PROC CIMPORT attempts to read from a transport file with the fileref SASCAT. If a fileref SASCAT does not exist, then PROC CIMPORT attempts to read from a file named SASCAT.DAT.

Alias:	FILE=
Featured in:	Importing an Entire Data Library .

MEMTYPE=mtype

specifies that only data sets, only catalogs, or both, be moved when a SAS library is imported. Values for mtype can be

ALL

both catalogs and data sets

CATALOG | CAT

catalogs

DATA | DS

SAS data sets

NEW

creates a new catalog to contain the contents of the imported transport file when the destination you specify has the same name as an existing catalog. NEW deletes any existing catalog with the same name as the one you specify as a destination for the import. If you do not specify NEW, and the destination you specify has the same name as an existing catalog, PROC CIMPORT appends the imported transport file to the existing catalog.

NOEDIT

imports SAS/AF PROGRAM and SCL entries without edit capability.

You obtain the same results if you create a new catalog to contain SCL code by using the MERGE statement with the NOEDIT option in the BUILD procedure of SAS/AF Software.

Note:   The NOEDIT option affects only SAS/AF PROGRAM and SCL entries. It does not affect FSEDIT SCREEN and FSVIEW FORMULA entries.  

Alias:

NEDIT

NOSRC

suppresses the importing of source code for SAS/AF entries that contain compiled SCL code.

You obtain the same results if you create a new catalog to contain SCL code by using the MERGE statement with the NOSOURCE option in the BUILD procedure of SAS/AF Software.

Alias:	NSRC
Interaction:	PROC CIMPORT ignores the NOSRC option if you use it with an entry type other than FRAME, PROGRAM, or SCL.

TAPE

reads the input transport file from a tape.

Default:

PROC CIMPORT reads from disk.

Chapter Contents

Previous

Next

Top of Page

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