SCRNS2WP: converts screen dumps to Word Processing documents

Description

Converts screen print files into Word Processing documents. Can merge several print files into a single document.

Categories

Documentation
Word Processing

Related files

SCRNS2WP: Object file for program.

COPYWP: Wang utility; used for conversion to WP format. (See comment below.)

CREATE: The CREATE utility is used to convert the print file to text source for COPYWP.

User Instructions

This utility creates one or more WP documents from screen image print files. The screen print files must be created from the Command Processor (HELP + PF(14)), the SCREEN subroutine, or equivalent. It is also recommended that all screen images be located in the same library, since SCRNS2WP cannot select files within a print library.

The INPUT screen prompts for the location of the print files to be converted; enter the library and volume name and press (RETURN). The OPTIONS screen allows document summary information to be entered and controls the document ID and volume; note that SCRNS2WP requires a unique document ID and the correct document volume location. SCRNS2WP can create one document for each print file or merge all print files and create a single document. When the conversion is complete, the program returns to the OPTIONS screen for additional action or exit.

The completed WP documents are stripped of the asterisks and user information that usually surround them, and centered on an 81-character format line.

Programmer Instructions

The major screens for the utility are GETPARM screens, so it can be controlled by a procedure. Note that the need for a unique document ID and the name of the document volume means that run-specific information will be needed every time the program is run, precluding generic approaches such as "next ID".

INPUT       Press (RETURN) to continue or PF(16) to exit
            program.

  LIBRARY   [spoolib]   The location of the screen image
  VOLUME    [spoolvol]  files to be processed.  Defaults to
                        the user's SPOOLIB and SPOOLVOL.

OPTIONS     Press (RETURN) to continue, PF(01) to create one
            document for each image file, PF(04) to merge
            image files and create a single document, or
            PF(16) to exit the program.

  DOCID     (blank)     The name and location of the document
  DOCVOL    (blank)     to be created.  Must be unique.
                        (Note that "next" is not valid for
                        this option.)

Example of use

Helpful for adding screen images to program documentation, such as those used in this book.

Comments

Bug-ridden, but occasionally useful. The primarily problem with SCRNS2WP is that is expects an earlier version of COPYWP. Many times this older version exists in the USERAIDS library under the names COPYWPOD or ARCHLINK (see example); if so, a copy of this older utility should be renamed COPYWP and placed in the same library as SCRNS2WP.