Chapter 2 - JSC.ini control file
 
The JSC.ini file contains various customizable parameters like colors, your mail server, email address for orders etc. We will cover each parameter in JSC.ini file in this chapter.

Each line in the file has a name=value setup.
The names are Upper/lower case sensitive.
 
Sample JSC.ini file:
Title=ViaJCart™  Copyright 1999(c) VSSD
BgColor=153,204,255
HSize=0
VSize=0
ChkOutHSize=640
ChkOutVSize=480
BtnColor=51,51,153
BtnChgColor=153,255,255
BtnPanColor=51,51,153
CatPanColor=204,255,255
InsPanColor=51,51,153
HedPanColor=204,255,255
StaPanColor=204,255,255
ListColor=255,255,204
LogoBannerLn1=BackgroundColor=0,0,51;271610 Welcome to our on-line ViaJCart Demo Web Catalog !;271610 See what a shopping experience could be like! 
LogoBannerLn2=271610 We have created our Java shopping cart for those who don't want the look of plain vanilla HTML shopping cart. ;271610 Download ViaJCart and try it today! ;271610 Your Internet storefront is just a click away!!!
LogoBannerUrl=http://www.yourdomain.com/page_you_want_to_link_to
BtnMenuClick=Sys/2clicks.au
BtnMenuOver=Sys/1click.au
BtnSortPriceClick=Sys/2clicks.au
BtnSortPriceOver=Sys/1click.au
BtnSortDescClick=Sys/2clicks.au
BtnSortDescOver=Sys/1click.au
BtnSortItemClick=Sys/2clicks.au
BtnSortItemOver=Sys/1click.au
BtnSearchClick=Sys/2clicks.au
BtnSearchOver=Sys/1click.au
BtnShopCartClick=Sys/2clicks.au
BtnShopCartOver=Sys/1click.au
BtnCheckoutClick=Sys/2clicks.au
BtnCheckoutOver=Sys/1click.au
BtnHelpClick=Sys/2clicks.au
BtnHelpOver=Sys/1click.au
BtnExitClick=Sys/2clicks.au
BtnExitOver=Sys/1click.au
ItemHTMLPages=Yes
ItemHSize=640
ItemVSize=400
ItemPicture=Right
ItemTextLineSize=48
ItemTextFont=T
ItemTextFontSize=14
ItemTextBackground=255,255,204
ItemTextForeground=0,51,153
SSLURL=https://www.yourserver.com/cgi-bin/JSCRT.pl(For Real-time processing ONLY)
DownLoadURL=http://www.yourserver.com/download_directory/(For Real-time processing ONLY)
CGIserver=www.yourdomain.com
CGIscript=/cgi-bin/JSCCGI110.pl
CGIport=80
DisplayReceipt=Yes
Counter=/cgi-bin/JSCCounter.pl
Proxy=No
SMTPserver=*
SMTPrelay=*
EMailName=Test_order
EMailFrom=test@yourdomain.com
FTPserver=*
FTPuser=15302211016022000030
FTPpassword=49111241056095080092
FTPdir=Jsc2/Ord
PSW=19761221071011094068
RealAudio=No
Music=176:music1.htm;220:music2.htm;212:music3.htm;171:music4.htm
CGISearch=No
SearchAll=No
QuickImage=Yes
QuickImageSize=-1,-1,200,200
ChkOutWin1=@,y,y,n,y,y,y,y,n,n
ChkOutWin2=n,n,n,n,n,n,n,n,n
ChkOutWin3=y,y,y,y,n,n
CreditCardYears=Select one,1999,2000,2001,2002,2003,2004,2005
Subtotal=No

Description of each parameter line in the JSC.ini file.

The Title parameter:
You can specify title for the main ViaJCart window. Usually one uses company name.

Example:
Title=ViaJCart Copyright (c) VSSD
Title=My company name
 
The background color for ViaJCart:
You can specify background color for ViaJCart with BgColor parameter. The color is defined by three numbers that represent Red, Green, and Blue values of 0 to 255.

You can define any color combination with these three values.

Example:
light blue  : BgColor=153,204,255
red           : BgColor=255,0,0
blue          : BgColor=0,0,255
black       : BgColor=0,0,0
 

Main ViaJCart window horizontal and vertical parameters:
The HSize parameter specified horizontal size of the main window in pixels. Use "0" for Maximum Horizontal Size. This will automatically adjust the cart Main Window to the client's screen resolution.

The VSize parameter specifies vertical size of the main window in pixels. Use "0" for Maximum Vertical Size. This will automatically adjust the cart Main Window to the client's screen resolution. Or you can set cart to 640x480, for example.

Example: HSize=640.
              VSize=480

ViaJCart CheckOut Form window horizontal and vertical parameters:
The ChkOutHSize parameter specifies horizontal size of the checkout windows in pixels.
The default set at 500 pixels.

Example: ChkOutHSize=500.

The ChkOutVSize parameter specifies vertical size of the checkout windows in pixels.
The default set at 400 pixels.

Example: ChkOutVSize=400
 

Main ViaJCart window button colors:  
The BtnColor parameter specifies button transparent color.

Example: BtnColor=204,204,204

When you move mouse over the button the color will change.
You specify that via BtnChgColor parameter.

Example: BtnChgColor=230,230,230
 

Initial Welcoming messages:
You can have up to two lines of welcoming messages under the the banner image when ViaJCart starts. See examples below:

LogoBannerLn1=Welcome to our company on-line Catalog !
LogoBannerLn2=We have the largest selection !

You can suppress these messages if you like by specifying '*'.

Example:
LogoBannerLn1=*
LogoBannerLn2=*
 

Audio files for buttons on the main ViaJCart window:

The following parameters are used to specify audio .au files for Search, Shopping Cart, Checkout, Help and other buttons. Usually they reside in the "Sys" directory but can be placed in any directory.

Example:
BtnMenuClick=Sys/2clicks.au
BtnMenuOver=Sys/1click.au
BtnSortPriceClick=Sys/2clicks.au
BtnSortPriceOver=Sys/1click.au
BtnSortDescClick=Sys/2clicks.au
BtnSortDescOver=Sys/1click.au
BtnSortItemClick=Sys/2clicks.au
BtnSortItemOver=Sys/1click.au
BtnSearchClick=Sys/2clicks.au
BtnSearchOver=Sys/1click.au

Disabling Menu and Sort buttons:

You can completely disable Menu and Sort buttons by specifying ‘*’ in "Click" parameter for the given button. Only Menu, SortPrice, SortDesc, and SortItem buttons can be disabled.

Main ViaJCart window buttons panel background color:
This is similar to ViaJCart background color above.

Example: BtnPanColor=204,255,204
 

Colors:
These are additional color definitions that can be customized to your needs.

CatPanColor is the background color for insert catalog messages that are optional.
The InsPanColor is for banner background.
The HeadPanColor is for items list headings background panel color.

Example:
CatPanColor=204,200,204
InsPanColor=153,153,204
HedPanColor=204,204,153
 
The best way is to try several different setting and see what happens. 
This is similar to ViaJCart background color above.
 

Status line background color:
This is similar to ViaJCart background color above.

Example: StaPanColor=255,255,204

List Color on the Main and Shopping Cart Windows:
The ListColor controls background color of Items List on the Main and Cart Windows.

Example: ListColor=255,255,204


Use HTML pages to display individual items:
If you want to use HTML pages to display catalog items instead of regular Java Based dialog item window you will need to do the following 4 steps to make this work correctly. You must use HTML Frames if you choose this option.

The JSCAudio.htm will load random music page into invisible frame.


Item Dialog Window Properties:
You can control this window by changing one of the ItemXxxxxxxxx parameters. The ItemHSize and ItemVsize control Horizontal and Vertical size of the window. You can put image or the right of left site by specifying ItemPicture=R or ItemPicture=L. The ItemTextLineSize controls when each line will wrap around if you put long item description in the catalog file itself instead of creating a separate text description file. The ItemTextFont gives you the choice of two fonts. Use ItemTextFont=T for Times-Roman or ItemTextFont=C for Courier. The ItemTextFontSize Controls the size of selected font. You can control text color by ItemTextForeground. The background text color is control by ItemTextBackground.

Real-Time processing URLs:
You can process credit cards in real time and even allow to download files after order was processed. The SSLURL and DownLoadURL parameters are used for this purpose. Please read chapter on Real Time processing to see how they work. If you don’t need this functionality disable the by specifying ‘*’

SSLURL=*
DownLoadURL=*

CGI Server, Script, and Port setup:
If you decide to use CGI script to process orders (see other options below) you will need to specify your Web server (usually the same as your site URL), directory of CGI script (usually /cgi-bin), and port number (usually 80) by setting CGIserver, CGIscript, and CGIport parameters. See example below. If you want to disable this put '*' as a server name. For more information check the Troublesshooting part of User Manual.

Example1: Enable CGI processing
CGIserver=www.vssd.com
CGIscript=/cgi-bin/JSCCGI110.pl
CGIport=80

Example2: Disable CGI processing
CGIserver=*
CGIscript=/cgi-bin/JSCCGI110.pl
CGIport=80

$filepath = "../jsc2/Ord/" ;
to:
$filepath = "../yourpath/Ord/" ;


Displaying customer receipt in the Browser:
You can display a customer receipt in the Browser’s window at the end of the processing by setting DisplayReceipt=Yes. The "No" value will disable this feature. You MUST use CGI scripts versions 1.1 and higher. In this case you have JSCCGI110.pl and JSCSMTP110.pl. If you have your own custom script and you want to have this feature the script will have to be changed.


Mail Server Setup:
One of the requirements for ViaJCart to be operational is to have SMTP mail server available on the site where you keep your ViaJCart Applet. This is a security restriction of Java Applets. The applet must be on the same server. You can also use FTP instead of  SMTP to save your orders on the site. Read FTP Server Setup section.

How do you know if you site has SMTP enabled?

The way to check it is by running Telnet program. Follow these steps:
1. Click on "Start" button
2. Select "Run"
3. Type "telnet" in the text field. Click "ok". Telnet program window will open.
4. Click "Connect" from the top menu
5. Select "Remote System...". "Connect" Dialog box will open.
6. Specify "Host Name" - www.yourdomain.com
7. Specify "Port" 25. Click "Connect".
8. You should see a message similar to this '220 yourservername.com ESMTP sendmail 8.8.5 ready' if you have a server. Otherwise Telnet will wait for awhile and produce an error message.

.For example if your domain is www.yourdomainname.com and it has SMTP mail server running you specify.
SMTPserver=www.yourdomainname.com and SMTPrelay=*
The EmailName and EmailFrom specify your company name and email for orders. You can disable Email process and save the orders on your site for later download via FTP.
The SMTPserver=* will disable email process.

Example 1:

SMTPserver=www.yourdomain.com
SMTPrelay=*
EMailName=VSSD_Orders
EMailFrom=Orders@yourdomain.com

 
On some systems you have SMTP server running but it has some restrictions. For example some providers allow you to send mail to people on the same server only. If you try to send it to someone else it will be  rejected. This will limit the use of your shopping  cart. The solution for this situation is to enable FTP method at the same time. This way you will receive your order and the customer will get a receipt at the end of the Checkout process when HTML receipt is displayed. You must set and encrypt FTP parameters correctly and specify DisplayReceipt=Yes in JSC.ini.

Example 2: Disable SMTP method.

SMTPserver=*
SMTPrelay=*
EMailName=VSSD_Orders
EMailFrom=Orders@yourdomain.com


FTP Server Setup:
You can use regular FTP protocol to save orders on your site and download them later. Many Web and/or ISP provides do not have mail server SMTP available on the same HTTP server where you keep your HTML pages and your ViaJCart files. If this is the case you will have to disable SMTP server (see previous section) and use FTP protocol instead.

Almost every web site has to have an FTP access.  How else can you upload you html pages and images to the site. ViaJCart uses the same method to save encrypted orders on your site. All you have to do is specify certain FTP information in the JSC.ini file. The FTPserver parameter specifies your FTP server name which is usually the same name as your site address. If you need to disable FTP process use "*" as the server name (Example: FTPserver=*). The FTPuser contains user login id.  It is encrypted for privacy. You cannot specify this parameter simply by typing your user id here. You need to use JSCD utility program to encrypt your user id. The JSCD will ask you for the location of the JSC.ini file and will make all needed updates in this file. See Chapter 6.

The FTPpassword parameter is similar to FTPuser but contains your FTP encrypted password. You need to create it with JSCD utility as well. The FTPdir specifies the directory that you want to go to when saving your orders with this method. This name must conform with the Operating System standards that is used on your server.

You can use both SMTP email and FTP methods at the same time.  The check out process will take a little longer if you do that.

Example 1: Enable FTP process

FTPserver=www.yourdomain.com
FTPuser=54876678987488
FTPpassword=4476456654876678987477
FTPdir=/Ord

Note: In addition to uploading the customer order into FTPdir the cart will also upload the customer receipt and then will display it in the Browser so that the customer can review or print it immediately. Make sure to remove files from this directory periodically.

Example 2: Disable FTP process

FTPserver=*
FTPuser=*
FTPpassword=*
FTPdir=*


Password for Orders:
Encrypt this parameter using JSCD Decrypt program. If you use Demo ViaJCart use Demo Decrypt. If you use Licensed ViaJCart use Licensed Decrypt program.

Example: PSW=18456654876678987456

Real Audio:
The Real Audio Player has conflict with .au audio files which are natively supported by Java. If you play .au file and play Real Audio after that some systems will freeze and have to be rebooted. To solve this problems you can disable or enable real audio. If you set RealAudio=Yes the .au files  will not be played. The RealAudio=No will enable .au files. To actually use real audio with your shopping cart you need to use HTML frames. You need to have one  Empty frame for Real Audio player. See Chapter on Audio for more details.

Background Music:
You can have MIDI background music randomly selected from a list by ViaJCart to enhance shopping  experience. The Music parameter controls this functionality. Each entry have time:audiopage.htm  format. See Chapter on Audio for more details.

Default Banner URL:
You can link default logo banner to the URL of your choice. If you click on the banner the new Browser's page will open and display specified page.

Example: LogoBannerUrl=http://www.vssd.com

Fast CGI Search:

Now you can search your database in seconds with new JSCSearch.pl script. To enable this option change "CGISearch=Yes" and upload JSCSearch.pl script in ASCII mode to your cgi-bin directory. Make sure to specify your Java cart directory in the script by changing $DIR = "/usr/www/users/yourdomain/jsc2/" to your path.

Example1: If you have CGIscript=/cgi-bin/JSCCGI.pl The search script will be: JSCSearch.pl

Quick Image window:

You can disable Quick Image window by specifying QuickImage=No. To enable it set it to Yes QuickImage=Yes.

Example 1: pixel position of 400x300 with size of 80 pixels for width and height.

Example 1: Subtotal=Yes

Example 2: Subtotal=No

There are three parameters in the JSC.ini file to control screen 1, 2 and 3.

ChkOutWin1=@,y,y,y,y,y,n,n,*,*
ChkOutWin2=n,n,n,n,n,n,n,n,n
ChkOutWin3=y,y,y,y,y,n

Each Flag corresponds to a specific field on the given screen.

The Flag has the following values:

y - field required
n - field not required
* - remove this field
@ - field required and validate for email address

You can also remove the second screen (Shipping To Address) by specifying ChkOutWin2=*

Example 1: Enable all 3 screens; remove last two fields

ChkOutWin1=@,y,y,y,y,y,n,n,*,*
ChkOutWin2=n,n,n,n,n,n,n,n,n
ChkOutWin3=y,y,y,y,y,n

Example 2: Remove second screen

ChkOutWin1=@,y,y,y,y,y,n,n,*,*
ChkOutWin2=*
ChkOutWin3=y,y,y,y,y,n

 

You can control the default search setting. Currently when you open the Search Dialog Window the "Current Catalog" option on the "Look in:" line is selected.

Only the current catalog will be searched, not the whole database, when you click "Search" button. To do a search on the whole database you need to select "All Catalogs" option. Some people fail to do this and they search current catalog only. To help them you can set "All Catalogs" option by specifying SearchAll=Yes parameter.

next

Chapter 1 - Installation
Chapter 2 - JSC.ini control file
Chapter 3 - Menu file creation
Chapter 4 - Catalog files
Chapter 5 - Checking out process
Chapter 6 - Order; Encryption/Decryption process
Chapter 7 - ViaJcart Customization with JSCStrings.ini
Chapter 8 - Audio Setup
Chapter 9 - Real-Time Credit Card Processing
Chapter 10 - Troubleshooting
Chapter 11 - Upgrade From 1.x to 2.x

Copyright © 1996-2000 Vilgorin Software Systems Development.
All Rights Reserved.