The SCRIPT/VS dictionaries do not contain all possible hyphen-ation points for all words. Each word placed in an addenda, user, or root word dictionary is divided into four three-character groups following the first vowel. Only one hyphenation point is recorded for each of the four groups.
Chapter 16. Automatic Hyphenation and Spelling Verification 177
CHAPTER 17. PRODUCING INPUT FOR STAIRS/VS
The Storage and Information Retrieval System/Virtual Storage (STAIRS/VS) is an IBM program product that provides content-based retrieval of documents using a comprehensive indexing structure.
Documents to be stored in the STAIRS/VS data base must be prepared in a Condensed Text Format (CTF). SCRIPT/VS can provide input for STAIRS/VS in this format, as shown in Figure 13 on page 180.
SPECIFYING STAIRS/VS OUTPUT
Use the DEVICE option of the SCRIPT command to specify STAIRS/VS output. (For details, refer to "DEVICE: Specify a Logical Output Device" on page 21.)
When you specify DEVICECSTAIRS) or CTF, SCRIPT/VS formats the input document as i t would for device 1403W6. The formatted lines are then converted to STAIRS/VS CTF blocks.
If you specify DEVICECSTAIRS) and PRINT, FILE, or TERM, the docu-ment is formatted as i t would be for CTF output, but instead is written to the specified destination for proofreading.
RESTRICTIONS IMPOSED ON FORMATTED OUTPUT
The STAIRS/VS program indexes only the text in the body of a docu-ment. Consequently, running titles, headings and footings, foot-notes, and floats are ignored when preparing STAIRS/VS output.
Multiple-column sections are treated as one single column. Under-scoring, overstriking, skip, and space are also ignored.
In addition, STAIRS/VS requires that its input not exceed 69 char-acters per line, or 449 lines per paragraph. In documents prepared for STAIRS/VS, lines exceeding these limitations will be flagged when output is being prepared in "proof" format, and will be trun-cated when output is being prepared in CTF records. The following error flags are placed in columns 72 through 80 of proof output:
C - more than 69 characters L - more than 449 lines P - paragraph id "stepdown"
The STAIRS/VS indexing scheme includes the sentence number within a paragraph. STAIRS/VS considers sentences to be delimi ted by
"full stops": a full stop character followed by two blanks. As described in "Chapter 3. Basic Text Processing" on page 33, SCRIPT/VS will automatically insert an extra blank between sen-tences when an input line ends in a full stop character, to satisfy this requirement.
STAIRS/VS PARAGRAPH NUMBERING
STAIRS/VS requires that a 3-character "number" be associated with each paragraph of a document placed in its data base.
STAIRS/VS paragraph numbers are composed of a single decimal dig-i t (0 through 9), followed by one or two alphamerdig-ic characters dig-in ascending order (blank, A through Z, and 0 through 9). SCRIPT/VS, by default, numbers the first paragraph of a document "0", and increments the paragraph number by one with each break when con-catenation is on, or by one with each input line when concatenation is off.
Thus, the first and subsequent paragraphs will be numbered:
Chapter 17. Producing Input for STAIRS/VS 179
. Offset
Dec. Hex. Length contents
0 0 12 SCRIPT/VS Document Name
12 C 3 Paragraph number of first line
15 F 1 Continued Block Count
16 10 2 Operator Number
18 12 2 CTF Record Length
20 14 5 Read Password
25 19 5 Delete Password
30 IE 45 (Reserved)
75 4B 69 First line of text 144 90 864 Twelve more lines:
144 90 3 Paragraph number of second line 147 93 69 Second line of text
216 D8 3 Paragraph number of third line 219 DB 69 Third line of text
. . . ... .. . . ..
936 3A8 3 Paragraph number of thirteenth line 939 3AB 69 Thirteenth line of text
Figure 13. STAIRS/VS Condensed Text Format (CTF) Records: Each record has a fixed length of 1008 bytes, and contains up to 13 lines of text.
OA
o
OAA OAB OAC OAD
OAE OAF OAZ OAO OAI
OA2 OA3 OA9 OB OBA
OBB OBC
You can reset the STAIRS/VS paragraph numbering counter at any time with the .SO [STAIRS/VS Output] control word. For example, specifying
.so pid 20b
will cause subsequent paragraphs to be numbered
20B 20Z 208
20C 200 209
20D 201 21
21A
20X 206 21B
20Y 207
When the STAIRS/VS paragraph numbering counter is reset to a value which is equal to or less than the last value used, a new logical document is created, regardless of whether a new document name has been specified with the .SO DOC control word.
When output is prepared in Condensed Text Format, the STAIRS/VS paragraph number is included as part of the CTF record with each line. When output is prepared in "proofn format, the STAIRS/VS paragraph number is printed to the left of the first line of each paragraph.
Information for the Document Name, Operator Number, and Read and Delete Password fields of the CTF block may also be provided with the .SO [STAIRS/VS Output] control word.
CHAPTER 18. pIAGNOSTIC AIDS
The diagnostic aids presented in this chapter are tools to help you find and correct problems caused by incorrectly specified or missing control words. Diagnostic aids in this chapter might also be useful to the Programming Service Representative (PSR). Howev-er, this chapter is directed toward the person who needs to find out why the sequence of specified GML tags and control words is not resulting in the desired output.
To use SCRIPT/VS effectively, you need to know the function of each GML tag and control word you use. Many formatting problems can result from tags and control words used incorrectly. Other chapters in this book provide detailed descriptions of each SCRIPT/VS control word. The IBM-supplied APFs that define the GML tags are documented with comments in the APFs themselves.
SCRIPT/VS diagnostic aids are provided as options of the SCRIPT command and as SCRIPT/VS control words.