Home |

System Configuration
ICOBOL - ALL Systems


This is an illustration. Drive settings will be dependent on your network settings and the example uses Win 9x/NT as the OS type. You will need to select 11. Change Target OS Type and select the correct OS for the system on which you are installing ICOBOL.


Click on Configuration Editor (Text). You will see the following screen:

    icconfig
    Revision 2.68
    Win 9X/NT

1. Configure System Parameters
2. Configure Strings
3. Configure Devices
4. Configure Program Environments
5. Configure Terminal Descriptions
6. Configure Printer Translations
7. Save Configuration File
8. Retrieve Configuration File
9. Reset Configuration to Defaults
10. List Configuration <filename>.ls
11. Change Target OS Type

Selection: 1

Retrieved file: m:\system.cf
Save(d) file:
Target OS type: Win 9X/NT

Press <UP> or <DOWN> to select, <ESC> to exit.


First make sure that the Target OS type is correct for your system type. If it is, go on to the next step. If not, type 11 <ENTER> and use the arrow keys to change it to the correct one for your system. Hit <ESC> when it is changed, then type 1 and go on to the next step.

Hit <ENTER> to select the first item on the menu and you will see the screen shown below:

System Parameter Configuration

    Number of processes allowed 17 Number of OPENs per process 200
    Buffer area size (KB) 1024 Buffer Write-through enabled N
    Number of SEQUENTIAL files 64 Number of record locks 200
    Number of ANSI INDEXED files 200 Number of ANSI RELATIVE files 32
    INDEXED ICISAM create Version 6 RELATIVE ICISAM create Version 6
    INDEXED-85 ICISAM create Version 7 RELATIVE-85 ICISAM create Version 7
    Enable 4GB ICISAM version 7 files N
    Number of programs per run unit 16 Number of OPENs per run unit 220
    Maximum total size (KB) 75
    Printer Control Enabled Y Printer Control entries 48

Press <UP> or <DOWN> to position, <ESC> to exit.

Edit to match the screen above and the hit <ESC>.


Hit <ENTER> to select the second item - Configure Environmental Strings - which brings up the screen below:

Environment String Configuration

    Num
    ------
    String
    Enable?
    ------------
    Value
    ------------------------------------------------------------------
    0
    1
    2
    3
    Y
    Y
    N
    N
    ICCODEPATH=m:\mcaobj
    ICDATAPATH=m:\mcadata
    ICRUNLK=m:\iclink.lk
    ICPCQDIR=

Press <UP>, <DOWN>, <F1>, <F2>, <F3>, <F4> to position, <F5> to copy, <ESC> to exit.


Edit this screen to match the above example, along with the next screen as seen below:

Environment String Configuration

    Num
    ------
    String
    Enable?
    ------------
    Value
    ------------------------------------------------------------------
    4
    5
    6
    7
    N
    Y
    Y
    Y
    ICTMPDIR=m:\mcadata
    ICROOT=c:\program files\Icobol
    ICSCROPT=partial
    ICSDMODE=drawlines

Press <UP>, <DOWN>, <F1>, <F2>, <F3>, <F4> to position, <F5> to copy, <ESC> to exit.

When the screens are as seen above, press <ENTER> to escape back to the first menu screen.


Press <ENTER> to select number three - Configure Devices - for the screen below:

Logical Device Configuration

    1. Configure Consoles (@CONn)
    2. Configure Printers (@PRNn)
    3. Configure Serial Lines (@SERn)
    4. Configure Printer Control Queues (@PCQn)

Hardware Device Configuration

    5. Configure Master Console

Selection: 1

Press <UP> or <DOWN> to select, <ESC> to exit.


Select 1. Configure Consoles (@CONn) to get the screen below:

Console Device (@CONn) Configuration

    Console
    -----------
    Device
    ----------
    Enable?
    ------------
    Leave Other Items Set to Default Settings
    -------------------------------------------
    @CON0
    @CON1
    @CON2
    @CON3
    @CON4
    @CON5
    @CON6
    @CON7
    @CON8
    @CON9
    @CON10
    @CON11
    @CON12
    @CON13
    @CON14
    @CON15
    con
    con
    con
    con
    con
    con
    con
    con
    con
    con
    con
    con
    con
    con
    con
    con
    Y
    Y
    Y
    Y
    Y
    Y
    Y
    Y
    Y
    Y
    Y
    Y
    Y
    Y
    Y
    Y

Press <UP>, <DOWN>, <F1>, <F2>, <F3>, <F4> to position, <F5> to copy, <ESC> to exit.

Edit this screen to look the same as above, assuming there will be 15 users. Do not enable more consoles than there are users on the system. It will not hurt to do so, but it will waste resources.

Hit <ESC> to exit back to the previous menu.


Select 2. Configure Printers (@PRNn) to get the screen shown below:

Printer Device (@PRNn) Configuration

          ....Printer Options..... Printer

    Printer
    -----------
    Device
    ----------
    Enable?
    ------------
    FF on
    OPEN?
    -----------
    FF on
    OPEN?
    -----------
    Translation
    ---------------
    @PRN0
    @PRN1
    @PRN2
    @PRN3
    @PRN4
    @PRN5
    @PRN6
    @PRN7
    @PRN8
    @PRN9
    @PRN10
    @PRN11
    @PRN12
    @PRN13
    @PRN14
    @PRN15
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N

Press <UP>, <DOWN>, <F1>, <F2>, <F3>, <F4> to position, <F5> to copy, <ESC> to exit.

Set up as many as needed for the number of printers, and hit <ESC> to exit.


Select 3. Configure Serial Lines (@SERn) and see that it looks like the screen below:

Serial Device (@SERn) Configuration

    Serial
    --------------
    Device
    ----------
    Enable?
    ------------
    @SER0
    @SER1
    @SER2
    @SER3
    @SER4
    @SER5
    @SER6
    @SER7
    @SER8
    @SER9
    @SER10
    @SER11
    @SER12
    @SER13
    @SER14
    @SER15
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N

Press <UP>, <DOWN>, <F1>, <F2>, <F3>, <F4> to position, <F5> to copy, <ESC> to exit.

There should be no changes needed on this screen. Hit <ESC>.


Select 4. Configure Printer Control Queues (@PCQn) to see the screen shown below:

Printer Control Queue (PCQ) Configuration

    Printer
    Device
    ------------
    Host
    Device
    ----------

    Host
    Machine
    ------------


    Enb
    -----

    Printer
    Translation
    ---------------

    Aut
    Que
    ------


    End
    Disp
    -------

    FFeed
    Ntf  B  C  E
    ----------------

    @PCQ0
    @PCQ1
    @PCQ2
    @PCQ3
    @PCQ4
    @PCQ5
    @PCQ6
    @PCQ7
    @PCQ8
    @PCQ9
    @PCQ10
    @PCQ11
    @PCQ12
    @PCQ13
    @PCQ14
    @PCQ15
    lpt1
    HPLJ4
    HP4SI
    OKI320
    Y
    Y
    Y
    Y
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    N
    Delete
    Delete
    Delete
    Delete
    Keep
    Keep
    Keep
    Keep
    Keep
    Keep
    Keep
    Keep
    Keep
    Keep
    Keep
    Keep
    N  N  N  N
    N  N  N  N
    N  N  N  N
    N  N  N  N
    N  N  N  N
    N  N  N  N
    N  N  N  N
    N  N  N  N
    N  N  N  N
    N  N  N  N
    N  N  N  N
    N  N  N  N
    N  N  N  N
    N  N  N  N
    N  N  N  N
    N  N  N  N

Press <UP>, <DOWN>, <F1>, <F2>, <F3>, <F4> to position, <F5> to copy, <ESC> to exit.


The ?end disp? is delete. Be sure that all enabled printer control queues are this way, otherwise it uses excessive disk space as there will be a file kept for everything that is printed in MC.


When finished, hit <ESC> twice, which will show the screen below:

    icconfig
    Revision 2.68
    Windows 9X/NT

1. Configure System Parameters
2. Configure Strings
3. Configure Devices
4. Configure Program Environments
5. Configure Terminal Descriptions

Selection: 4

Retrieved file: M:\system.cf
Save(d) file:
Target OS type: Win 9X/NT

Press <UP> or <DOWN> to select, <ESC> to exit.


Type the number 1, which will change the console number, and hit <ENTER>.
Edit the screen as needed to match the screen print below:

Program Environment Configuration
Console number: 1

Run programs ?          Y      @CON       on con     (enabled)
Startup program: sylogon.cx

      Privileges Setup

    Console interrupt ? Y Program debugging ? Y
    Abort terminal ? Y System information ? Y
    Message sending ? Y Printer control ? Y
    Printer control management ?  Y System shutdown ? Y
    Terminal status ? Y Detached/Host programs ?  Y
    Watch other terminals ? Y

Default Environment String Values

    ICTIMEOUT= 0 ICABORT=on PCQ= 0 PRN= 0 SER= 0
    ICTERM=pcwindow ICLINES= 0 ICCOLUMNS= 0
    ICSCROPT=partial ICSDMODE=drawlines(2) ICREVERSE=process
    ICCOLOR=filter ICBGCOLOR=blue (1) ICFGCOLOR=white (7)
    MS-DOS / Windows NT Message Setup

    System available ? N  Username ? N  System unavailable ? N
    Press <UP> or <DOWN> to alter number. Enter to select, <ESC> to exit.

Once the values are correct as above, hit F5 to copy this for the same number of consoles as were enabled earlier under 1. Configure Consoles (@CONn).

When completed hit <ESC> to return.


Select 7. Save Configuration File, which will bring up the default configuration file name as shown below:

    icconfig
    Revision 2.68
    Win 9X/NT

1. Configure System Parameters
2. Configure Strings
3. Configure Devices
4. Configure Program Environments
5. Configure Terminal Descriptions
6. Configure Printer Translations

7. Save Configuration File
8. Retrieve Configuration File
9. Reset Configuration to Defaults
10. List Configuration <filename>.ls
11. Change Target OS Type

Selection: 7

Retrieved file: M:\system.cf
Save(d) file: M:\system.cf
Target OS type: Win 9X/NT

Press <UP> or <DOWN> to select, <ESC> to exit.

Hit <ENTER> to accept the default and you will be asked if you want to replace the existing file as shown below:

Do you wish to replace the existing configuration file? Y

Hit <ENTER> to replace with the new data.

Select 10. List Configuration <filename>.ls The screen should just blink, but the program will make a file called system.ls which can be read and printed in any text editor. It is suggested this file be printed and the hard copy stored away in a safe place for reference in the event the current settings are lost.

The configuration will take effect when the server is restarted or ICEXEC is stopped and restarted in the Control Panel/Services on the server.

Creating the ICOBOL License File

Updated February 13, 2009 at 11:06 a.m.