4 15 19 Action M or F16 Move

LANSA for i

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 | | |

| 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:

When there is only one occurrence of the field possible on the screen panel or report page (which means the field is in the main or header area of a screen panel or in the header or footer area of a report) the "target" position that you indicate with the screen cursor is for the upper left corner of the "block" containing the field and its identification details (right-to-left users should indicate the "mirrored" upper right corner position):

__________

| |

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

When multiple occurrences of the field are possible on the screen panel or report page (which means the field is in a browse list on a screen panel or in a detail or break line on a report) the "target" position that you indicate with the screen cursor is interpreted as a left hand side position as in the following examples (right-to-left users should indicate the "mirrored" right hand side positions):

__________

| |

| 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:

---->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":

----> 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:

---->BASIC DETAILS