The World of Computer Software/World_Of_Computer_Software-02-385-Vol-1of3.iso/p/pdl318.zip/PDL.DOC

Text File | 1992-12-04 | 26KB | 636 lines

                          Pro Down Load
                  Copyright 1990-1992 by FlexSoft

                            INTRODUCTION
                         ------------------
Pro Down Load or PDL was developed to assist the technical trader by
providing a convenient method of automatically collecting daily stock,
bond and mutual fund quotes from the Prodigy(R) Service.  The
downloading facilities available to the Prodigy(R) user have been
consistently improved over the past year and the result is a highly
reliable source of securities price data.


WHAT DOES IT DO?
----------------

The basic function of PDL is to download stock, bond, mutual fund and
market index data.  It gets this data from the Prodigy service's QUOTE
TRACK function by using an easily maintained, user generated quote
request file (often referred to as the PDL.IN file) and places the print
image text in a user defined output file (referred to as the PDL.OUT
file).  The setup procedures and a sample file are included later in
this document.

A second feature of PDL is the ability to collect the information from
the MARKET CLOSE function of Prodigy.  The screens that are captured
provide direct access to a large number of indicators and indirect
access to some additional derrived indicators.  An example of a directly
accessed indicator is the DJ-30, the closing price of the Dow Jones
Industrial Average.  A derrived indicator might be the cumulative
difference of the new highs minus the new lows.  The PDL user can access
the direct indicators using editors, spreadsheets or various other
software products.  The derrived indicators require the use of PTT since
they are calculated from the direct information.  One of the
shortcomings of the Prodigy indicators is that only the close values for
the indicators are recorded.

There are a number of newly added index symbols available from
Prodigy(R) which can be downloaded using the same format as a stock.
These indicators begin with the character '&' to distinguish them from
other symbols.  Refer to Quote Check, About - Special Symbols for more
information.

SUPPORT
------------

PDL was written as a companion program to Personal Ticker Tape (PTT)
which is designed to load and update Metastock Professional
data files from a variety of sources using a variety of input formats.
Although PTT is a companion program, it is not required to get full use
of PDL but rather uses the PDL output as an update source.  PDL print
image files are recorded in a format that is usable by most
spreadsheet and database programs that employ format descriptors.  Of
course the data can also be accessed and edited using a standard ASCII
text editor such as EDLIN.

Each of these programs (PDL & PTT) requires registration to receive
full technical support although users are encouraged to redistribute
copies of the entire package for demonstration purposes.  Both
programs are distributed and run in a trial, or limited demonstration
mode.   PDL provides a limited use (20 quotes per session) demo.
During the trial period, the authors will attempt to answer questions
about software install and configuration.

As a registered user, you will be have access to enhancements to the
products as they become available and also be entitled to any available
technical fixes to the version for which you are licensed.  This
includes changes required to accommodate new formats in the Prodigy
service data, and assumes that the required data is still available.

You can register any FlexSoft Product(s) online by calling the FlexSoft
BBS at 510-829-2293 (VISA/MasterCard Only).  In addition, you can send
your name, address, VISA/Mastercard # and expiration date to JBMD65A to
register PDL immediately.

If you wish to register by check, print the the REGISTER.DOC file, fill it
out, and send it to the address given on the form.

Questions should be directed to the Prodigy(R) Money Talk Bulletin Board
under the topic "Other Investments". You may use one of the existing PDL
topics or create a new one.  The authors monitor this board for any
topic beginning with PDL.  Address questions to CBGB69A or JBMD65A.

Technical problems can be reported:
       on Prodigy ID   - CBGB69A        Rick Woodcock
If you report a technical problem, be sure to include your registration
code, a thorough description of the problem, a copy of the PDL.CNF file,
a copy of your AUTOEXEC.BAT and CONFIG.SYS files and specify the DOS
version that you are using.





                          HOW TO USE PDL
                      -----------------------


PREPARING YOUR QUOTE LIST
----------------------------

PDL requires the use of a standard text editor and a few minutes of your
time to set up the list of symbols that you wish to download.  This list
is stored in a file referred to as the PDL.IN file.  The actual name of
the file can be any legal DOS filename, but the default name is PDL.IN.
The list contains one line for each Stock, Fund or Bond quote that you
want to download.  Each line contains an indicator specifying the "type"
of quote (Stock, Bond, Fund or indeX) and the symbol.  The "type"
indicator is defined as:

           "S"     - stock symbol
           "F"     - fund symbol
           "B"     - bond symbol
           "X"     - market close page or special indicator

For example, to get a quote for Apple Computer (AAPL), a stock, you
would type in the line:

           S AAPL

And for JANUS FUND (JANSX), a fund, you would type in:

           F JANSX

Similarly, for a bond, you would precede the symbol with a "B".

To get the Market Close page containing the AMEX closing information you
would type in:

           X AMEX


The available Market Close page names are:
  X AMEX        American Exchange Summary
  X NYSE        New Your Exchange Summary
  X US          US Stocks Summary
  X KEY         Key Rates and Bonds
  X NASDA       NASDAQ Closing Summary
  X CLOSI       Closing Futures Prices
  X FOREI       Foreign Exchange Currencies
  X MFUND       Mutual Fund close page
  X AACTV       AMEX most actives
  X NACTV       NYSE most actives
  X QACTV       NASDAQ most actives
  X UPDAT       Market Update summary (US Stocks)

Normally you will want to include all of these in your quote list.

Switching between "B", "S" and "F" types cause mode switches within
Prodigy that take time.  You can obtain the best performance by
grouping all symbols of each type together so that all stocks are
requested sequentially, followed by all fund requests, followed by
all bond requests.  PDL will not get confused if you mix up the types
but the time that it takes to download can be greatly extended.



PDL AUTOTRAK
------------

PDL AUTOTRAK is a new feature implemented in PDL316 that makes use of
the new personal quote lists available in Quote Track.  To activate PDL
AUTOTRAK place the following line "L ###" in front of all of your
individual symbols in the PDL.IN file. For example:
        L ###
        S AAPL
        S ASA
        S BEV
        F MRPAX
        X AMEX
        ...
This tells PDL to collect all of the S, F, and B symbols that follow
into personal quote lists and use the Quote Track function to download.
These files will contain up to 50 quotes each and will be stored in the
Prodigy directory. You do not have to worry about maintaining the
personal lists, PDL will rebuild them from the PDL.IN file each time it
starts up. They will be named "PDL#" followed by a sequence number.

PDLMIS will detect missing symbols and will attempt to restart Prodigy
to retrieve them.  It will rety up to the number of times that is
specified in the RETRIES = parameter during the configuration and setup
process.  If a symbol is reported by Prodigy as "INVALID SYMBOL" PDLMIS
will not report this symbol as missing since there is nothing to be
gained by retrying and invalid symbol.  This feature works with PDL
AUTOTRAK only and is not available for other personal Quote Track lists.


PERSONAL QUOTE LISTS
--------------------

Quote Track provides you with the ability to build and name lists of
securities on your own hard disk.  While there is no real reason to do
this (PDL AUTOTRAK replaces the function), you may want to have some
"special" lists saved under unique names.  PDL supports these lists with
the type 'L' function.  The following format is used to include the
lists:     L <filename>

For example, if you had a personal list that you built and saved (using
the Quote Track facility) as "MYSTOCKS.IN" you would enter:
        L MYSTOCKS.IN

You can also combine personal lists with PDL AUTOTRAK as long as you
place all personal lists at the beginning of the file. For Example:
        L MYSTOCKS.IN
        L ###
        S ASA
        S BLY
        S IBM
        S GM

Any lists that appear after the "L ###" symbol will be ignored.

PDLMIS cannot detect missing tickers inside of personal lists.  If any
of these symbol is not found, PDLMIS will not return an error.


SPECIAL SYMBOLS
---------------

Prodigy recognizes a number of special symbols that are referred to as
the &*** symbols. These represent specific market indicators. A complete
list is available on Prodigy.  These symbols are supported as type 'S'
in PDL and are entered in the PDL.IN in the same manner as a stock
symbol.  For example:
        S &DJIA
        S &DJT
        S &DJU
        S &DJC
They can be treated in much the same manner as other symbols in that
they are included in Quote Track lists.


RUNNING PDL
-----------------

PDL has a default quote list file named "PDL.IN".  If you choose to name
it something else, you will need to tell PDL by running the PDLCONF
program.  This will change the input file name in the PDL.CNF file and
also in the PDLRUN.BAT file.  In addition, it stores the Prodigy quotes
in a file called "PDL.OUT" unless you give the output file another name.

PDL is started by entering the command PDLRUN at the DOS prompt.  If you
get a DOS message "Out of Environment Space", you will have to increase
the environment size by placing a SHELL command in your CONFIG.SYS file.
A typical SHELL command is:
   SHELL = C:\COMMAND.COM /P /E:512
If you are running PDL & Prodigy in a DOS window under Microsoft Windows
and continue to have problems with environment space, place the
following in your AUTOEXEC.BAT file:
   SET TRY = 0
   SET PDLRUN = OFF
This will reserve space for the PDL environment variables.

PDL is ALWAYS run from a batch file.  A typical batch file, such as
PDLRUN.BAT which is built by the PDLCONF program follows:

echo off
echo *********************************************************************
echo *                       PDLRUN.BAT                                  *
echo *********************************************************************
set TRY=0
set PDLRUN=ON
cd C:\PDL318
pdl PDL.IN PDL.OUT
:newtag
pdlmis PDL.IN PDL.OUT PDL.NEW
if ERRORLEVEL 1 GOTO :more
GOTO :endit
:more
GOTO :T%TRY%
:T0
goto :nogood
:T1
set TRY=0
goto :tag
:T2
set TRY=1
goto :tag
:T3
set TRY=2
goto :tag
:T4
set TRY=3
goto :tag
:T5
set TRY=4
goto :tag
:T6
set TRY=5
goto :tag
:T7
set TRY=6
goto :tag
:T8
set TRY=7
goto :tag
:T9
set TRY=8
:tag
pdl -a PDL.NEW PDL.OUT
GOTO :newtag
:nogood
echo Retry count exhausted - PDL terminating
:endit
copy HISTORY.FIL+PDL.OUT HISTORY.FIL
set PDLRUN=OFF

Most of this batch file is concerned with checking for missing quotes
and restarting PDL if a failure occurrs.  There should be no need to
edit this file other than by using the PDLCONF program.



                             PDL FILES
                             ---------


PDL INPUT AND OUTPUT FILES
--------------------------

The input and output files for PDL are defined using the PDLCONF
program.  To change the names of these files, start PDLCONF, go to the
Change Startup Parameters screen to make the changes, press F10 to
accept them and then select the Update Parameter Files option to build
the new PDLRUN.BAT and PDL.CNF files.

The default quote list file name is PDL.IN and the default output
filename is PDL.OUT.  If you have no need to change these names, it
might make things simpler to just use the defaults. The PDL.CNF and
PDLRUN.BAT files should never be edited directly since they have inter
dependencies. They should only be changed using the PDLCONF program.


THE PDL.CNF FILE
-------------------

The following is for information only.

The PDL.CNF file contains many of the parameters that PDL needs to start
and run correctly.  The following is the format of the file:

USERID = ABCD99                your Prodigy UserID
PASSWD = BANANA                your Prodigy Password
REG_CODE = UNREGISTERED        your PDL registration code
COMM_PORT = 3F8                your modem port address
LOGON = PDL                    the type of logon requested
NICKNAME = JOHN                your Prodigy Autologon Nickname
P_DELAY = 400                  delay after printing to a file
D_DELAY = 400                  context switching delay
RETRIES = 0                    number of attempts to restart Prodigy
PRODIGY_PATH = C:\PRODIGY      the Prodigy drive and directory
PDL_PATH = C:\PDL              the PDL drive and directory
INFILE = PDL.IN                the input file name
OUTFILE = PDL.OUT              the output file name
NEWFILE = PDL.NEW              file to hold missing quote list
HISTORY_FILE = HISTORY.FIL     file to hold archived pdl.out files
NEXT PROGRAM CALL = PMLRUN.BAT name of program or batch file to run
                                after PDL completes


KEYBOARD COMMANDS
------------------------

PDL has four keyboard commands which are available for limited control
and alteration of PDL functions.

   ALT-S   - Suspend keystroke input
   ALT-R   - Resume 'suspended' keystroke input
   ALT-B   - Begin keystroke input from the top (for MANUAL logon)
   ALT-X   - Exit. Causes PDL to release all interrupt vectors. This
             command does not terminate Prodigy.

Under normal conditions it will not be necessary to use these commands
and they can be a little trickey to use.  As you become more familiar
with the PDL and Prodigy sequences you may want to try them out.


PDL INSTALL PROCEDURE
-------------------------

PDL comes in a ZIP file named based on the version of the program.
Suppose you have PDL318.ZIP (which is version 3.1.8) of the software.
This installation assumes you are placing PDL in your \PDL318 directory
on drive 'C':

   1) Create the PDL directory using the DOS MD command and make that
      the current directory.
                             c:
                             md c:\pdl318
                             cd c:\pdl318

   2) Use PKUNZIP to extract the contents of PDL318.ZIP into your
      \PDL318 directory.

      You should have the following files:

     PDL.EXE      -  Main program which passes keystrokes to Prodigy and
                     places output in a file.
     PDLKEY.COM   -  Program to translate your quote list to keystrokes.
     PDLMIS.COM   -  Program to check for missing quotes.
     PDLSCHED.COM -  The Vacation Scheduler program
     PDLSCHED.CTL -  Control file for Vacation Scheduler
     PDLCONF.EXE  -  The PDL configuration program.
     PDLCONF.HLP  -  The help file for PDLCONF.
     PDL.IN       -  A sample input file.
     PDL.DOC      -  This document
     REGISTER.DOC -  Registration form for PDL
     PDLRUN.BXT   -  A template file used by PDLCONF to create
                     PDLRUN.BAT
     READ.ME      -  Quick start & last minute changes

   3) Create a file called PDL.IN containing your Stock, Fund,
      Bond and indeX symbols.

   4) Start the configuration program by entering PDLCONF at the DOS
      prompt.  Follow the instructions in PDLCONF.  Don't forget to save
      each screen by selecting the F10 key and to save the PDL.CNF and
      PDLRUN.BAT files by selecting Update Parameter Files.

   5) Type PDLRUN to start PDL and Prodigy.



VACATION MODE
-------------

Vacation Mode of operation provides a method of automating the startup
of PDL on specific days or dates at a specific time.  There are two ways
that this may be accomplished.  The first assumes that the computer will
remain turned on for the duration of the unattended period.  The second
assumes that power on/off control will be used to start the computer and
that the autoexec.bat file will start PDLSCHED, the scheduler.   The
scheduler is started by executing the PDLSCHED command from the PDL
directory.

Method 1 - Power On
A sample PDLSCHED.CTL file could contain the following:
        INCLUDE:ALL
        EXCLUDE:SAT
        EXCLUDE:SUN
        START:18:00
        WAIT:
This tells the scheduler to run PDL on every day except saturday and
sunday, to start the run at 6PM and to re-enable the scheduler for the
next day and WAIT for the correct start time.

Method 2 - Power control
This method assumes that you have a way to automatically turn on the
power at the time you wish the scheduler to start.  You will also
need to add statements to your AUTOEXEC.BAT file to change the
directory to the PDL directory and execute the PDLSCHED command. The
PDLSCHED.CTL file could contain the following:
        INCLUDE:ALL
        EXCLUDE:SAT
        EXCLUDE:SUN
        EXCLUDE:12/25/92
        START:18:00
This tells the scheduler to run PDL on every day except saturday and
sunday, to start the run at 6PM and to return to DOS after the run
completes.  It also contains an example of how to exclude a specific
date, in this case December 25, 1992.

The PDLSCHED program provides the option of changing the name of the
PDLSCHED.CTL file on the command line.  For example:
        PDLSCHED NEW.CTL
causes the scheduler to use a control file named NEW.CTL.

One easy way to set up your system for method 2 is to build a bootable
floppy disk that contains a copy of your CONFIG.SYS and AUTOEXEC.BAT
from your hard disk root directory.  Add the statements needed to change
to the proper directory to run PDL. For example, in AUTOEXEC.BAT:
 BREAK ON
 PATH C:\;C:\DOS;.....  REM Your normal PATH statement
 .                      REM Other AUTOEXEC.BAT statements
 .
 C:                     REM Change to the C: drive
 CD \PDL317             REM Change to the PDL directory
 PDLSCHED               REM Call the scheduler

Starting with PDL315 the scheduler uses a method of scheduling that is
more friendly to multitasking programs such as Microsoft Windows,
DesqView and OS/2 2.0.  This new process reduces the amount of overhead
taken by PDLSCHED while waiting for a specific time interval or date.


Next Program Call
-----------------

This feature is specified using the PDLCONF program to alter the
configuration of PDL.  The most common use is to run a batch file to
convert the PDL.OUT file to some other format.  For example, to call the
PML program each time PDL is run you could:

1. Build a batch file in your root directory named PMLRUN.BAT
   containing the following:
        CD C:\PML
        PML -r
        CD C:\PDL318
2. Put the following in NEXT PROGRAM CALL using the PDLCONF program:
        C:\PMLRUN.BAT


The PDLSCHED.CTL file
---------------------

The format of the scheduler control file is as follows:
        CONTROL:VALUE
where control is the keyword INCLUDE, EXCLUDE, START or WAIT separated
by a colon from the value.  Values for INCLUDE and EXCLUDE are ALL, SAT,
SUN, MON, TUE, WED, THU, FRI or a date in the format mm/dd/yy.  Values
for START include any valid time in the format HH:MM:SS expressed in 24
hour format (e.g. 18:00:00 is 6PM).  The WAIT keyword has no values
associated with it but requires the colon separator to delineate the
keyword.  WAIT: tells the scheduler to re-enable the program after the
download completes and "wait" for the next timing interval (usually a
date change at midnight). When the midnight crossing occurs, the
scheduler will check to see if PDL should be run on that day.  If so, it
will enable itself for the time specified in START:.  If the new date or
day is one of the ones specified in EXCLUDE:, the scheduler will now
wait for the next midnight crossing to occur.


TELEPHONE LINE PROBLEMS
------------------------

If you used PDLCONF to build the parameter files, most of the restart
will be taken care of automatically.  If you selected the MANUAL logon
option or built your own startup batch file the following information
may be helpful.

Occasionally problems will arise that require PDL to do something other
than what it had planned to do next.  When these problems occur, it
will suspend the current operation using the ALT-S function discussed
earlier and exit the program.  This will prevent the unused keystrokes
from spewing out after Prodigy has already gone away.

A common problem is a "no answer timeout" which causes Prodigy to
switch to the "Try Again" screen.  When this happens, PDL may not yet
have control, depending on the type of logon process that you are
using.  In Prodigy Autologon or PDL autologon modes, the quotes will
be suspended and Prodigy will be terminated.  This allows a 'clean'
restart from the batch file.  In manual mode, the quote list will be
suspended and the 'Try Again' screen will be entered to allow you to
manually reconnect.     After this, you can enter an ALT-B or ALT-R to
resume.  This method may result in lost or duplicated quotes.

If the line drops during a session, PDL cannot tell exactly how far you
have gotten in the quotes file nor can it tell how much data has been
lost.  It simply suspends the quote requests and terminates.

All of the above recovery actions are based on PDL being able to
determine when the modem is online and when it is offline.  To do this,
PDL interrogates the CARRIER DETECT signal to make sure that Prodigy is
still connected to the service.  Your modem must be configured with "CD
follows Carrier" (HayesII - ATS21=032).  PDL will check this at startup
and warn you if "CD is always on".


DELAY CONTROL
-------------

Some machines experience problems of dropping characters from the
keystroke file after switching screens within Prodigy.  This causes the
keystroke sequences to get out of sync and occasionally jump to a screen
that you don't want.  There are two delay values that can be controlled
from the through the PDLCONF program:
            P_DELAY   controls the delay after printing; if not
                      specified the default is 400.
                      If this is inadequate, try increasing the number
                      in increments of 100.
            D_DELAY   controls the delay after switching prodigy
                      screens. This is a self adjusting time value based
                      on machine speeds.  The default is 400.  If this
                      is inadequate, the number should be increased in
                      increments of 100 until quote requests run
                      normally.


DISCLAIMER
---------------

The author has made every effort to ensure that PDL will operate in
most common environments.  However, the techniques that are used are
heavily dependent on ISRs (Interrupt Service Routines) and may not
operate correctly when used with TSR programs that intercept keyboard
or printer interrupts.  If you experience problems such as "keyboard
lockup" or runaway quote files (quote requests appearing on the DOS
command line), try removing the other TSRs and rerunning.

The author assumes NO responsibility for any damages, direct or
consequential, which may result from the use of PDL (Prodigy DownLoad).
The user must accept and agree to this disclaimer of warranty prior to
using PDL.

Some Common Problems
--------------------

PDL starts up but as soon as the Prodigy Screen appears it immediately
logs off.
  This is usually due to an incorrect COMM PORT assignment. Rerun
  PDLCONF and make sure that the port is assigned correctly. Be sure to
  accept the data using the F10 key and save the files using the Update
  Files function.

PDL starts up but the system "freezes up" when the Prodigy screen
appears.
  This is usually caused by insufficient memory for Prodigy. Make sure
  that you have at least 500,000 bytes of DOS memory available.  If you
  are using the scheduler (PDLSCHED) you should allow for 530,000.

  This problem can also be caused by memory resident programs (TSRs)
  that intercept the keyboard (hot keys). For example, PCTOOLS running
  in resident (-r) mode intercepts the keyboard and conflicts with PDL.

PDL will not logon to prodigy and a small letter 'e' appears in the
logon field.
  This can happen if you have specified LOGON TYPE = PRODIGY but you
  have not set up your Prodigy Autologon with your ID and PASSWORD. Both
  are required for Prodigy Autologon to work correctly.

The COMM PORT is correctly specified in PDLCONF but PDL still logs off
of Prodigy immediately after the Prodigy screen appears.
  This can be caused by a corrupted PDL.CNF file. Delete the file and
  rerun PDLCONF.  This will rebuild the PDL.CNF and PDLRUN.BAT files.
  Caution: PDL.CNF should not be edited with any program other than
  PDLCONF.  Any imbeded characters can cause the configuration to work
  incorrectly.



IBM is a registered trademark of International Business Machines
Corporation.
Prodigy is a registered service mark and trademark of Prodigy Services
Company