dtexport command

Purpose

Exports application objects into application or partial-export packages.

Prerequisites

• You must be logged onto AIX as dtuser.
• Blueworx Voice Response must be running.

Syntax

dtexport [-dev device | -f filename | -t | -D]

[-x] [-b]

[-appl   application [-delta [-since yyyymmddhhmmss]]]

[-stab   statetable...]

[-pdir   promptdir...]

[-vdir   voicedir...]

[-vtab   voicetable...]

[-3270   server...]

[-cs     server...]

[-prof   profileID...]

[-sclass class...]

Flags

-dev device

Export on to the specified device. The device can be either a fully-qualified AIX file name or a device path (for example, /dev/rmt0).

-f

Export into the AIX file specified as filename. The file name must not be longer than 100 characters.

You can also specify the path to the file. The path name must not be longer than 155 characters.

-t

Export on to the tape drive specified in the Default Tape Drive system parameter.

-D

Export on to the diskette drive specified in the Default Diskette Drive system parameter.

-x

Extract all dependencies of the selected objects, and add them to the package. This option is not valid if you also specify the -appl option. If you do not specify the -x option, only those objects specified on the command are included in the package.

-b

Export only the binary format of those objects that have both a text and a binary form (that is, state tables, prompts, and 3270 scripts).

-appl application

Specifies the name of the application to be exported. This option cannot be specified in conjunction with the object type options described below.

-delta

The application objects to be exported are only those that have been modified since a certain date. If you do not specify the -since option, this date is the date of the previous export. If you do specify the -since option, the date you supply is used. This option is valid only you also specify the -appl option.

-since yyyymmddhhmmss

Only those objects in the specified application that have been modified since the time yyyymmddhhmmss are to be exported. This option is valid only if the -appl and -delta options are also specified.

-stab statetable...

Specifies a space-delimited list of state tables that are to be exported. This option is not valid if -appl is also specified.

-pdir promptdir...

Specifies a space-delimited list of prompt directories that are to be exported. This option is not valid if -appl is also specified.

-vdir voicedir...

Specifies a space-delimited list of voice directories that are to be exported. This option is not valid if -appl is also specified.

-vtab voicetable...

Specifies a space-delimited list of voice tables that are to be exported. This option is not valid if -appl is also specified.

-3270 server...

Specifies a space-delimited list of 3270 servers that are to be exported. This option is not valid if -appl is also specified.

-cs server...

Specifies a space-delimited list of custom servers that are to be exported. This option is not valid if -appl is also specified.

-prof profileID...

Specifies a space-delimited list of application profile IDs that are to be exported. This option is not valid if -appl is also specified.

-sclass class...

Specifies a space-delimited list of subscriber classes that are to be exported. This option is not valid if -appl is also specified.

Return values

0

Success

< >0

Failure

Usage notes

• Multiple simultaneous import or export operations using dtimport or dtexport from the command line, or using import or export functions from the Application Manager are not allowed. If you attempt to start an export operation while another import or export operation is in progress, the dtexport command will return an error message notifying you that another import or export operation is already in progress, and the command will return an exit code of 2.

Examples

To export objects of a specified type (profiles, in this example) to a file called /usr1/dtuser/profiles.imp:

dtexport -dev /usr1/dtuser/profiles.imp -prof 4085551234

To export a state table and all its dependents to a file called /usr1/dtuser/stbl.imp:

dtexport -dev /usr1/dtuser/stbl.imp -x -stab My_State_Table

To export a combination of objects without their dependents to a tape:

dtexport -t -stab Table1 Table2 -pdir Pdir1 -vdir Vdir1 Vdir2 Vdir2

To export a complete application called “Sports_Results”:

dtexport -dev /tmp/sports.imp -appl Sports_Results

To export only those objects in the “Sports_Results” application that have changed since the last export:

dtexport -dev /tmp/sports.imp -appl Sports_Results -delta

To export only those objects in the “Proto” application that have changed since a specific date:

dtexport -dev /tmp/proto.imp -appl Proto -delta -since 19970620000000