You are here: LANSA for i User Guide > 5. Housekeeping > 5.12 Exporting and Importing > 5.12.7 Direct Exporting of Objects in a List

5.12.7 Direct Exporting of Objects in a List

To export to a PC system

To export to an IBM i system

To directly invoke the export facility without using any of the normal LANSA menus or prompts when the target is a LANSA for i system, the LANSA EXPORT command may be used. This enables you to invoke an export job at any time and from any type of application program.

To do this, use the LANSA command, or place a call to the LANSA program, passing parameters / arguments as described below:

Command Parameter

Call Argument Number / Type

Description

REQUEST

1 / A(10)

Pass as 'EXPORT'

PROCESS

2 / A(10)

Not required - pass as blanks

FUNCTION

3 / A(10)

Not required - pass as blanks

PARM01

4 / A(7)

Name of previously defined list that specifies object(s) to be exported. The list must have a Target System Type of IBM i.

PARM02

5 / A(10)

Device or device file name if exporting to disk or magnetic tape. Otherwise pass as blanks.

PARM03

6 / A(21)

Save file name if exporting to a save file. Use qualified name form if desired, otherwise pass as blanks.

PARM04

7 / A(7)

File sequence number if device name used in PARM02. Default is *END if left blank.

PARM05

8 / A(3)

Omit RDML source code from exported data. Pass as 'YES' or 'NO'. Default is 'NO'  if left blank.

PARM06

9 / A(256)

Languages to be exported. Up to 64 x 4 character language code(s) or *ALL to export all languages.
Applicable to multilingual partitions and
compulsory if you are exporting weblets.

PARM07

10 / A(3)

Not in use.

PARM08

11 / A(3)

Include LANSA/Document details in the export. Pass as 'YES' or 'NO'. Default is 'NO' if left blank.

This parameter will be set to 'NO' by the program if the 'Omit RDML source code from exported data' parameter is not passed as 'NO'.

PARM09

12 / A(3)

Omit frameworks and groups from the export. Pass as 'YES' or 'NO'. Default is NO if left blank.

PARM10

13 / A(1)

Not required - pass as blanks

PARTITION

14 / A(3)

Name of partition in which the list is defined.

LANGUAGE

15 / A(4)

Language that system is to use. If not specified, the partition default language will be assumed.

 

As an example consider the following operating system SBMJOB (submit job) command that begins an export job in batch:

SBMJOB RQSDTA('LANSA REQUEST(EXPORT) +

       PARM01(LIST01) PARM02(QTAPE) PARTITION(DEV)')

This command will submit a job to batch. The batch job will then invoke LANSA and request that all objects defined in a list called LIST01 be exported out onto a device called QTAPE (presumably a tape drive). The list is defined in the DEV partition.

It is not recommended that this facility be used to export objects interactively (i.e. directly from a workstation) because of the relatively large number of database I/Os performed.

To export to a PC system

To directly invoke the export facility without using any of the normal LANSA menus or prompts when the target is a LANSA PC system, the LANSA PCEXPORT command may be used. This enables you to invoke an export job at any time and from any type of application program.

To do this, use the LANSA command, or place a call to the LANSA program, passing parameters / arguments as described below:

Command Parameter

Call Argument Number / Type

Description

REQUEST

1 / A(10)

Pass as 'PCEXPORT'

PROCESS

2 / A(10)

Not required - pass as blanks

FUNCTION

3 / A(10)

Not required - pass as blanks

PARM01

4 / A(7)

Name of previously defined list that specifies object(s) to be exported. The list must have a Target system type of WIN, PC or OS/2.

PARM02

5 / A(1)

Check Out Usage. This must be 'R' (read only) or 'M' (maintenance).

PARM03

6 / A(8)

Task identity. If the Check Out Usage is 'M' this must be a valid task with an open status (OPN or WRK).

If the Check Out Usage is 'R' (read only), this parameter is ignored (ie treated a blank).

PARM04

7 / A(10)

PC Name. If the Check Out Usage is 'M' this must be a valid PC Name.

If the Check Out Usage is 'R' (read only), this parameter is ignored (ie treated as blank).

PARM05

8 / A(1)

Not required - pass as blanks

PARM06

9 / A(1)

Not required - pass as blanks

PARM07

10 / A(1)

Not required - pass as blanks

PARM08

11 / A(1)

Not required - pass as blanks

PARM09

12 / A(1)

Not required - pass as blanks

PARM10

13 / A(1)

Not required - pass as blanks

PARTITION

14 / A(3)

Name of partition in which the list is defined.

LANGUAGE

15 / A(4)

Language that system is to use. If not specified, the partition default language will be assumed.

 

As an example consider the following operating system SBMJOB (submit job) command that begins an export to PC job in batch:

SBMJOB RQSDTA('LANSA REQUEST(PCEXPORT) +

       PARM01(LISTPC) PARM02(M) PARM03(MYTASK01) PARTITION(DEV)')

This command will submit a job to batch. The batch job will then invoke LANSA and request that all objects defined in a list called LISTPC be exported. The export will create a folder in QDLS named LISTPC. The objects will be available for maintenance under task MYTASK01. The list is defined in the DEV partition.

It is not recommended that this facility be used to export objects interactively (i.e. directly from a workstation) because of the relatively large number of database I/Os performed.