Previous Topic: Source Transport CommandsNext Topic: PRODUCE IMPORT COMMANDS Command

Transporting Applications in Source Form › Source Transport Commands › IMPORT Command

IMPORT Command

The IMPORT command creates the specified entity from the external source file.

All entities are created in TEST status and resequenced. When the entity already exists, the action specified by the SET IMPORT DUPLICATE commands is taken (refer to the SET IMPORT DUPLICATE command in this section).

Importing Program Resources

When an IMPORT command replaces an existing program, some relationships to other entity occurrences are affected. Relationships where the imported program is the subject of the relationships are replaced by those specified in the external source of the imported program.

That is, the resources shown by the DISPLAY PROGRAM RESOURCES command are completely replaced. Those relationships where the imported program is the object of the relationship are not affected.

This command has the following formats:

Format 1:


IMPORT ALL [type] [new‑clause]

Format 2:


       { DVW name [VERSION ver]                          }
       { HELP name                                       }
       {                                                 }
       { { { PGM }                        }              }
IMPORT { { { PNL } name‑clause            } [new‑clause] }
       { { { RPT }                        }              }
       { {          [       {ASIS    } ]  }              }
       { { MEM name [  USER {old‑user} ]  }              }
type

The name of the entity to import. Valid types are as follows:

DVW PNL

HELP RPT

PGM MEM

new‑clause

Specifies the new version, system, or user for the entities the IMPORT command creates. The new‑clause can include any of the following phrases:

            {nnn }
NEW VERSION {ASIS}
            {NEXT}

The value of nnn specifies the new version number to assign to the dataview, report, panel, or program being created. ASIS specifies that the version number is the same for the new entity as it was for the source entity. NEXT specifies that the version number is the next sequential number after the highest currently active version number.

           {ASIS}
NEW SYSTEM {sys }

The value of sys specifies the new system name to which the report, panel, or program is assigned. ASIS specifies that the system name is the same for the new entity as it was for the source entity.

         {ASIS}
NEW USER {uuu }

The value of uuu specifies the new user name to which the member is assigned. ASIS specifies that the user name is the same for the new member as it was for the source member.

You can enter any of these phrases on the IMPORT command, but they only apply to those entities for which they have meaning. You can specify the phrases in any order. If not specified on the IMPORT command, the version, system, or user is obtained from the appropriate SET IMPORT command. If they are not specified with a SET IMPORT command, you must enter any applicable phrases on the IMPORT command.

DVW name [VERSION ver]

Specifies the unmodeled dataview to select from the source file. If you specify ver as nnn, only the version identified by the number nnn is selected. If you specify ver as ASIS, any version of the dataview is selected. If you do not specify the VERSION clause, the default version is selected.

HELP name

Specifies the HELP member to select from the source file.

{PGM|PNL|RPT} name clause

Specifies the programs, panels, or reports to select from the source file. The name‑clause identifies the name, version, and system of the entity, in the following format:

     [        {nnn }] [       {ASIS   }] 
name [VERSION {ASIS}] [SYSTEM {old‑sys}]
name

The name of the program, panel, or report to select.

VERSION clause

With nnn, specify the version of the entity identified by the number nnn. With ASIS, specifies that any version of the entity is selected.

SYSTEM clause

With ASIS, the named entity is selected using any system name. With old‑sys, the named entity is selected only from the system named old‑sys.

MEM name

Identifies the member to select from the source file. You can further identify the member to select by specifying the user who owns it.

USER {ASIS|user}

With ASIS, specifies that the member to select can belong to any user. With user, selects only the member that belongs to the indicated user.

Note: