Using the Migration List Editor

With the Migration List Editor, you can:

  • Enter objects directly in the Migration List Editor window;

  • Select objects from the Object Selection List screen using the SEL (Select) command;

  • Use the EXP (Expand) option to add subcomponents to the migration list, once the base migration list exists.

You may combine these three methods, except when selecting objects for the Predict application.

This document covers the following topics:


Step 1. Accessing the Migration List Editor

Access the Migration List Editor window from the Add/Modify Event screens through Additional Options or by pressing PF7 (ObLst):

 16:38:28           ***** PREDICT APPLICATION CONTROL *****          2000-01-01
 User PACUSR               +--------------------------------------------------+
                           | >                      > + TX: Migration List    |
 Event ........ ABATCH7    |  All...+....1....+....2....+.... S 1    L 1      |
 Keys ......... ,,,,,,,,,, |                                                  |
 Application .. ORDERS ___ |                                                  |
 From Status .. DEVELOPMEN |                                                  |
 To Status .... CONTROL    |                                                  |
 Exec Mode .... MOVE objec |                                                  |
 Scheduled .... 2000-07-01 |                                                  |
                           |                                                  |
 Notes ........ __________ |                                                  |
                __________ |                                                  |
                __________ |                                                  |
                           |                                                  |
 Maintenance Request ..    |                                                  |
 Processing State ..... Co |                                                  |
 Validate list ........ N  |                                                  |
 Additional Options ... Y  |                                                  |
                           |                                                  |
                           |                                                  |
Command ===>               |                                                  |
Enter-PF1---PF2---PF3---PF |                                                  |
      Help  Menu  Exit  Op +--------------------------------------------------+

This editor is similar to the Natural editor. See the PAC Reference documentation for a review of Natural editor commands. At the top of the editor screen at the first ">" prompt, you may enter Natural system commands and line commands such as:

CLEAR removes all entries displayed;
HELP lists possible options;
SAVE saves all entries displayed;
QUIT leaves the editor;
SEL selects objects;
SORT sorts objects alphabetically.

Following the second ">" prompt is an indicator controlling the direction of some of the editor commands: + indicates "after"; and - indicates "before". The editor commands ADD and SCAN and the line commands ".C", ".M", and ".I" are influenced by this direction indicator.

Finally on the top line, the TX: (entity type) field identifies the migration list entity currently in the source work area. This field value cannot be modified.

The next line down from the top includes a scale with positional markings for a source line length of 43 characters, an S (number of lines) field indicating the size of the migration list being edited, and an L (source line number) field indicating the particular source line currently displayed as the first line in the editor.

Note:
For events with From Status EXTERNAL the migration list editor provides a specific additional function, when using the SEL command. When adding or modifying a URL with the editor, you can expand each line in the editor with the PF5 key. You are then able to add or edit long URL strings (up to 250 characters) more easily. In addition, when you are in the expanded lines mode, you can scroll through the migration list back and forth using the PF7 and PF8 keys.

Step 2. Specifying Objects for the List

In the Migration List Editor, objects may be listed in any sequence, but each object must be entered on a separate line in the following general format:

object name, object type, reference (version or status)

Specific formats for different object types are described in detail in the section Object Types for the List. For these formats, square brackets indicate optional terms; curly braces indicate mutually exclusive options.

Names of Natural objects, except rules and views, may be up to (8) characters in length. Foreign objects may be up to 32 characters in length. Names of rules, views, and Predict objects may be 3-32 characters. An asterisk (*) or range notation may be used to specify a prefix or range of objects.

Note:
Range notation is not currently available for foreign objects. To display a list of valid foreign object types, enter FTYPES on the command line of the Migration List Editor.

PAC interprets the migration list information according to the type of object being processed. The object type is a 1-4 character code. If an asterisk (*) is used, PAC determines the exact type(s) for objects based on the object name specification.

Note:
The audit report interprets the asterisk as "GNERIC".

The reference includes the version of the object to be processed (a 1-4 character number) or the status of the object (a 1-32 character name or alias that uniquely identifies the status) if the version number is not known.

Step 3. Saving the Migration List

Once you have specified the objects (or selected them from lists; see Using the SEL (Select) Command), the Migration List Editor window displays the list in alphabetical order:

  11:41:07          ***** PREDICT APPLICATION CONTROL *****           2000-01-01
  User PACUSR               +--------------------------------------------------+
 Library .. ORDERS   (235,9 | >            > + TX: object List                 |
 C Nr Object   Object Type  |  All...+....1....+....2....+.... S 1    L 12     |
 - -- -------- -----------  |    ASMPGM,3ASL                                   |
 _  1 MENU     Program      |    COBPGM,3COB                                   |
 _  2 NHL      Helproutine  |    ORD-AHLP,H                                    |
 _  3 ORD-AHLP Helproutine  |    ORD-CUST,S                                    |
 _  4 ORD-COPY Copycode     |    ORD-END,S                                     |
 _  5 ORD-CUST Subroutine   |    ORD-GLOB,G                                    |
 _  6 ORD-END  Subroutine   |    ORD-LINE,S                                    |
 _  7 ORD-GLOB Global       |    ORD-MAIN,P                                    |
 _  8 ORD-INV  Subroutine   |    ORD-MAP,M                                     |
 _  9 ORD-LINE Subroutine   |    ORD-MAP,M                                     |
 _ 10 ORD-LIN1 Subroutine   |    ORD-NHLP,H                                    |
 _ 11 ORD-MAIN Program      |    ORD-RLIN,S                                    |
 _ 12 ORD-MAI1 Program      |                                                  |
 _ 13 ORD-MAP  Map          |                                                  |
 _ 14 ORD-NHLP Helproutine  |                                                  |
                 Mark Selec |                                                  |
 PAC7037: (E) Mark line(s) w|                                                  |
 Command ===>               |                                                  |
 Enter-PF1---PF2---PF3---PF |                                                  |
       Help  Menu  Exit     +--------------------------------------------------+

Natural objects, foreign objects, data areas, copy code, rules, views, and maps selected using the available options are listed.

On the Editor command line, enter SAVE to save the migration list or a period (.) to exit the Editor.

If you attempt to exit the Migration List Editor before you save your modifications, a warning window appears requesting you to enter:

  • E to continue editing;

  • C to save your modifications; or

  • . (period) to abandon changes and exit the Migration List Editor.