Rev 14 Documentation
BCL is a Leasing Company. They bill and collect lease payments and the maintenance and meter billing overage charges for some La Crosse System dealers. New LMS customers will be added as they sell it to them. The BCL company will let us know when an LMS customer has purchased it. There is an LMS install fee of $----.-- A service call will be placed on technician 1 or the programming screen to set this up.
BOLT is the on-line application software the customer will have for the remote uploads to BCL.
The program BCL will need to be sent to them. For SuperDOS, send the program 5:30:BCL.SR from our side to 5:30 or 6:30 on their side. For Non-SuperDOS, send the program from \CONVERT\LMS\BCL.bb to their \UBL\LMS\SRC\BCL.bb directory.
The LMS Customer will set up a bill to customer as the BCL customer number. You will need to get that number from them and add it to this BCL program. You will need to EDIT the program and go down to the line after 581. You will add a new line with the following :
The following is a sample section of the program. Since all the lines are remarked out in this example, it will do all bill to customers and not separate just the one requested. You will need to make sure and add or modify the line at the customer site for their particular BCL bill to customer number.
0550 KNEXT 2,BUF$,KEY$,R1 :INVHDRX
0560 IF R1<=0 THEN GOTO 9900
0570 POSITION FILE[1,R1*512]
0580 READ FILE[1],H$
0581 IF H$[250,250]="V" THEN GOTO 0550 :VOIDED INVOICE
0582 :IF ASC(H$[41,44])=5323533 THEN GOTO 0585 :STRINGER
0583 :IF ASC(H$[41,44])=13285371 THEN GOTO 0585 :THE COPY MAN LV
:IF ASC(H$[41,44])=3285371 THEN GOTO 0585 :THE COPY MAN SLC
:IF ASC(H$[41,44])=55000000 THEN GOTO 0585 :CAPITAL IN CHEYENE
:IF ASC(H$[41,44])=488001 THEN GOTO 0585 :OFFICEWARE
:IF ASC(H$[41,44])=312201 THEN GOTO 0585 :OFFICEWARE
:IF ASC(H$[41,44])=212001 THEN GOTO 0585 :OFFICEWARE
:IF ASC(H$[41,44])=3285371 THEN GOTO 0585 :OFFICE CONCEPTS
:IF ASC(H$[41,44])=3285371 THEN GOTO 0585 :COPY VEND
:IF ASC(H$[41,44])=22259500 THEN GOTO 0585 :MOM
0584 GOTO 0550
0585 IF BDTE$="A" THEN GOTO 0596
0586 LET TDATE=ASC(H$[29,32])
Once the BCL source code has been modified you will need to compile the program. On SuperDOS to compile you will enter in the following at the > prompt, BCOMP286 5:30:BCL.SR 5:30:BCL/P and return.. On Non-SuperDOS you can IMPORT BCL.bb or do the instructions of “NEW, “ENTER BCL.BB, “REPLACE BCL, move the object code from the data\amsrc directory to the progs directory. If there are any errors, please verify the line you just added for any mistakes.
The program will need to be put on the Billing custom menu program of BIMU005. You will need to edit the existing program of BIMU005.SR/.bb. You will need to look for a line similar to the following:
0190 DATA "SPARE","SPARE" and change it to read 0190 DATA “BCL”,”BCL Download”. You will need to compile this program also. On SuperDOS to compile you will enter in the following at the > prompt, BCOMP286 5:30:BIMU005.SR 5:30:BIMU005/P and return.. On Non-SuperDOS you can IMPORT BCL.bb or do the instructions of “NEW, “ENTER BIMU005.BB, “REPLACE BIMU005, move the object code from the data\amsrc directory to the progs directory. If there are any errors, please verify the line you just changed for any mistakes.
RUNNING THE BCL PROGRAM
The LMS customer will create the contracts and bill these service contracts through the LMS Contract Billing program. The customer should not set up the contract with accessories on it. Please make the customer aware of this.
When they are ready to send this information to BCL they will need to run the BCL program that you set up on the Billing custom menu. Running the program takes about 5 minutes and no one should be billing contracts for BCL during this time. They will log into the LMS main menu, choose #3 for Billing, #5 for Custom, #? for BCL Download and it will display the following:
3/23/01 BCL Download 14:23
Beginning Date or A'll:
Ending Date:
M'eter Format or B'ase Format:
Use A'ccessory Sw, I'tem Type Fld, Or B'oth To Determine Accessories:
Enter Item Type For Accessories:
Notes: ^ = Go Back 1 Space / = Cancel
Beginning Date Or A’ll
Ending Date
Enter the range of dates to download to BCL. The program will be looking at the transaction date of the invoices to determine if they are within the date range entered at these prompts.
M’eter Format or B’ase Format
The download will need to be run once for meter information and once for base information. One file will be created for each format. The base information, the file created is called BCL.BSE. The meter information is in a file called BCL.MTR. These two files will need to be transferred to where the BOLT software is loaded. These files will be overwritten with new information every time you run the BCL download program.
Use A’ccessory Sw, I’tem Type Fld, Or B’oth To Determine Accessories
Accessories should be excluded from the BCL download. At some dealer sites, the Accessory Y/N field in the Item File is set to Y for yes on accessories. At other dealer sites, accessories have an Item Type in the Item File set to a certain Item Type. Some dealer sites use both methods. Determine how your site distinguishes accessories and answer accordingly.
Enter Item Type For Accessories
If I for Item Type or B for both are entered at the previous prompt, the program will ask you to enter the item type used for accessories. This is the Item Type in the Item File.
BCL.BSE will have the following similar information of:
Serial#, Model#, Multiple S/A#, Invoice#, Coverage End Date
9999,SF90,GMA-S,96243,7/14/99
F21,F2500,GMA-S,96244,7/14/99
F23,F2500,GMA-S,96252,9/30/98
F23,F2500,GMA-S,96253,10/31/98
F23,F2500,GMA-S,96254,11/30/98
F23,F2500,GMA-S,96288,7/31/98
F23,F2500,GMA-S,96289,8/31/98
BCL.MTR will have the following similar information
Serial#, Model#, Invoice#, Overage Charge Amount, Overage Coverage End Date, Current Meter Reading, Service Copies
F23,F2500,96288,0.00,6/30/98,450,
F23,F2500,96289,3.75,7/31/98,1250,
FILE LOCATION OF BCL.BSE/BCL.MTR
For SuperDOS, the BCL.BSE and BCL.MTR files will be created/written to the first drive and user group of the search list and will most likely be 5:15 or 6:15. To verify this, log into Billing and enter in two colons (:: ) to be at the > prompt. Enter in MMI SE and return to show the search. To verify there is information in these files, enter in at the > prompt, TYPE BCL.BSE or TYPE BCL.MTR.
FILE LOCATION OF BCL.BSE/BCL.MTR
For Non-SuperDOS, the BCL.BSE and BCL.MTR files will be created/written to the first directory of their environment. This will usually be the UBL\LMS\DATA\AMSRC directory. To verify this, log into Billing and enter in two colons (:: ) to be at the * prompt. Enter in RUN”PATH and return, at filename enter in ? and return to display the first directory. Or at filename, enter in BCL.BSE or BCL.MTR to display the directory the programs will be located on. To verify there is information in these files, enter in at the * prompt, !TYPE BCL.BSE or !TYPE BCL.MTR.
The files will need to readable and accessible to the BOLT Remote Upload software. The BCL.BSE and BCL.MTR files are created in the ascii format with comma delimited fields. The following instructions are to transfer the files to BOLT for each LMS Operation System.
There are a couple of different processes the customer can use, depending on what they have and what they are comfortable with. If they have questions on using PC Connect or FTP/Tiny Term to transfer the programs, they will need instructions from hardware support. The set up that all SuperDOS LMS customers can do is the following. They will need a blank diskette and access to the main server. Insert the diskette into the diskette drive. At the main server, on the main task 1, log into their BEGIN password. At the > prompt, enter in PCXFER/S 5:15:BCL.* A:\. This will copy all BCL files from SuperDOS drive 5, user group 15 to a DOS floppy diskette in drive A. They are then able to take this diskette to where the BOLT software is loaded and copy it on. The BCL Company can help them at this point.
IP address information for SuperDOS is displayed on the command line of the SOCK password.
The only way to transfer the program is through File Transfer Protocol (FTP).
The customer should know what their IP address is. A couple ways to find out depending on what they are running. If they are running Tiny Term, the Comms will show the IP Address under the Network Node. If they are running UGI, open the session, click on Preferences, click on Comms, the TCP heading will display the IP address. Otherwise, log into the root login and at the # enter in netconfig and return. This will bring up a gui screen that you can tab to move around. Under the Network Card section, highlight the SCO TCP/IP. Then tab to the VIEW PROTOCOL CONFIGURATION and return. This will show information including the IP address. Click on OK, tab to HARDWARE and choose Exit to get back to the # prompt. At the # prompt, enter exit to log off.
For the first time, the customer will need to create a BOLT directory to hold the files. This should be done on the PC desktop that the BOLT software is loaded on. You can go into Windows Explorer and under the C drive, create a folder called BOLT or at the MS DOS prompt, under the C drive, create the directory by doing md BOLT.
At the same PC desktop that the BOLT software is loaded on, log into the MS DOS prompt, and go to the root of the C drive (C:\>). Enter in cd BOLT to display C:\BOLT>. Enter in ftp IP address#. You should connect correctly and will display the User logon. Enter in root and return. It will then display the Password logon for root, enter this password in. When you have connected correctly it will display an ftp> prompt. At this prompt, enter in cd /lms/ubl/data/amsrc and return. This directory is where the files are located from the above instructions. The valid directory should be displayed and you will be back at an ftp> prompt. At this prompt, enter in mget BCL.* and return. The program will display that it transferred properly the two files of BCL.BSE and BCL.MTR and return to the ftp> prompt. At this prompt, enter quit and return. This will return you to the C:\BOLT> prompt. These files are now located on the C drive, in the BOLT directory and are then ready for the BOLT Remote Download. The BCL Company can help them at this point.
NT
For the first time, the customer will need to create a BOLT directory to hold the files. This should be done on the PC desktop that the BOLT software is loaded on. You can go into Windows Explorer and under the C drive, create a folder called BOLT or at the MS DOS prompt, under the C drive, create the directory by doing md BOLT.
In Windows Explorer you can click and drag the files of BCL.BSE and BCL.MTR from the drive and directory these files were located, D:\UBL\LMS\DATA\AMSRC, to C:\BOLT folder. These files are now located on the C drive, in the BOLT directory and are then ready for the BOLT Remote Download. The BCL Company can help them at this point.
IP address for NT, right click on Network Neighborhood and then on the Network icon will display the IP address.