You are here: LANSA for i User Guide > 4. Processes and Functions > 4.15 Edit a Function's RDML Commands > 4.15.19 Action M or F16 (Move)

4.15.19 Action M or F16 (Move)

This action is used in both the screen and report design facilities.

When action code M is used the following occurs:

1.  The user is asked to select the field or text that is to be moved by placing the screen cursor anywhere on the field and pressing the enter key.

2.  The user is then requested to position the screen cursor at the location the field or text is to be moved to and press the enter key.

3.  If the field or text can be fitted at the required location it will be moved. If not, an error will be displayed and step 2 can be repeated.

To use function key F16 complete one of the following:

1.  Position the screen cursor anywhere on the field or text that is to be moved and press function key F16.

2.  Position the screen cursor at the location the field or text is to be moved to and press the enter key.

3.  Move the screen cursor to another field in the same screen portion (header or browselist) or the same report line and use function key F16 again. This will select another field to be moved. By repeatedly using F16 you may choose up to 50 fields to be moved. When all of the required fields have been selected they form a logical "box" on the screen. By moving the cursor to where you want the upper left (or upper right for RLTB users) of the "box" to be moved to, and pressing enter you can cause all selected fields within the "box" to be moved in one go.
This type of operation is called a "multiple move" because it can move multiple fields in one operation. It is not strictly a "block" move because fields within the boundaries of the logical "box" that have not been selected are not moved.

Some important points about moving fields or text are as follows:

To Select the Field to Be Moved

To select the field to be moved, place the screen cursor anywhere on the first occurrence of the field or its associated label, description or column headings and press the enter key or F16.

When a Field is Being Moved

When a field is being moved the field and any associated identification text is moved. For instance, if the field is identified by column headings like this:

 

                     Company

                       Order

                      Number

                   999999999

 

or identified by a label such as:

 

             Order number : 999999999

 

or identified by a description such as:

 

             Order number . . . . . . . . . : 999999999

 

then a "block" that contains the field and its associated identification text is what will be moved. The "blocks" associated with the 3 examples above can be visualized as:

 

   __________

  |          |             ________________________

  |  Company |            |                        |

  |    Order |            |Order number | 999999999|

  |   Number |            |________________________|

  |999999999 |

  |__________|

    ____________________________________________

   |                                            |

   | Order number . . . . . . . . . | 999999999 |

   |____________________________________________|

 

When a field has been selected for a move the associated "block" that contains the field will be displayed in reverse image. Thus, it is very easy to see exactly what is to be moved and how it will fit into the desired new location.

Indicating Position Where to Move a Field

When indicating the new position to which a field should be moved you should carefully note the following:

 

                              __________

                             |          |

The new position for ------->|  Company |

this corner of this block    |    Order |

                             |   Number |

                             |999999999 |

                             |__________|

                              ________________________

                             |                        |

The new position for ------->|Order number | 999999999|

this corner of this block    |________________________|

 

                 ____________________________________________

                |                                           |

The new  ------->| Order number . . . . . . . . | 999999999 |

position for     |__________________________________________|

this corner of this block

 

 

                              __________

                             |          |

                             |  Company |

                             |    Order |

The new position for this    |   Number |

corner of this block ------->|999999999 |

                             |__________|

                              ________________________

                             |                        | 

The new position for ------->|Order number | 999999999|

this corner of this block    |________________________|

 

                  __________________________________________

                 |                                          |

The new   ------>| Order number . . . . . . . . | 999999999 |

position for     |__________________________________________|

this corner of this block

 

Additionally, you should only attempt to move and target the first occurrence of a field. Additional occurrences of a field in a browse list or detail/break line will be automatically moved to the same relative location as the first occurrence.

Performing a Multiple Move

When performing a multiple move all selected fields must come from the same screen panel portion (header or browselist) or the same report line. Attempts to select fields in another portion do not cause an error as they are simply ignored.

Using a Multiple Move

When a multiple move is used all selected fields/text form a logical "box". To move the "box" position the cursor at the upper left (or right for RLTB users) position and press enter. All selected fields within the logical box will then be moved (providing that they can be).

For example:

UL

---->Customer Number  : XXXXXXXXX

     Customer Name    : XXXXXXXXXXXXXXXXXXXXXXXXXXXX      BR

     Customer Address : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX<---

 

By positioning the cursor on all 3 of these fields (or their labels) and pressing F16 each time you can create a logical "box" that can be visualized as having its upper left corner on the "C" in the string "Customer Number". By moving the cursor to where you want the upper left corner of the "box" to be moved to, and pressing enter, you can move the entire "box".

Note that if all fields and text were selected in this example, then the upper left corner of the logical "box" is now two lines above the "C" in "Customer Number":

UL

---->            CUSTOMER DETAILS AS AT 1/09/91

 

     Customer Number  : XXXXXXXXX

     Customer Name    : XXXXXXXXXXXXXXXXXXXXXXXXXXXX      BR

     Customer Address : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX<---

 

 

Note also that not all fields inside the logical "box" need to be selected and therefore moved. This facility can be very useful in situations like this:

    UL

    ---->BASIC DETAILS

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

         ADDRESS DETAILS

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

               XXXXXXXXXXXXXXXXXXXX BR XXXXXXXXXXXXX

         CURRENT SHIPMENT DETAILS<----

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

 

By using F16 to select "BASIC DETAILS", "ADDRESS DETAILS" and "CURRENT SHIPMENT DETAILS" you can form a logical "box". The upper left corner is on the "B" in "BASIC DETAILS".

Moving the cursor so that it is over the "S" in "BASIC DETAILS" and pressing enter would cause the following change:

                     BASIC DETAILS

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

                     ADDRESS DETAILS

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

                     CURRENT SHIPMENT DETAILS

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

 

Note that even though the logical "box" contained parts of the "XXXXXXXXX" values, they were not moved. That is because they were not selected via F16 to be within the logical "box".