9.118 IMPORT_OBJECTS

Note: Built-In Function Rules     Usage Options

Acts as an interface to the LANSA Import Facility.

 

Arguments

No.

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

A

Req

Path that contains file(s) for IMPORT

1

256

 

 

2

A

Opt

Run LANSA Import with standard prompts

Values:

Y - LANSA Import run with prompts

N - LANSA Import run without prompts

Default = N

Note: N implies that the LANSA Import window will not require a user response on completion. The message to continue with the LANSA Import after conversion to the intermediate format will not be displayed.

1

1

 

 

3

A

Opt

Apply Filter to Import

This is an array of single byte entries that controls the import of the associated Object Group.

Byte:
1 = System Definition
2 = Partition Definition
3 = System Objects
4 = User / Development
See below for definition of objects

Values :
Y = Import this object group
N = Force Import to bypass this object group
Default  = Y (For each entry if the argument is passed.)

1

256

 

 

4

A

Opt

File Library

Determines the value of the importing file's library to be saved into the repository.

By specifying a value of I the importing file's library name will be saved and used as the library name in the exporting system.

Setting this option to P will override the importing Files' File Library with the destination's Partition Data Library. Any File Library Substitutions setting will not be applied.

Values:
I – Use importing file's library

P – Partition data library

O – Use file's library override if included in the export information

Default = I

1

1

 

 

5

A

Opt

Allow Name Changes

This parameter determines if the existing objects' names will be overwritten by the importing names.  Note – Use this option with care as it will change existing objects and may impact other objects which refer to this name such as fields and files.  The name may also be directly referenced in RDMLX code.

Values:
Y – Allow to override existing names
N – Do not allow to override existing names.
Default = N

1

1

 

 

6

A

Opt

Allow Type Change

This parameter determines if the existing objects will be deleted and imported as a different object type.  Note: Use this option with care as it will change existing objects and it may impact other objects which refer to this name such as fields and files.  The name may also be directly referenced in RDMLX code.

Values:
Y - Delete existing object(s) and continue with import

N - Do not proceed further if the importing Identifier is already in use by a different object type

Default = N

1

1

 

 

 

Return Values

No.

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

 

Req

Return Code

OK = The import completed without error

ER = A fatal error occurred during the import.

2

2

 

 

2

N

Opt

Number of Errors

1

7

0

0

3

N

Opt

Number of Warnings

1

7

0

0

 

Object Groups

System Definition

Partition Definition

System Objects

User / Development Objects