Was this helpful?
iiimport Command--Import Application Components
The iiimport command copies application components from an intermediate file into an existing application. The intermediate file, created by iiexport, contains the definitions for the components you specified when you ran iiexport. See the description of iiexport for the types of components you can copy.
When you import a component, the iiimport command assumes that the component exists in the application, and revises the existing version of the component. When you import a frame, the existing frame definition, including local components and Escape code, is replaced with the new definition. The iiimport command does not change menu items for a frame, except for user-defined menu items included with Escape code. See How Dependencies Are Handled for information on how iiimport handles menu items and other dependent components.
You can check whether a component exists in the target application by using the -check option. Running iiimport with the -check flag does not actually copy or replace any components, but reports on the status of the components in the target application.
If a Vision frame does not exist in the target application, iiimport copies the frame but does not incorporate the frame into the Application Flow Diagram. From the Application Flow Diagram, you can use the Insert option to include the frame at the desired location.
You can import a component that does not exist in the target application, but the target application itself must exist. To copy an entire application into a database, use the copyapp utility.
All components copied in are assigned to the owner of the target application.
This command has the following format:
iiimport dbname appname [-intfile=filename] [-listing=filename]
     [-user=username] [-check | -copysrc] [-dropfile]
dbname
Specifies the database from which the component is being copied
appname
Specifies the application from which the component is being copied
-intfile=filename
Specifies the intermediate file created by iiexport. The filename can be the full pathname of the file. If you specify the -intfile flag, you must indicate a file name. If you do not specify the -intfile flag, iiexport names the intermediate file iiexport.tmp.
-listing=filename
Specifies a file that lists the names of the source files for each frame copied. If you specify the -listing flag, you must indicate a file name. If -listing is not specified, Vision does not create a listing file.
-user=username
Runs the command as the user specified by username.
To use this option, you must be a privileged user.
If you are using Enterprise Access products, refer to your Enterprise Access documentation before using this parameter.
-frame=name{,name}
Indicates the name of one or more frames to be copied
-proc=name{,name}
Indicates the name of one or more procedures to be copied
-record=name{,name}
Indicates the name of one or more record types to be copied
-global=name{,name}
Indicates the name of one or more global variables to be copied
-constant=name{,name}
Indicates the name of one or more global constants to be copied
-allframes
Indicates that all frames must be copied from the application
-allprocs
Indicates that all procedures must be copied from the application
-allrecords
Indicates that all record types must be copied from the application
-allglobals
Indicates that all global variables must be copied from the application
-allconstants
Indicates that all global constants must be copied from the application
Last modified date: 08/14/2024