Home |

Installing ICOBOL - UNIX


The UNIX ICOBOL now requires a security plug on a serial port on the system (HP/UX is an exception to this, it uses the CPU ID number). We recommend you use the Master Console port if possible, but it will function on another serial port. The port has to be set to 9600 Baud, no parity, 8 data bits and 1 stop bit. There is detailed information on the plug on the ICOBOL Web site documentation area or on the ICOBOL CD. You can download AIX Icobol here. You can download HP/UX Icobol here. If you are running on a version of UNIX (DG/UX or HP/UX) that has a configurable kernel, you may need to add the following parameters. (Note these are if you are running MC only. Your system parameters may need to be adjusted differently if you are running additional applications on your system.)
    SHMMAX
    SDESLIM
    NPROC
    MAXUP
    7999000
    120
    512
    100

NOTE: The following reference is used below: /mc/cobol. It is a link to the correct version of ICOBOL. This is the UNIX command to create the link: ln -s /mc/cobol268 cobol.


1. Insert TAPE/CDROM in computer. If you are using the CDROM, it is recommended that you extract the files to your PC first then FTP them to your UNIX system.
2. Follow the instructions included with the media for loading.
3. There should be a sheet of paper included with the security plug. At the top of the page are the words PRODUCT ACTIVATION KEY CARD. In the /mc/cobol directory, use the VI editor or some other UNIX editor to create a file named system.lic.

Creating the License File

4. Enter the information starting with the * for each line EXACTLY as it is on the sheet. Then save the file to the /mc/cobol directory as system.lic.
5. To verify the information was typed correctly, do the following (if the plug is on the master terminal port and you are on the master terminal) in the /mc/cobol directory: ./icpermit -c

    or

If you are logged in on a terminal port that does not have the security plug on it, do the following: ./icpermit -cP /dev/conX (where X is the console number the device is connected to).

This will display either an error message with the line number containing the error or, if you are a perfect typist, it will display a message indicating licenses authorized to run successfully. Repeat Steps 4 and 5 until this is successful.

To install icpermit after it checks out correctly, do the following: ./icpermit  -ai

Or if it is on a different port: ./icpermit -aiP /dev/conX (where X is the console number the device is connected to).

6. Write down the exact command you used at the end of Step 5.
7. Proceed to System Configuration Settings for ICOBOL
8. After your configuration is set up in Step 7, type the following command in the /mc/cobol directory: ./icexec -ai

This will start the runtime process for ICOBOL.

9. With the permission of your Business Partner (if you purchased your system through an MC Business Partner/CU Software Vendor), edit the rc script file and add in the line you wrote down in Step 6 and the command from Step 8. This will start ICOBOL each time you boot your UNIX system.

Create the following script file to start MC using ICOBOL (use the VI or another UNIX editor to create this file in the /mc directory). You will need to verify the correct name to use. Many Business Partners have their own script or .profile file. This needs to be placed in the example below if using a file .profile in the /mc directory.

umask 000
PATH=.:/mc/cobol:$PATH
ICROOT=/mc/cobol
ICCODEPATH=/mc/mcaobj
ICDATAPATH=/mc/mcadata
ICSDMODE=2
ICTERM=dg
ICSCROPT=partial
export PATH ICROOT ICCODEPATH ICDATAPATH ICSDMODE ICTERM ICSCROPT
cd /mc/mcadata
if [ -z "$MCTERM" ]
     then echo "Enter Your Terminal Number \c"
     read MCTERM
fi
icrun -T $MCTERM sylogon
exit

10. Make sure you have everyone logged out of the ICHOST runtime before logging into the ICOBOL runtime. They each lock records and files separately and will corrupt files if both are logged in at the same time.
11. Execute the script file from Step 9 and you should be able to log into the system using ICOBOL.

Updated July 20, 2010 at 10:35 a.m.