Previous Topic: SPLIT CommandNext Topic: SUBMIT Command

CA Ideal Commands › SPLIT Command › Operand Definitions

Operand Definitions

Operand

Description

SPLIT

With the cursor positioned in the command area, divides the regions evenly. The minimum region size is nine lines. If there is not enough room on the screen for another region, the SPLIT is not applied and an error message is issued.

The current contents of the display area appear in the first region. All current option settings for the first region are retained for the second region. If the content for the second region is not specified with a command, the Main Menu appears in the second region.

 

With the cursor positioned in the display area, divides the regions at the cursor position. For example, the following command with the cursor positioned on the twentieth line of the screen, splits the screen into regions at line 20, assuming enough lines remain to accommodate a second region.

n

Specifies the new size of the existing, last, or only region (the number of lines).

m

Specifies the size of the new region (the number of lines). If you specify m, it stipulates a minimum number of lines that must be available to a second region for the split to take effect. When you do not specify m, the second region occupies the remaining available lines.

For example, the command, the following command formats 20 lines in the first region and the remainder in a second region.

SPLIT 20

The following command formats 20 lines in the first region and a minimum of 10 lines in the second region.

SPLIT 20 10

If the number of lines specified is greater than the number of lines available, the SPLIT command is ignored and a message is issued.

Example

When there is more than one region, you can prefix commands with a region number and a space. The commands apply by default to region 1 if no prefix is specified. You can only execute the RUN command in the first (or only) region. To display dataview EMPLOYEE in one region and to edit program definition SAMPGM in a second region, when only one region exists, enter:

SPLIT 
1 DISPLAY DATAVIEW EMPLOYEE 
2 EDIT PROGRAM SAMPGM

You can also enter commands on multiple lines or delimit them on a single line. For example:

SPLIT 
2 EDIT PROGRAM SAMPGM; 1 DISPLAY DATAVIEW EMPLOYEE