Document Composition Facility: Text Programmer's Quick Reference

--- -

= = =

~ : =i"'f~

®

Fifth Edition lMarch 19851

Document Composition Facility: Text Programmer's Quick Reference

SX26-3723-5

This edition contains information from and makes obsolete SX26-3723-4;

i t also contains information from the Document Composition Facility:

SCRIPT/VS Language Reference, SH35-0070-2.

Changes are made periodically to the information herein; before using this publication in connection with the operation of IBM systems, consult the latest IBM System/370 ~nd 4300 Processors Bibliography. GCZ0-0001, for editions that are applicable and current.

References in this publication to IBM products, programs, or services do not imply that IBM intends to make these available in all countries in which IBM operates. Any reference to an IBM program product in this publication is not intended to state or imply that only IBM's program product may be used. Any functionally equivalent program may be used instead.

Publications are not stocked at the address given below. Requests for IBM publications should be made to your IBM representative or to the IBM branch office serving your locality.

Comments may be addressed to IBM Corporation, Information Products Divi- sion, Box 1900, Department 580, Boulder, Colorado, U.S.A. 80301. IBM may use or distribute whatever information you supply in any way i t believes appropriate without incurring any obligation to you.

IBM Corporation

Information Products Division Department 580

Boulder, Colorado 80301

C

Copyri9ht Int•rnaitional Business Machines Corporation 1978, 1980, 1984; 1985

Option Pal"ameters (bind}

(obind ebindl

CHARS Cfon-tl

CONTINUE

CTF

DDUT

0

Description

Shi f t the page to the right.

SCRIPT/VS system symbol: &$BO,

&$BE

Specify up to four fonts. More i:han four external font-id's may be specified for page printer logical devices; however, for- mai:ting is !l.Q1 limited to the fonts so specified

SCRIPT/VS sys-tern symbol·

&$CHAR( )

Continue processing after a non-

Prepare output in STAIRS/VS Con- densed Text Format.

Allows the redefinition of a SCRIPT/VS utility file to a non- utility file.

DEST Csta-tion-idl Specify a remote output station.

~---+---+-C<V=alid only in TSO.) DEVICE (de11typel

[ ( fileid)]

FONTLIB ( [ f i l e t y p e ] [filemodel)

""

^{( libname (opnum}

C (DELAYJ [ID) [TRACE]) NOCONT

NOPROF NOSEGLIB NOS PIE

NOWAIT

NUMBER

Specify a logical output device Specify a disk file for output.

Ufot valid in ATMS-III. l Specify a font library

Enable the .PI [Put Indexl trol word.

SCRIPT/VS system symbol• 8$INDX Specify symbol and macro l i - braries. (Only one in TSO; up to eight in CMS and ATMS-III. l Control message printing.

Terminate processing after

Disallows the redefinition of a SCRIPT/VS utility file to a non- utility file.

Suppress the profile.

Suppress the se9ment library.

Prevent enterin9 SPIE exit rou- tines. (Valid only in CMS and TSO.)

Prevent prompting for paper ad- justment. (Valid only for type- writer terminals in CMS and TSO.)

Print file name and line number.

Ignored for page printers.

OPTIONS CCfileid)l Specify a file that contains SCRIPT options. (Valid only in CMS and ArMS-111. l

[([PROMPT] Print pages selectively.

[[fRQM]p [TO] q] CPROMPT is valid only in CMS and [[FROM] p FOR nl TSO.)

[CFROMJ p ONLYlll

[(copies,class. Produce Printer output. In CMS fcb,ucsll will take advantage of virtual 3800 support in the VMISP System Product CSuboptions are valid '---L---~o_ol-'--y in TSO.l

PROFILE [(fileidll Specify a profile. CA file to be imbedded before the prim<>ry input file is processed.) QUIET

SPELLCHK

SYON.

TERM

TLIB

TWOPASS

UN FORMAT

UP CASE

auser- option

(libname) (opnum

(n value

(libname .

[(sub- options .. ) l

Summary of SCRIPT Options

Suppress formatter identifier

Specify a library in TSO. Spec- ify the default filetype for im- bed and append files in CMS.

Spcci fy operator number ATMS-Ill.

Specify a page segment library.

Enable the .SV [Spelling Verifi- cation) cunt.·ol word.

Print separate pages at the ter- minal. (Valid only for type- writer terminals in CMS and TSO.)

Disables the .SY [System Com- mand] control word. SYOFF is the default. Applicable only in the TSO and CMS environments only.

Enables the .SY (System Command]

control word after SYOFF is specified. Applicable only in the TSO and CMS environments.

Set symbol values for &SYSVARn.

Display the output at a user's terminal.

Specify spelling checking and hyphenation libraries. (Valid only in CMS.)

Prepare with two formatting passes, and produce output on the second pass.

SCRIPT/VS system symbol: &~THO Print all input lines without formatting. Ignored for page printers.

SCRIPTIVS system symbol• &$UNF Fold lowercase letters to upper- case before printing.

User-defined options, which Must begin with the character "Ol"

(Valid only in CMS.)

C. Pl l

0

---~Page Width C.PWJ - - - - : - - - - L i n e length C.LL) - - - -

Top Margin C. TMJ

r---

11 Running Heading C .RH)

I

1~---~

I

I

Top Page Float (.FL) 1 ••

I <-Indent->::·

C. INJ

1:

... <-Indent Right->

C. IRJ

1: ... .

M:~~in 1<-· -· ·_·_· ·_·_· -· ·c~i~~~ ·ci~~ ·i:~~;th · ( :cL>-·----

' .PM)

I . . .

< Column line length >

1.

1:· ... .

1:

1:

Bottom Column Float C .FU

1/~---F-o-ot_n_o_te_s_(_.F_N_l _ _ _ _ _ ,

Running Footing C .RFJ

:1 r - - - -

~---~

sottom Margin C. BMJ

SCRIPT/VS Terms for Parts of the Page.

Logical Device Type TERM 2741 3270 14(13N6 1403N8 1403N6

Real Device Type

")

2741 3270

1403W8 1403 1403W6S 1403W8S 1403SW C 2) STAIRS 3800N6 3800N8 3800N12 3800~16 3800W8 3800Wl2 3BOON6S 3800N8S 3800Nl2S 3BOOW6S 3800~185 3BOOW125

3800

Lines

.. ^,

Page Size Margins Inch Width Length Bind Top Bottom

6 8 12 6 8 12 6 8 12 6 8 12

8. Si 11 i 8. Si 8. Si 13.Si 13. Si 13. Si 13. Si 8. Si 13. Si 8. Si 8 .Si 8. Si 13. Si 13. Si 13. Si 11 i 11 i 11 i 13.Si 13. Si 13 .Si

11 11 11 i 11 i 8. Si 8 .Si 11 11 10 10 10 • 10 10 10 7.Si 7. Si 7.Si 7. Si 7. Si 7. Si

. Si . Si

l i . Si . Si

l i

l i 125i

3BPPN 38PPH 38PPNS

38PPWS 3800-3 (3) 8 .Si 13. Si 11 • 13.Si

10 i 10 i 7. Si 7. Si 3BPPW90

38PPNS90 38PPW27 0 3820A 3820A90 3820Al80 3820A270 3820L 3820A4 38201l4 3820B5 4250A 42SOB 42SOL 4250A3 4250A4

3820

"'

4250

,.,

10 i 13.Si .Si .Si .Si 7. Si 11 i

10 i 13. Si 8. Si 11 i 8.Si 11 i 8. Si 11 i

8.Si 11 i l i .Si .Si 8. Si 14 i

210mm 297mm 257mm 364mm 182mm 2S7mm 8. Si l l i 11 i 17i

8.Si 14i l i .Si .Si 297mm 420mm

210mm 297mm

Line Length

,, ,,

6i

6i

6i

6i

6i Class Device of

line devices

page printers

1 The physical device type corresponding to the TERM logical device can be either 2741 or 3270, depending upon the actual terminal type.

Z This is a 12-pitch device; all other 1403 devices are 10-pitch.

3 The linespacing for page printers is determined by the .LS [Line Spac- ing] control word and the fonts used in the document.

SCRIPT/VS logical Devices

&SYSYEAR

&SYSMONTH

&SYSDAYOFM

&SYSOAYOFW

&SYSDAYOFY

&SYSHDUR

&SYSMINUTE

&SYSSECOND

&$LDEV

&$OUT

&$PDEV

&$BE

&$BO

&$CHARC n)

&$DCF

&$INDX

&$LIB

&$PARM

&$PASS

&$PRT

&$SYS

&$TWO

&$UNF

Date and Time i Year of the century Month of the year Day of the month Day of the week Day of the year Hour of the day Minute of the hour Second of the minute

00 - 99 01 - 12 01 - 31

1 - 7 C"l" is Sunday) 001 - 366 00 - 23 00 59 00 - 59 Output Device Characteristics Logical output device 2 Output destination Physical output device

SCRIPT command Options Even bind 3 4

Odd bind 3 4 Fonts 5

SCRIPT/VS Release level Indexing 6

Macro library available ' Command optio'ns 1 Current pass number Current page print switch Environment

TWOPASS option in effect ' Unformatted output '

Page Characteristics

1-8 characters TERM, PRINT, FILE 1403, 2741, 3270, 38PP, 3800, 3820, 4250

0 -nnn 0 -nnn l - 4 characters 3. 0

0, l O, l

8 - 256 characters l , 2

ON, OFF CMS, TSO, VS2, VSE, CICS

0, l 0, l

>--~~~~~~~~~~~~~~~~~~~~--~----~

&$BE

&$BM

&$BO

&$CL

&$FM

&$IN

&$IR

&$LC

&$LL

&$OF

&$PL

&$PW

&$TM

Bind Even CBINDJ Bottom margin (.BM) 8 Bind Odd CBIND) Column line length (.CL) Footing margin (. FMJ 8 Left indention (.IN) 'I Right indention (.IR) 9 Internal line counter 8 JO Line length (.LLJ ⁹ Offset (.QF) 9 Page length C.PL) 8 Page width (.PH) 9 Top margili (. TMJ 8

0 0 nnn 0 nnn 1 nnn 0 - nnn 0 - nnn 0 - nnn 0 - nnn 0 - nnn 0 - nnn 1 - nnn l - nnn 0 - nnn SCRIPT/VS Formatter Parameters

&$BS

&$CONT

&$CN

&$C256

&$EGML

&$ENV

Backspace Character Continuation character 11 Control word separ<itor l l Identity vector GML end-tag delimiter l l Formatting environment

hexadecimal 16 one character (default: ";") 256 characters (default:

"= :")

BODY, FL, FN, KP, RF, RH, IBP,AR,FNL

&$FNAM

&$GML

&$KP

&$LNUM

&$LST

&$PN

&$PS

&$RB

&$RET

&$SU

&$TAB

&$TAGD

&$VR

Current input file name GML tag delimiter l l KPAP in process Last line number read Line Started Page number 12 Page number symbol l l Required Blank 11 Return code from . SY 13 Symbol substitution enabled Tab Character

GML delimiter of last tag Vertical rules in effect

eight characters (default: ":") ON, OFF 0 - nnn 0,1 1 - nnn (default: "&") (default: hexadecimal

4ll 0 - nnn ON, OFF hexadecimal 05

&$GML, &EGML ON, OFF These symbols may contain leading zeros. They can be elimi- nated with a .SE [Set Symbol] control word' ".se SYSHOUR =

&SYSHOUR + O".

Set by the DEVICE option of the SCRIPT command.

Set by the BIND option of the SCRIPT command and the .PM [Page Margins] contr-ol word.

The system symbol values are represented in character spaces, regardless of the space uni ts used in setting them.

The maximum value depends upon the logical output device.

Set by the CHARS option of the SCRIPT command. This is a symbol array; element 0 contains the number of fonts speci- fied and elements 1, 2, . . . contain the names of the fonts specified.

"l" indicates the command option was specified; "0" indi- cates i t was not specified.

This is the SCRIPT command options list. In CMS, the com- mand options list is tokenized (divided into eight character fields separated by blanks and parentheses) and truncated at 32 tokens C256 characters).

These values are represented in line spaces, regardle5s of the space units used in setting them. The maximum value de- pends upon the logical output device.

The values of these symbols are represented in character spaces, regardless of the space units used in setting them.

The maximum value depends upon the logical output device.

The value of the symbol &$LC is the number of lines remain- ing in the current column, excluding unplaced keeps, floats, footnotes, widow zones and partial lines.

Set by the .DC [Define Character] control word.

&$PN contains the numeric portion of the current page num- ber. The page number as substituted can be obtained with the control word ".sex= &11 •

In CMS, any possible return code value. In TSO, "0" to indi- cate the command was stacked for execution after SCRIPT/VS terminates. In ATMS-III, "0" to indicate the control word was ignored. In batch, "-3" to indicate that .SY is not supported.

SCRIPT/VS System Symbol Names

®

0

l

2 3 4 5 6 7 8 9 A B c D

E

F 00

l

0 20 30

40 i • < ( +

50 &

I

s .

⁾

60 - I . _"

⁾

^?

70 •

^it

^{I = •}

BO

a ^b c ^d e f 9 h i

(

s + +

90 j k 1 •

D 0

P q r J ^a >

:t

.

AO

⁰

s t u y

• J:

y z

r

[ 2: .

BO

^{0 I ., :J • 5 • 7 • 9 ~}

, ]

#

co

l B

c

^D

E F G

H

I

DO

J ^I(

L

II II

0

p Q

R

EO s T u ^y v

I

y z

FO 0 2 3 II 5 6 1 8 9

4 5 7 B A B C D E F 1403 Translate Table

0 1 2 3 4 5 6 7 B 9 A B C D E F 00

l 0 20 30 40 50 60 70

BO

90 AO BO co

DO EO FO

&

-

^/

a

j

•

^l

A

J

' 0 1 b c

d

k 1 m s t u z

3 4 B

c

D K L M

5 T u

2 3 4

e

f g

h ; n o

p q

r v w x

y z

5 6 7

a •

E F G H I N

0

^p Q R

v w x ^y z

5 6 7 8 9

¢

<

⁽

+ I

! $ . .. ^Y.

⁾

^{> ;}

^~

^?

:

II

_{c s}

@

• ⁼ _t ^"

) _~

± .

r

^[

² •

J

, ^J

"' -

.L

T

§

I H

0 1 2 3 4 5 6 7 8

9

A B C

D

E F

3800 Translate Table

OF

l

F 2F 3F 4F SF 6F 7F BF 9F AF BF CF OF EF FF'

OF

l F

2F 3F 4F SF 6F 7F BF 9F AF BF CF OF EF

FF

Text Fonts Highlight Fonts Special Fonts

GTlO Gothic ClO-pitch) GT12 Gothic Cl2-pitch) GT15 Gothic CIS-pitch)

GBlO Gothic Bold GRlO Gothic Reverse GB12 Gothic Bold GP12 Proportional Gll2 Gothic Italic

STlO Serif ClO-pitch) STl 2 Serif Cl 2-pi tch) STl 5 Serif ( 15-pi tch)

SilO Serif Italic RTIO Ro111an Text SilZ Serif Italic S012 Serif Over-struck SB12 Serif Bold

Complete 3800 Printing Subsystem Model 1 and Model 3 operating in compatibility mode CMVS only) Fonts Provided with SCRIPT/VS

Parameter Baseline Capitalization Co1umn balancing Continuation character Control word separator Current font Column definition Centering (2 )

Column line length Conditional sections Font save stack Linespacing Formatting mode GML tag delimiters Horizontal space Indention Page number symbol Revision code, adjust Right adjustment Right indention Spelling verification Tab setting Terminal input (2) Underscoring

Parameter Bottom margin Hyphenation Page length Page margins Page numbering made Page width Symbol substitution Top margin

'"

©

Act:ive Environment Control Word .SB .UC, . UP .BC

• DC CONT .DC CW .BF, .DF, .PF .co .CE .Cl

.cs

• BF, .PF . LS .fO, .NF, .FV .DC GML

Initial Setting 0

OFF ON (null)

;i;

Single column OFF Line length INCLUDE empty

'"

. FO ON EXTEND

"' ..

. ES, . IC,

,,,

^.HS

_a

^{( 1 J}

• DC PS .RC .RI .IR . sv . TP . TE .UC, .US .UD

"&"

OFF, 2 OFF

a

ON 5 10 15 OFF OFF ON

Page Environment Control Word Initial . BM

'"

.HY OFF

• Pl

'"

• PM

'"

.PN Arabic

.PW

'"

• SU ON

• TM

'"

Translate Tables

80

Setting Symbol

&$CONT

&$CH

&$Cl

&$GML,

&$EGML

&$IN

&$PS

&$IR

Symbol

&$BM

&$PL

&$BO,

&$BE

&$PW

&$SU

&HM

Parameter

I

Control Word

I

Initial Setting} Symbol

Input translation

I

^TI

I

^Identity

I

Output translation : TR Identity Uppercase translation . TU a-z -> A-Z

These parameters' initial settings are based an the logical output device.

The number of lines remaining, or ON or OFF, is saved.

Th<?! composite current indention is determined from the .IN, .IL, .UN, and .Of control ward values. These values are in- dividually saved.

The SCRIPT/VS Formatting Environment

Attribute Function

&a' Converts a numeric character stringl to a "base-26" low- ercase alphabetic "number."

&A' Converts a numeric character stringl to a "base-26" up- percase alphabetic "number."

&AD' Returns the depth of the material now in the specified named area.

&DH' Converts a space designation 1 to an equivalent number of hori zonta 1 device uni ts.

&DV' Converts a space designation1 to an equivalent number of vertical device units.

&E' Verifies the existence of a symbol; the value is 1 if the symbol has been set; 0 i f not.

&l.' Yields the length of a character stringl.

&r ¹ Converts a numeric character string I into a lowercase roman numeral.

&R' Converts a numeric character stringl into an uppercase roman numeral.

&SW' Returns the width of a named segment.

&SD' Returns the depth of a named segment.

&T' Yields the type of the current value of a symbol. The type is either "N" for numeric or "C" for character.

&U' Converts a lowercase character string to uppercase.

&V' Yields the current value of a symbol.

&W1 Yields the measured length of a character string1 in figure spaces of the current font. If you want the length of a character string in device units, use &DV' or &DH' in combination with &H'.

•x•

Converts a hexadecimal notation into

stringl. character

The character string or space designation may be the value of a symbol.

Attributes of a Symbol 1s Value

®

~ ~ ~

®

SX26-3723-5

"ti

:a z

-I m 0

z c

en ?-

Ctl

Wei Parameters label [input line]

.AA tag [apf [(r-ules)]]

[apf [(rules)]]

• AN x test y input-line

"test" can be•

1 t le eq na gt ge

< <=

=

-= > >=

.AP foamelCfile-id)}

[token! tokenl41

.AR

rruu

.BC [Qlil OFFl rTOPJ [REPLACEJ CDELETEJ [QFFJ [PUT]

®

Description

Set Label: Inserts a line that can be used as the target of a .GO control word.

Associate APF: Maps a GML tag to the macro or control word that processes it, and gives the attribute scanning rules for the tag .

And: Tests the relationship between

"x" and "Y". When the test is satis- fied !ll.!1.s;! the most recently processed .IF, .AN, or .OR was also satisfied, SCRIPT.IVS processes the input-line.

Append: Allows an additional file hi be appended to the file just proc- essed.

Area Begin: Specifies a group of lines to be kept in a ~ area for subsequent placement on a page.

Balance Columns: Causes SCRIPT/VS to attempt to balance the columns by distributing text when a page eject occurs or when the column definition is changed.

.BF (fontname]

[ =

l Begin Font: Causes SCRIPT /VS to use a new font. More than one font may be given; the first valid font listed will be used.

.BL

• BM Cvl.Jvj-vJ

.BR

.BX fNEHISETlOFFJ [rulenamel [rulename LEFTlhlRIGHTl/I J (CAN]

{CHAR enamel .CB

.cc

^[vl

.CD

'"

^{[hl h9]]}

.CE CllnlONIOFFI input-line]

.CL [.Q.fhl.Jhj-h]

• CH .CP [v]

.CS n [INCLUDEllGNOREl n CONJOFFJ

Default' Restarts the current font.

Blank Line: Results in one line of vertical space; is genei;.ated by SCRIPT/VS and executed Whenever a blank line is processed . Bottom Margin: Specifies the amount

of space in the bottom margin area.

Causes a break.

lni tial Setting• Logical device de- pendent.

Default: Restores the initial set- ting.

SCRIPT/VS system symbol: &$BM Break: Prevents the concatenation of

the following text line with preced- ing text.

Box: Draws horizontal and vertical lines around subsequent output text.

Column Begin: Causes an eject to the next column (or next page).

Conditional Column Begin: Causes a column eject if less than a speci- fied amount of space remains in the column.

Default: .CC causes a column eject unless there is no data in the cur- rent column.

Column Definition: Specifies the num- ber of columns on the page and the position of each column.

Initial Setting: One column at posi- tion 0.

Center: Centers text lines between the current left and right margins.

Column Line Length: Sped fies the width of each column (all columns are the same width).

SCRIPT/VS system symbol: 8$CL Comment: Identifies a comment line . Conditional Page Eject: Causes a page

eject if less than a specified amount of space remains on the page.

Default: .CP causes a page eject un- less there is no data on the current Conditional Section: Allows condi- tional inclusion of input in the for- matted output.

Initial Setting• All conditional sections included.

SCRIPT/VS Control Hord Summary CPart 1 of 7)

Ctl Wd Parameters .CT [input-line]

• DA areaname h [v]

~~~g~~

[SECTION]

[FONT fontname) iWIDTH hl [DEPTH vl {ROTATE rotation]

.DC (parameter char . I OFFl

.DD name

[l.!AI DDJ DSN file-idl

.DF fontname [USIUPJUCISTOPI

OS RPT n]OS CHAR cJ BOX cname [ FONT C font-idl I TYPE [Cl

description [) l I CODEPAGE cp-id .DH n [options]

.DL name [name]

• DM name

[/linev· ./linen[/]

xlLIBIOFFl name [/line[/) Cxl OFFJ [name ON]

[OFF]

.DR rulename CWEIGHT hl [FONT fontname]

.DS

.DU CADD I DEL} word

.DV [symnamel [font fontname]

[Baseline bl [/string[/ l fsymnamel

[Text]

[/string[/]

.EC input line

.EF [CLOSE]

• EL [input-line]

.EM input line

• EQ

Description

Continued Text: Appends the input- line to the previous input text without an intervening word space.·

Define Area: Defines a named area .

Define Character: Defines the charac- ters for special functions.

Parameters:

ASEP' Array element separator charac- ters

CONT: Line continuation character (&$CONT)

CW: Control word separator C&$CW) GML: GML tag delimiter C&$GML.

&$EGML)

lXB: Index term blanks IXI: Index term nulls STOP: End-of-sentence characters PUNC: Punctuation characters PS: Page number symbol C&$PS) RB: Required blank (&$RB) WORD: Word delimiter characters MCS: Markup content separator char-

acter Initial Settings'

ASEP: , 40 GML: PS1 &

CONT: none STOP 1 ! ? RB: 41

CW: ; PUNC• IXB1

IXI: none MCS:

Define Data File-id: Specifies the file-id of a file to be used with the .IM [lmbed], .AP [Append) or .HF fWri te To File] control words, or with utility files.

Define Fent: Defines internal fonts composed of external font character- istics and line formatting func- tions.

Define Head Level: Defines the format and characteristics of the section headings produced by the .Hn control words.

Default• Restores initial settings.

Dictionary List: Names spelling checking and hyphenation diction- aries .

Define Macro: Defines a macro using text, SCRIPT/VS control words, and special symbols. Macros may be de- fined inline without prefixing each line of the macro with a . DM [Define Macro] control word.

Define Rule: Defines ~ rules of varying thickness.

Doublespace Mode: Causes subsequent output lines to be doublespaced.

Dictionary Update: Adds words to or deletes words from an addenda dic- tionary, which is used to supplement a SCRIPT/VS main dictionary for spelling verification and hyphen- ation.

Define Variable: Defines and assigns value to text variables.

Execute Control: Executes the input line as a control word even if there is a macro of the same name.

End Of File: Simulates an end of file condition.

Else: Processes the input-line if the most recently executed .IF, .AN, or . OR control word was not satisfied.

Execute Macro: Executes the input line as a macro even if macro sub-.

sti tution is off.

Equation: A reserved control word . SCRIPT/VS Control Word Summary (Part 2 of 7)

Ctl Wd .ES

.FL

.FN

.FO

.FV

.GO

.GS

.HR

.HW

.HY

.Hn

.IC

.IE

• IF

.IL

.IM .IN

.IR

Pa.-ameters (NORMAL [h] l

{BY [ f l ]

[Q!! I OFF I DUMP l fTOP I BOTTOMJ

~J5g~1~e~~~

[ORDER]

CON I OFF I l EADER}

[fil!I OFFI LEFT I RIGHT I CENTER INSIDE I OUTSIDE]

[EXTEND !TRUNC I FOL DJ

~~~~iERJ

[BOTTOMJ [JUSTIFY]

[TOJ label

[parameters]

[rulenamel [LEFT] ITOl rRIGHTJ [hl l [TO] h2l [hl FOR length]

text-word

parameters

[text-line}

CESPACE [ hll [-hl]

{Hlll2)3} string

x test y finput-linel

"test" can be•

l t le eq ne gt ge

< <=

=

~= > >=

[Qlhl+hl-hl

{name! (file-id)}

[token! token14J [Q!hf+hl-hJ [FOR vll [AFTER v2l [NOBREAKJ

[Qfhl+hl-hJ [FOR vll [AFTER v2l [NOBREAKJ

.IS [ h l [-h ] TO h [MINIMUM h2J

~~~~~

ABSOLUTE

Description

Extra Space: Controls the formatting of multiple blanks by speci tying the width of the extra spaces.

Float: Delimits a group of lines to be kept together and placed at the top or bottom of a column or page.

Footnote: Saves formatted text and prints i t at the bottom of the page in single-column format.

Format Mode: Controls concatenation and justification of input lines.

Initial Setting: ON EXTEND Format Vertically: Specifies whether

text is to be vertically justified.

Also may be used to specify if text is to be at the top, bottom, or cen- ter of the columns if i t is not jus- tified.

Initial Setting: TOP

Go To: Causes SCRIPT/VS to locate the input line identified with "label"

and resume processing with that in- put line.

GML Services: Provides a variety of functions helpful in writing APFs, including attribute scanning and symbol manipulation.

Horizontal Rule: Places a horizontal rule in the current column.

Hyphenate Word: Specifies hyphenation points for a word that might need to be hyphenated during formatting.

Hyphenate: Controls the SCRIPT/VS au- tomatic hyphenation function and ex- pansion and compression ranges.

Initial Settings' OFF LADDER = 2 MAXPT = 2 MINPT = 4 MINWORD = 6 RANGE = l. 0 Default' lni ti al setting.

Head Level n: Formats a section head- ing according to default character- istics supplied for the heading.

Intercharacter Space: Controls the insertion of extra space between characters. Ignored for line de- vices.

Initial Setting: 0

Default• Restores initial setting.

Index Entry: Formats an index entry when generated by the .IX [Index]

control word.

If: Tests the relationship between

"x" and "y". Hhen the test is sat- isfied, SCRIPT/VS processes the input-line. Otherwise, SCRIPT/VS ignores the input-line.

"x test y" can also be:

SYS PAGE eq I ne EVEN I ODD SYSOUT eq J ne PRINT J TERM I PAGE Indent Line: Indents the next output

line the specified amount of hori- zontal space.

Initial Setting: 0

Imbed: Processes the named file at this point.

Indent: Specifies the amount of space subsequent output lines are to be indented from the current left mar- gin.

May cause a break.

SCRIPT/VS system symbol: &$IN Initial Setting' 0

Indent Right: Specifies the amount of space subsequent output lines are to be indented from the current right margin.

May cause a break.

SCRIPT/VS system symbol: &$IR Initial Setting: 0

Inline Space: Inserts a specified amount of horizontal white space into the current line.

SCRIPT/VS Control Hord Summary (Part 3 of 7)

Ctl

Wd Parameters .IT C.Q.HIOFFIALLI

en

I GML I MAC t SUB I SNAPISTEPIRUNJ Response to STEP•

(null) PRE input-line REP input-line STK input-line .IX [llnl

[name I control I/]

.KP <ONIFLOATIDELAYI INLINE[vlv + vlOFF}

.LB

.LI CllnlONIOFFI input-line]

.LL Chl+hl-hl

.LO [ v l

• LS [parameters]

• LT

.LY CQ!:!IOFFISYMIMACl

.HC

.ME [input-line)

.MG / [ codel/message/ [/ J

.MS CQ!:!I OFFJ

.NF (Qt:! (EXTEND) [OFF [FOLD l [LEFT [lRUNC l [CENTER [RIGHT [INSIDE l [OUTS I DE l .NL

.oc {line! 'string'}

.OF 1..!!.lhl+hl-hl

.OR x test y (input-line]

"test" can be'

~ t ~~ ~q ~~ ~t ~~

@

Description

Input Substitution Trace: Provides a trace of processing for each SCRIPT/VS control word and macro, as well as symbol substitution, Hhen

• IT STEP is in effect, the user re- sponds interactively.

Initial Setting 1 OFF.

Index; Generates an index from terms previe>usly specified with the .PI control word,

Keep: Ensures that a group of output lines are kept together in the same column.

SCRIPT/VS system symbol' &$KP Leading Blank: Causes a break, Literal: Ensures that input lines are

treated as text lines by SCRIPT/VS (used when a text input line begins with a period),

Initial Setting: OFF,

Line Length: Specifies the length of lines in running headings and run- ning footings,

SCRIPT/VS syste111 sy111bol 1 &$LL Initial Setting• logical device de-

pendent.

Default: Restores initial setting.

Lead-Out: Identifies a place in a column where a specified amount of extra vertical white space may be placed during vertical justifica- tion.

Line Spacing: Controls the depth of lines of text. Also controls allow- able ranges of compression and ex- pansion for vertical justification.

Initial Settings'

NORMAL - font dependent BY - 1. 0 RANGE - 1.0

Default' Restores initial setting.

Leading Tab: Causes a break . Library: Specifies whether a library

is to be used to resolve symbol and macro definitions.

Use the LIB option to identify the libraries.

Initial setting: OFF.

Multicolumn Hode:Restores column de- finition saved by a previous .SC {Single Colu111n Mode] control word.

Macro Exit: Ends a macro and returns control to the macro'scaller. The input-line is processed as though i t were part of the 111acro's caller.

Message: Produces a message similar in format to the SCRIPT/VS error Macro Substitution: Causes SCRIPT/VS

to recognize and process macros.

Initial Setting r OFF Default: ON

No Formatting: Cancels or restores concatenation of input lines and justification of output lines.

Initial Setting: OFF EXTEND Default' ON

Null Line: Causes a break, Output Comment: Specifies data that

is to be inserted into the output document as i t is, as an output com- ment. Ignored for page printers.

Offset: Causes a hanging indention Ca paragraph in which the indention of the first line is unchanged and sub- sequent lines are indented to the offset value.)

SCRIPT /VS system sy111bol: &$OF Initial Setting1 O

or: Tests the relationship between

"x" and "y". When the test is satis- fied .Q.!: the most recently executed .IF, .AN, or .OR was also satisfied, SCRIPT/VS processes the input-line.

SCRIPT/VS Control Hord Summary (Part 4 of 7)

Ctl

Wd Par-ameters .PA [nl+nl-nJ

.PF

.PI

.PL

.PH

.PN

.PT

.PW [NOST ARTJ CODDI EVEN]

lONIOFFl

[START l END I ORDER I RE Fl [KEY /kl/k2/k3/]

/ t l [/t2(/t3[/pn]] l lvl+vl-vl

[ hl [ h2l [NOBINDl [+hl [+h2l [-hl [-h2l

{n]ON10FFIOFFNOI ARABIC I ROMAN I ALPHA I NORM I FRAC I PREF string}

input- line

[ h [ •h [ -h

Description

Page Eject: Causes a page eject, and can set the page number of the new page. Default: Ejects to next se- quential page.

Previous Font: Causes the last stacked font to become the current font.

Put Index: Puts a multi-level term in the index.

Page Length: Specifies the amount of space, including top and bottom mar- gins, for each output page.

Initial Setting: Logical device de- pendent.

Default• Initial Setting.

SCRIPT/VS system symbol: &$PL Page Margins: Overrides page binding

set with BIND option of the SCRIPT command unless NOBIND parameter was specified.

Initial Setting: Logical device and binding dependent.

Default: Initial Setting SCRIPT/VS system symbols: &$BO, &$BE Page Numbering Mode: Controls ex-

ternal and internal page numbering.

Initial Setting: Arabic numerals from 1.

SCRIPT/VS system symbol: &$PN Put Table of Contents: Places the in-

put line (which may be a control word, macro, GML tag, symbol, or line of text) into the file used to accumulate table of contents entries CDSMUTTOC).

Page Width: Specifies the width of the logical page, including the page margin (binding).

Initial Setting• Logical device de- pendent.

Default: I ni t i al setting.

SCRIPT/VS system symbol: &$PW

• PX c [Qffl Prefix: Specifies that lines read NULL [/string[/]) from input files that begin with specific control characters be pre- fixed with given character strings.

.QQ

.QU

.RC n {ONIOFFIONIOFFld

• c ADJUST Zlh .RD

.RE [envnamel

.RF C!!.tllOFFICANCELl (ODDlEVENJ [CANCEL I SUP I RES]

[EXECUTE]

.RH [Q!:!IOFFICANCELl [ODDI EVEN]

[CANCEL I SUP I RES l [EXECUTE) .RI [llnlONIOFFI

input-line]

.RN Cfil!IOFFJ

Quick Quit: Causes SCRIPT/VS process- ing to terminate immediately without completing the current page.

Quit: Causes SCRIPT/VS processing to terminate after completing the cur- rent page.

Revision Code: Specifies a revision code symbol that is to be printed to the left of the output line that contains updated material.

Read Terminal: Allows user to type in one or more text lines while a file is being formatted.

Restore Environment: Restores envi- ronments that have been previously saved with the .SA [Save Environ- ment] control word. Environments may be restored by MM·

Running Footing: Specifies input lines that are to be saved as a run- ning footing and processed at the bottom of each appropriate page.

Running Heading: Specifies input lines that are to be saved as a run- ning heading and processed at the top of each appropriate page.

Right Adjust: Produces output lines that are unconcatenated input lines aligned with the right-hand margin.

Reference Numbers: Numbers output lines serially in body of page. Ig- nored for page printers.

Initial Setting: OFF.

SCRIPT/VS Control Word Summary CPart 5 of 7l

Ctl Wd Parameter's .RV symname [[;:;]•]

.SA [envnameJ

.SB [ Q [ v [ +v [ -v

.sc

.SE

.SI

.SK

.so

.SP

.ss

symname[(nJJ 'qstring[']

symname[ C n J J = [symvaluel [&]

[SUBSTR str start length [INDEX strl [str2]

symname[(nll OFF symname LIB segname [WIDTH hJ [DEPTH vl [ INL INEJ [!lvl [Al [CJ [pJ

[DOC name]

[PID naal [ OPR number]

[RPN password]

[ DPW password]

Cllvl CAJ [CJ CPl

.SU [!ln[ONJOFFI line]

.SV [fil:!JOFFJ [NOADDI [NOST EM I rNUMl .SX [Fl Cl

/ lpart/fi l l/rpart/

• TC f!lnl [name I control I/]

.TE [llnlONJOFFJ

Descr-iption

Read Variable: Allows user to assign a value to a symbol name by entering it at the terminal in response to an interactive request made while SCRIPT/VS is processing the input file.

Save Status: Saves the current values and parameters of the formatting en- vironment. Environments may be saved by name.

Shift Baseline: Specifies that subse- quent text is to be placed above or below the normal baseline. Ignored for line devices.

Initial Setting' 0

Default' Return current baseline to normal baseline.

Single-Column Mode: Causes SCRIPT/VS to save the current column defi- nition and format subsequent input lines in a single column.

Set Symbol: Defines a symbol name and assigns a value to i t .

Segment Include: I denti fies a segment to be included in the document at the current column position. Ignored for line devices.

Skip: Specifies the amount of space to insert before the next text out- put line. No lines are inserted i f the .SK occurs at the top of a page or column.

STAIRS Output: Specifies information for STAIRS/VS CTF output.

Space: Specifies the amount of space to insert before the next text out- put line. The specified number of lines are inserted even when the .SP occurs at the top of a page or col- Single-Space Mode: Causes subsequent output lines to be single-spaced.

Substitute Symbol: Controls the sub- stitution of symbols with their pre- viously assigned values.

SCRIPT/VS system symbol• &$SU Initial Setting• ON

Spelling Verification: Defines the start and functions of the SCRIPT/VS spelling verification function.

Enabled with the SPELLCHK option.

Initial Setting: ON.

Split Text: Produces an output line of three parts' "left" is aligned with the current left margin;

"right" is aligned with the current right margin; "filln is centered or repeated between the two strings . Table of Contents: lmbeds the table

of contents file CDSMUTTOCJ, which consists of table of contents en- tries automatically generated by the .Hn control words, and entries in- serted with the . PT [Put Table of Contents] control word.

Use the THOPASS option if the table of contents is not at the back of the document.

Terminal Input: Allows user to enter lines interactively from the termi- nal when the file is formatted.

SCRIPT/VS Control Word Summary (Part 6 of 7)

C'tl lld .• TH

• Tl

• TM

• TP

• TR

.TS

• TU

• TV

Parameters [input-line]

[s t .. , J

[vl+vl-vl

[s t ... J

s [/string/ I OFF I IGNORE]

[s t ... J

input-line

Description

Then: Processes the input-line if the most r-ecently executed .IF, .AN, or .OR control word was satisfied.

Translate Input: Specifies character translations to be performed on in- put lines before SCRIPT/VS process- ing begins.

Initial Setting• No translate is in effect.

Default. Restores the initial set- ting.

Top Margin: Specifies the amount of space in the top margin area.

SCRIPT/VS system symbol• &$TM Initial Settings Logical device de-

pendent.

Default1 Restores the initial set- ting.

Tab Position: Specifies tab settings and allows text to be left-, cen- ter-, right-, or character-aligned at each tab position.

Default: Clears the tab table.

Translate Character: Specifies char- acter translations to be performed on output.

Default: Restores the initial output translate table.

Translate String: Translates a single character into a string . Translate Uppercase: Specifies char-

acter translations to be performed for capitalization.

Initial Setting: No translate is in effect.

Default: Restores the initial set- ting.

Type On Ter-minal: Types the input line on the user's terminal during formatting .

• UC [11 n JON I OFF I input- Underscore and Capitalize: ill!DER- linel SCORES AND CAPITALIZES one or more

subsequent input lines.

Initial Setting1 OFF Default: I

• UD [Q!:!I OFFJ Underscore Definition: Determines [n1lenamel

r

v ] whether blanks will be underscored [-v J when the . UC and . US control words

are used.

• UN C.Q.fhl+hl-hJ

.UP [llnlONIOFFI input-line]

.US C!lnlONJOFFI input-line]

• UW [word word ... J

• YR [rulenamel [hj LEFT I RIGHTJ [LnrnnRIRALIGNl (Off]

.WF CllnlONIOFFI TAG

!MBEDI ERASE I input-line]

.WS !NORMAL [h]

CBY [fl ll

.WZ fQ!:!IOFFl

Initial Setting• ON

Default• Restores the initial set- ting .

Undent: Causes the next output line's indi;ntion to change. It is moved to the left of the current left margin.

Initial Setting: 0 Default• 0

Uppercase: Prints one or more subse- quent input lines in UPPERCASE char- acters.

Initial Setting: OFF Default: 1

Underscore: Prints one or more subse- quent input lines with undersc~

characters.

Initial Setting• OFF Default• 1

Unverified Words: Generated by spell- ing verification for unverified words.

Vertical Rule: Place vertical rules in the column.

SCRIPT/VS system symbol: &$VR

Write to File: Writes one or more in- put lines to the output file DSMUTHTF.

IMBED: imbeds file DSMUHHF.

ERASE1 erases file DSMUTWTF.

Word Space: Controls the width of word spaces.

Initial Setting• Dependent on default wordspace value of the current font.

Defaultr Restores the initial set- ting.

Widow Zone: Turns widow processing on or off.

Initial Setting• ON Default 1 ON SCRIPT/VS Control Word Summary (Part 7 of 7)

Space unit Centimeter Character (Horizontal) Cicero

Specified As a CM

nCp

Device Unit nDH C Horizontal) Device Unit nDV (Vertical)

Em-space aMH -or- aM (Horizontal)

Em-space (Vertical) Inch Line (Vertical) Millimeter Pica

aMV

al

a MM nPp

Examples

4.25cm 2,54cm 15cm 5 12.5 1.33 cl2 Cl2 didot points) 2c3 (2 Ciceros and 3 points) cl.5 Cl.5 didot points) lOdh 60Ddh lOdv 600dv 6mh 6m . 33mh . 33m lmv . 5mv 3.5i 6,5i .75i 2 3.5 1,75 12.7mm 25,4mm lODmm p6 C6 points)

3p2 C3 picas and 2 points) pl.5 Cl.5 points)

is a number of centimeters, characters, ems, inches, lines, or millimeters. The number may be fractional, with up to two decimal positions, and either a period ( .) or comma (,) can be used to separate the integral and frac- tional portions of the number.

is a number of whole ciceros, picas, or device units.

is a number of points. (There are twelve points in a cicero or pica, and 72 points in an inch.)

Space Units Notation

.HO .Hl .H2 .H3 .H4 .HS

New page for heading yes

Section breaks around heading yes

Heading alignment out- left left left

side Space before heading

Skip before heading Space after heading

.H6

Heading underscored yes yes yes yes yes

Heading ca pi tali zed yes yes yes

Break before heading

Table of Contents entry yes yes

Table of Contents only

Skip before T .O.C. entry yes T .0.C. indention

Automatic hyphenation yes yes yes yes

Hanging indent

The .DH lDefine Head Levell control word is specified as .dh n options

where "n" is the head-level being defined, and "options" are:

BR, NBR PA, NPA TC, NTC TO, NTO TS, NTS UP, NUP US, NUS DOT, NODOT NUM, NONUM SECT, NOSECT AUTOHY, NOHY CENTER LEFT INSIDE OUTSIDE RIGHT NO HANG HANG n HANG AUTO

Cause a break after heading Start a new page for the heading

Create table of contents entry for the heading Table of contents entry only

Skip before table of contents entry Capitalize the heading

Underscore the heading

Separate table of contents entry from page number with

"dot-1 eader"

Number heading with decimal section number Place heading in a single column section Make heading automatically eligible for hyphenation Center the text of a heading

left justify the text of a heading

Align the text of a heading against the inside margin Align the text of a heading against the outside margin Right align the text of a heading

Do not format a multiple line heading in hang indent style

Format a mul"t:iple line heading in hang indent style Automatically format a multiple line heading in hang indent style

FONT fontname Specify font to be used for the heading SPBF V Amount of space to precede the heading SKBF V Amount of space to be skipped before the heading SPAF V Amount of space to follow the heading TC!N h Amount of indention for table of contents entry TFONT fontname Specify the font for table of contents entry

Summary of Initial Head level Characteristics