home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / DCFVBA.ZIP / DCFVBA.DOC < prev    next >
Text File  |  1990-05-07  |  7KB  |  165 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                   DCFVBA
  7.  
  8.          DCFVBA is a language translater that converts HPPCL datastreams
  9.          to IBM Document Composition Facility (Script/VS).  It was
  10.          written so documentation for our mainframe PROFS system could
  11.          be done with a PC word processor instead of using the
  12.          cumbersome DCF commands in XEDIT on the host.
  13.  
  14.          The basic flow of events are:
  15.  
  16.          o      Prepare document on the PC using your word processor of
  17.                 choice.
  18.  
  19.          o      Print to file with a printer driver that generates HP PCL.
  20.  
  21.          o      Run the DCFVBA program to convert the PCL stream to DCF
  22.  
  23.          o      Upload the DCF file to the host.
  24.  
  25.  
  26.  
  27.  
  28.                                  COMMAND SYNTAX
  29.  
  30.  
  31.          The syntax of the command follows:
  32.  
  33.  
  34.                 DCFVBA pclfile vbafile
  35.  
  36.          where "pclfile" is the name of the file that contains the PCL
  37.          file that was outputted from the word processor and "vbafile"
  38.          is the file that will contain the DCF commands and will be
  39.          uploaded to the host.
  40.  
  41.  
  42.  
  43.  
  44.                                   GENERAL NOTES
  45.  
  46.  
  47.          DCFVBA is a family application.  It will run under DOS and
  48.          OS/2.  It has been tested under DOS 4.01 and OS/2 1.2.
  49.  
  50.          Due to the restrictions of DCF, certain conventions need to be
  51.          followed when creating the document on the PC.
  52.  
  53.  
  54.          o      This program supports bold face, underlining and
  55.                 italics.  Italics are displayed by underlining those
  56.                 characters.
  57.  
  58.          o      This program will support 12 point Courier typeface
  59.                 only.  If there are other typefaces are used in the
  60.                 document, a warning message will be displayed and the
  61.                 formatting will be ignored.  If the typeface that was
  62.                 the attempted in the document is proportional, you may
  63.                 have problems with lines being too long.
  64.  
  65.          o      This program does not use the ".fo off" DCF command.
  66.                 Instead, it exploits the fact that DCF will not format a
  67.                 line that starts with a blank.  You must assure that you
  68.                 specify a word processor margin that will output at
  69.                 least a one character margin.
  70.  
  71.  
  72.  
  73.  
  74.                               NOTES FOR PROFS USERS
  75.  
  76.  
  77.          This code was written as a preprocesssor to PROFS.  Since it
  78.          generates native DCF commands, PROFS is not prerequisite.  The
  79.          output should be able to be processed by the native SCRIPT
  80.          processor under MVS or VM.  This does not output any GML tags.
  81.  
  82.          If you do use the output under PROFS, be aware of the following
  83.          points:
  84.  
  85.          o      This file does not contain any of the document format
  86.                 commands.  Therefore, you will want to upload the output
  87.                 as CMS flat file with an extension of SCRIPT.  Then
  88.                 create a new PROFS document, get out of input mode and
  89.                 issue the GET command to load in the SCRIPT document
  90.                 that was uploaded from the PC.
  91.  
  92.          o      Most PROFS document formats will put margins in the
  93.                 document.  Most PC word processors will also put a
  94.                 margin in the document.  To keep from getting a double
  95.                 margin, create the PC file with a one character margin.
  96.  
  97.  
  98.  
  99.  
  100.                              NOTES FOR MS WORD USERS
  101.  
  102.  
  103.          Microsoft Word is my word processor of choice.  This code has
  104.          been tested using only the output of Word.  Since I didn't
  105.          exploit any functions of Word when writing this program, it
  106.          should be independant of the word processor used.  The
  107.          following are notes and tips that I used when creating the
  108.          document using Word.
  109.  
  110.          o      I am a heavy user of style sheets under Word.  I
  111.                 exploited this in a way that might be helpful to other
  112.                 Word users.  I have a NORMAL.STY that contains all the
  113.                 styles using TmsRmn and Helvetica typefaces.  I cloned
  114.                 my NORMAL.STY into a PROFS.STY.  The PROFS.STY uses the
  115.                 same variants as NORMAL.STY, but the characters are
  116.                 formatted as Courier and the Division margins are set to
  117.                 eliminate the left margin.  I can therefore create a
  118.                 document using multiple fonts.  When I want to create
  119.                 the PROFS version of the document, I attach the PROFS
  120.                 style sheet.  This automatically takes care of all
  121.                 formatting.
  122.  
  123.          o      As noted in the section for PROFS users, you will need
  124.                 to take steps to assure that you don't get double
  125.                 margins.  To get a one character margin, format your
  126.                 margins for a 0.35" left margin in Word 5.0.  In Word
  127.                 5.0, the HP printer driver "knows" that there is a 0.25"
  128.                 physical area on which the printer won't print.  Word
  129.                 will subtract that quarter inch from the margin that you
  130.                 specify.  The other 0.1" inch is the width of a single
  131.                 12 point Courier character that is required to keep DCF
  132.                 from formatting the paragraph (see notes above).  In
  133.                 versions of Word prior to 5.0, I don't believe that Word
  134.                 compensated for that 0.25" dead zone on the page.
  135.  
  136.  
  137.  
  138.                                 CODE DISTRIBUTION
  139.  
  140.  
  141.          This code is public domain and can be distributed freely as
  142.          long as no free is charged for its distribution.  The code has
  143.          been designed as a recursive descent parser.  It can be used as
  144.          a general shell for translating HPPCL into anything else.  In
  145.          fact this code is a clone of a previous program that converted
  146.          PCL to variable blocked files with ANSI carriage control in
  147.          column 1. That program is available upon request from the
  148.          author, also free of charge.
  149.  
  150.  
  151.          I can be contacted as follows:
  152.  
  153.                 Gary Murphy
  154.                 1022 N. Cooper
  155.                 Olathe, KS 66061
  156.  
  157.  
  158.                 Prodigy      VWSD07A      (preferred)
  159.                 CompuServe   [73457,365]
  160.  
  161.  
  162.          Let me know if there are any enhancements you would like to
  163.          see.  I would also like to know if there are any enhancements
  164.          that you have made.
  165.