Note:
A migration list is expanded automatically during migration if the Auto Expansion option is specified in the migration path definition.

You can expand an existing migration list using the EXP command. PAC processes each entry in the migration list in turn and, depending on the expand option selected, retrieves its subcomponents and adds them to the source area.

If the EXP command is then reissued, these subcomponents are expanded in turn, the list is sorted, and all duplicate objects are eliminated.

By default, the expand process expands only one level of subordinate and referenced objects. To expand more than one level (that is, to implement a recursive expand), use Applymod 13. To expand maps for multiple languages, use Applymod 9. Applymods are documented in the PAC Reference documentation.

Foreign objects cannot be expanded. Only Natural objects can be expanded to include subordinate foreign objects that are used by that Natural object.

When migrating objects into PAC, the expand function is valid only if cross-reference data exists for the object as specified by the Predict location for the application status.

This document covers the following topics:

• Using EXP With Predict

• EXP Procedure

• Using EXP For Large Migrations

---

Using EXP With Predict

With Predict, the EXP command can be used to include in the migration list all files linked to a database. A database will be expanded to include its files, and the files will be expanded to include the userviews.

The EXP field is valid for databases and files when they are entering PAC from development or maintenance.

EXP Procedure

1. To expand a migration list once it has been created, enter the EXP (Expand) command on the Migration List Editor command line.

   The Expand command has the format

   EXP [option]
   

   where option is C, E, R, or U as explained in the following table:

   Option	Include in the migration list . . .
   EXP C	subordinate objects; for compile time.
   EXP E	subordinate and referenced objects (options C+R); for compile time and runtime.
   EXP R	referenced objects; for runtime.
   EXP U	objects used by other objects.
   EXP O	objects range.

   The expand options C, E, R, and U use cross-reference (Xref) data

   • from Predict for migrations into PAC; and

   • from PAC for all other migrations.

   If you do not specify an expand option, the Expand Objects List Options window appears:

   11:31:30 Predict Application Control 2003-10-02 User DBA +--------------------------------------------------+ ¦ > exp > + TX: Migration List ¦ Event ....... UKMJ_EXPAND ¦ All...+....1....+....2....+.... S L 1 ¦ Application . UKMJ_APPLICA ¦ **P ¦ From Status . CONTROL_____ ¦ ¦ To Status ... CONTROL_____ ¦ ¦ Exec Mode ... COPY Objects ¦ ¦ Scheduled ... __________ a ¦ +-----------------------------------------------¦ ¦ ¦ ¦ Notes ........ __________ ¦ ¦ - Expand Objects List Options - ¦ __________ ¦ ¦ ¦ __________ ¦ ¦ C Subordinated objects (Compile time) ¦ ¦ ¦ E Subordinated & Referenced objects ¦ Maintenance Request .. __ ¦ ¦ R Referenced objects (Run time) ¦ Processing State ..... Pen ¦ ¦ U Used By objects ¦ Validate List ........ N ¦ ¦ O Object range ¦ Additional Options ... N ¦ ¦ ¦ ¦ ¦ Option ... _ ¦ ¦ ¦ Status ... ________________________________ ¦ ¦ ¦ ¦ Command ===> ¦ +-----------------------------------------------¦ Enter-PF1---PF2---PF3---PF +--------------------------------------------------+ Help Menu Exit Op

   This window lists the expand options and prompts you to enter your choice in the Option field. As an alternative, the Status field is provided. If you identify a status here, all subordinates that exist in that status are migrated (or "rolled in" from development or maintenance).

2. Enter an option or the name of a status.

3. Enter SAVE on the editor command line to save the migration list.

4. Press ENTER or enter a period (.) on the editor command line to exit the Migration List Editor window.

If you attempt to exit the Migration List Editor before you save your modifications, a warning window appears requesting that you save or abandon changes, or return to the editor.

Using EXP For Large Migrations

When PAC processes a migration event, the migration list is placed in the Natural extended buffer (ESIZE), which may impose limits on the number of objects that may be processed by a single migration event. If this number is exceeded, error NAT0886 is received.

For large migrations (of several thousands of individually specified objects), use one of the following methods to ensure that the number of objects in the migration list does not exceed the maximum size of the ESIZE buffer:

1. Set your ESIZE to 128 KB, or greater if necessary;

2. Use asterisk (*) and/or range notation to limit the number of individual entries in the migration list, but still include all necessary objects.

Large numbers of objects may be processed using range notation because the specified ranges of objects are not expanded (with ESIZE) unless the expand options are used.