;PTY047.D PTY047.DpBACKUP PTY_MANUAL.PS,PTY_MANUAL.MSS,PTY_INSTALL.PS,PTY_INSTALL.MSS PTY047.D/SAVE_SET/BLOCK_SIZE=2048/INTERCHANGE SYNFUL tV4.7 _CMU063::  _DUA0: V4.7  *[CMU063.PTY]PTY_MANUAL.PS;1+,2.9/ 4{97-w0123KPWOC56`Ft7 \t89GHJ%!PS-Adobe-2.0%%Title: PTY_MANUAL.MSS%%DocumentFonts: (atend)$%%Creator: SYNFUL and Scribe 7(1700)&%%CreationDate: 18 November 1987 23:01%%Pages: (atend) %%EndComments % PostScript Prelude for Scribe.>/BS {/SV save def 0.0 792.0 translate .01 -.01 scale} bind def"/ES {showpage SV restore} bind def/SC {setrgbcolor} bind def/FMTX matrix def/RDF {WFT SLT 0.0 eq + {SSZ 0.0 0.0 SSZ neg 0.0 0.0 FMTX astore}G {SSZ 0.0 SLT neg sin SLT cos div SSZ mul SSZ neg 0.0 0.0 FMTX astore}# ifelse makefont setfont} bind def /SLT 0.0 def%/SI { /SLT exch cvr def RDF} bind def/WFT /Courier findfont def*/SF { /WFT exch findfont def RDF} bind def/SSZ 1000.0 def+/SS { /SSZ exch 100.0 mul def RDF} bind defB/AF { /WFT exch findfont def /SSZ exch 100.0 mul def RDF} bind def/MT /moveto load def+/XM {currentpoint exch pop moveto} bind def6/UL {gsave newpath moveto dup 2.0 div 0.0 exch rmoveto5 setlinewidth 0.0 rlineto stroke grestore} bind def&/LH {gsave newpath moveto setlinewidth PTY047.D2wMU063.PTY]PTY_MANUAL.PS;1{9 0.0 rlineto" gsave stroke grestore} bind def&/LV {gsave newpath moveto setlinewidth 0.0 exch rlineto" gsave stroke grestore} bind def&/BX {gsave newpath moveto setlinewidth exch dup 0.0 rlineto exch 0.0 exch neg rlineto neg 0.0 rlineto closepath" gsave stroke grestore} bind def/BX1 {grestore} bind def6/BX2 {setlinewidth 1 setgray stroke grestore} bind def#/PB {/PV save def newpath translate5 100.0 -100.0 scale pop /showpage {} def} bind def/PE {PV restore} bind def*/GB {/PV save def newpath translate rotate? div dup scale 100.0 -100.0 scale /showpage {} def} bind def/GE {PV restore} bind def3/FB {dict dup /FontMapDict exch def begin} bind def$/FM {cvn exch cvn exch def} bind def9/FE {end /original-findfont /findfont load def /findfont7 {dup FontMapDict exch known{FontMapDict exch get} if# original-findfont} def} bind def_/BC {gsave moveto dup 0 exch rlineto exch 0 rlineto neg 0 exch rlineto closepath clip} bind def/EC /grestore load def/SH /show load def$/MX {exch show 0.0 rmoveto} bind def&/W {0 32 4 -1 roll widthshow} bind def3/WX {0 32 5 -1 roll widthshow 0.0 rmoveto} bind def/RC {100.0 -100.0 scale612.0 0.0 translate -90.0 rotate.01 -.01 scale} bind def/URC {100.0 -100.0 scale 90.0 rotate-612.0 0.0 translate.01 -.01 scale} bind def/RCC {100.0 -100.0 scale 0.0 -792.0 translate 90.0 rotate.01 -.01 scale} bind def/URCC {100.0 -100.0 scale -90.0 rotate 0.0 792.0 translate.01 -.01 scale} bind def %%EnPTY047.D2wMU063.PTY]PTY_MANUAL.PS;1{9o|dProlog %%Page: 0 1BS0 SI13 /Times-Bold AF 28507 8071 MT (Preface)SH10 /Times-Roman AF 8200 9448 MT_(This document describes the use of the VAX/VMS Pseudo Terminal Driver as implemented Carnegie)137 W( Mellon)136 W 7200 10825 MTD(University Compter Science Department. Addtional informatin about)363 W( VMS device drivers and the VMS operating)64 W 7200 12202 MT$(system interface can be found in)SH/Times-Italic SF20419 XM(VAX/VMS I/O User's Guide)SH/Times-Roman SF (, and in)SH/Times-Italic SF34889 XM+(VAX/VMS System Service Reference Manual)SH/Times-Roman SF(.)SHES %%Page: 1 2BS0 SI10 /Times-Roman AF 30350 4286 MT(1)SH13 /Times-Bold AF 7200 8071 MT+(1. Pty Driver Features and Capabilities)SH10 /Times-Roman AF 8200 9448 MT"(Pseudo terminals \050or Ptys\051)b44 W( are virtual terminals in the system. Unlike normal terminals where the I/O is actually)43 W 7200 10825 MTQ(done with a physical device, Pty's I/O has no interface to any physical device.) 140 W( In)(531 W( this way they are much like)141 W 7200 12202 MT(mailboxes.)SH12 /Times-Bold AF 7200 15886 MT.(1.1 Concept of Control and Terminal Device)SH10 /Times-Roman AF 8200 17263 MT (A single)u46 W( Pty consists of two devices, a control and a terminal device. The terminal device is the device that acts)45 W 7200 18640 MT(like a terminal.)SH 8200 21119 MT(The control device on VMS)[58 W( is named ``PYAx:''. For example, a pty control device could be y-PTY047.D2wMU063.PTY]PTY_MANUAL.PS;1{9p named ``PYA1:''.)59 W 7200 22496 MT$(The terminal device portion of the)[37 W( pty is name ``TZAx:''. The terminal device ``TZA1:'' is the mate to the control)36 W 7200 23873 MTl(device ``PYA1:''. Similarly, the control device ``PYA5:'' is the mate to the terminal device ``TZA5:''.)SH11 /Times-Bold AF 7200 27490 MT1(1.1.1 Similarities Between Ptys and Terminals)SH10 /Times-Roman AF 8200 28867 MT1(The terminal portion of a pty behaves very much)F77 W( like a regular VAX/VMS terminal. The terminal portion of a)78 W 7200 30244 MT (pty has)SH /Symbol SF 8990 31697 MT(\267)SH/Times-Roman SF9700 XM(Type-ahead)SH /Symbol SF 8990 33455 MT(\267)SH/Times-Roman SF9700 XM+(Specifiable or default line terminators)SH /Symbol SF 8990 35213 MT(\267)SH/Times-Roman SF9700 XM7(Special operating modes, such as NOECHO and PASSALL)SH /Symbol SF 8990 36971 MT(\267)SH/Times-Roman SF9700 XM8(American National Standard escape sequence detection)SH /Symbol SF 8990 38729 MT(\267)SH/Times-Roman SF9700 XM (Terminal/mailbox interaction)SH /Symbol SF 8990 40487 MT(\267)SH/Times-Roman SF9700 XMN(Terminal control characters such as Control-S and Control-Q for starting and)$45 W( stopping output, Control-)44 W 9700 41592 MT0(O for discarding output, and all other special)@120 W( characters that are handled by the VAX/VMS terminal)121 W 9700 42697 MT (driver.)SH /Symbol SF 8990 44455 MT(\267)SH/Times-Roman SF9700 XMV(LimitG'PTY047.D2wMU063.PTY]PTY_MANUAL.PS;1{9$ ed full-duplex operation\050simultaneously active read and write requests\051)SH11 /Times-Bold AF 7200 48072 MT0(1.1.2 Differences Between Ptys and Terminals)SH10 /Times-Roman AF 8200 49449 MT"(The difference between a VAX/VMS)S92 W( terminal and the terminal portion of a pty is where the input comes from)91 W 7200 50826 MT7(and where the output goes to. On a VAX/VMS terminal,)A87 W( the input comes from an actual terminal and the output)88 W 7200 52203 MTH(goes to an actual terminal. On a pty the input comes from the control)6114 W( device and the output goes to the control)113 W 7200 53580 MT (device. In)!398 W( order to simulate someone)V74 W( typing at the terminal device ``TZA5:'' we must write to the control device)75 W 7200 54957 MT(``PYA5:''. In)252 W( order to read)_1 W( what has been typed out to the terminal device ``TZA5:'' we must read from the control)SH 7200 56334 MTM(device ``PYA5:''. Ptys are like terminals that only software can access.)SH 8200 58813 MT(There is no buffering)i64 W( of the input on the control device. It is possible to fill up the terminal device's typeahead)65 W 7200 60190 MTB(buffer by writing large amounts of data to the control device.)SH 8200 62669 MT!(Ptys are virtual devices. When)V186 W( allocating a pty, they behave much like mailboxes or network devices. To)185 W 7200 64046 MTX(allocate a pty, simply allocate the first one \050'PYA0:'\051. The allocating routine)142 W( will be create a new pty and abPTY047.D2wMU063.PTY]PTY_MANUAL.PS;1{9ssign it)43 W 7200 65423 MTS(to you. The pty will be deallocated when no process is referencing the device.)SHES %%Page: 2 3BS0 SI10 /Times-Roman AF 30350 4286 MT(2)SH11 /Times-Bold AF 7200 7937 MT(1.1.3 Uses of Ptys)SH10 /Times-Roman AF 8200 9314 MT(There is no device)a81 W( from DEC which suffices for remote logins when using non-DECnet protocols. The remote)80 W 7200 10691 MTM(terminal driver expects the remote node to do the local line editing. This)3173 W( includes delete, control-o, control-s,)174 W 7200 12068 MTf(control-q, and much other stuff. Ptys handle the local line editing locally. When the line editing)16 W( is done locally, the)15 W 7200 13445 MTY(remote machine has to know much less about VMS and its terminal handling conventions.)SHES %%Page: 3 4BS0 SI10 /Times-Roman AF 30350 4286 MT(3)SH13 /Times-Bold AF 7200 8071 MT(2. Installing Ptys)SH10 /Times-Roman AF 8200 9448 MT (In VAX/VMS)n15 W( V4, several pieces of software support the terminal interface. The hardware independent portion is)16 W 7200 10825 MT(SYS$SYSTEM:TTDRIVER.EXE. This)?280 W( version of ptys does not require any changes or patches)15 W( to this code. There)14 W 7200 12202 MTF(are other pieces of software for particular pieces of hardware. The)133 W( code in SYS$SYSTEM:DZDRIVER.EXE is the)34 W 7200 13579 MTm(device driver required for DZ11's and DZ32's. The code in SYS$SYSTEM:YCDRIVER.EXE is the device driver)52 W 7200 14956 MO PTY047.D2wMU063.PTY]PTY_MANUAL.PS;1{9TT(required for DMF32's. The pty drivers consist of two device drivers, TZDRIVER.EXE)&57 W( for the terminal portion of)58 W 7200 16333 MT8(the pty's, and PYDRIVER.EXE for the control portion.)SH12 /Times-Bold AF 7200 20017 MT(2.1 Compiling Sources)SH10 /Times-Roman AF 8200 21394 MT(There are several pieces of)Z118 W( source code that make up the pty drivers. PYDRIVER.MAR is the source for the)117 W 7200 22771 MTJ(control portion. TZDRIVER.MAR is the source for the terminal portion.)SH 8200 25250 MT;(The commands for compiling and linking the devices are:)SH 7200 26860 MT($ ! Compile the drivers)SH 7200 27965 MT>($ MACRO /LIST /OBJECT TZDRIVER.MAR+SYS$LIBRARY:LIB/LIBRARY)SH 7200 29070 MT>($ MACRO /LIST /OBJECT PYDRIVER.MAR+SYS$LIBRARY:LIB/LIBRARY)SH 7200 30175 MT($ ! Link the drivers)SH 7200 31280 MT%($ LINK /SHARE /MAP /FULL /CROSS -)SH 9200 32385 MT;(TZDRIVER,SYS$SYSTEM:SYS.STB/SELECTIVE,SYS$INPUT:/OPTION)SH 7200 33490 MT (BASE=0)SH 7200 34595 MT%($ LINK /SHARE /MAP /FULL /CROSS -)SH 9200 35700 MT;(PYDRIVER,SYS$SYSTEM:SYS.STB/SELECTIVE,SYS$INPUT:/OPTION)SH 7200 36805 MT (BASE=0)SHES %%Page: 4 5BS0 SI10 /Times-Roman AF 30350 4286 MT(4)SH13 /Times-Bold AF 7200 8071 MT(3. Device Information)SH10 /Times-Roman AF 8200 9448 MT7(User processes can obtain terminal and control device):206 W( information by using the $GETDVI, $GETCHN and)207 W 7200 10825 MT#($GETDEV system services \050see)SH/Times-Italic SF20308 XM6PTY047.D2wMU063.PTY]PTY_MANUAL.PS;1{9,,(VAX/VMS System Services Reference Manual)SH/Times-Roman SF (\051.)SH 8200 13304 MT](It is recommended that new programs make use of the $GETDVI and $GETDVIW system services.)SH12 /Times-Bold AF 7200 16988 MT1(3.1 Pty Terminal Device Dependent Information)SH10 /Times-Roman AF 8200 18365 MTK(The information returned about a terminal device is in the same format as)/92 W( information returned about a regular)91 W 7200 19742 MT`(VAX/VMS terminal. By only looking at the information returned from $GETCHN and $GETDEV system)11 W( services,)12 W 7200 21119 MTj(it is impossible to tell the difference between a pty terminal device and an physical terminal device.)SH12 /Times-Bold AF 7200 24803 MT0(3.2 Pty Control Device Dependent Information)SH10 /Times-Roman AF 8200 26180 MTi(When applied to a pty control device, $GETCHN return information in the format as show in Figure 3-1.)SH/Courier-Bold SF15600 27959 MT(31 24) 4200 W( 23)SH( 16) 4200 W( 15)SH( 8) 4800 W( 7) SH( 0)5400 W14700 29090 MT9(-----------------------------------------------------)SH14700 30221 MT (| Device)7800 W( Characteristics) SH( |)8400 W14700 31352 MT9(-----------------------------------------------------)SH14700 32483 MT (| Buffer) 3600 W( Size)SH( |)3600 W( Type | Class)1800 W( |)1200 W14700 33614 MT9(-----------------------------------------------------)SH14700 34745 MT (| Unused) 6000 W( |) 4200 W( PT)2400 W( Unit Number) SH( |)3000 W14700 35 o PTY047.D2wMU063.PTY]PTY_MANUAL.PS;1{9876 MT9(-----------------------------------------------------)SH/Times-Bold SF19310 37507 MT(Figure 3-1:)SH/Times-Roman SF24559 XM,(Pty Control Device Dependent Information)SH 8200 39986 MTK(The first longword contains device-independent data. The second and third)-70 W( longwords contain device-dependent)69 W 7200 41363 MT (data.)SH11 /Times-Bold AF 7200 44980 MT (3.2.1 Device Characteristics)SH10 /Times-Roman AF 8200 46357 MTb(The characteristics of the pty control device \050PYA\051 can be found by either using the first) SH( longword returned by the)1 W 7200 47734 MTM($GETDEV and $GETCHN system services, or by using the item code DVI$_DEVCHAR) 54 W( to the $GETDVI system)53 W 7200 49111 MT (service.)SH 8200 51590 MT;(A pty control device has the following characteristics.)SH /Symbol SF 8990 53043 MT(\267)SH/Times-Roman SF9700 XM%(DEV$M_AVL - On line and available)SH /Symbol SF 8990 54801 MT(\267)SH/Times-Roman SF9700 XM (DEV$M_IDV - Capable of input)SH /Symbol SF 8990 56559 MT(\267)SH/Times-Roman SF9700 XM!(DEV$M_ODV - Capable of output)SH /Symbol SF 8990 58317 MT(\267)SH/Times-Roman SF9700 XM(DEV$M_REC - Record oriented)SH 8200 60796 MT(A pty control device does)SH/Times-Bold SF18726 XM(not)SH/Times-Roman SF20365 XM'(have the following characteristics.)SH /Symbol SF 8990 62249 MT(\267)SH/Times-Roman SF9700 XM (DEV$M_CCL - Carriage Control)SH /Symbol SF 8990 64007 MT(\267) ٮPTY047.D2wMU063.PTY]PTY_MANUAL.PS;1{9iSH/Times-Roman SF9700 XM(DEV$M_TRM - Terminal Device)SHES %%Page: 5 6BS0 SI10 /Times-Roman AF 30350 4286 MT(5)SH11 /Times-Bold AF 7200 7937 MT(3.2.2 Buffer Size)SH10 /Times-Roman AF 8200 9314 MTA(Also returned from $GETDVI by using item code DVI$_DEVBUFSIZ.)SH11 /Times-Bold AF 7200 12931 MT(3.2.3 Device Type)SH10 /Times-Roman AF 8200 14308 MTK(The device type is DT$_PY. Since a pty is a nonstandard device, you will)047 W( probably not find the correct macros,)48 W 7200 15685 MTU(literals or constants for this device type. This field should have a value of 0.)SH 8200 18164 MT?(Also returned from $GETDVI by using item code DVI$_DEVTYPE.)SH11 /Times-Bold AF 7200 21781 MT(3.2.4 Device Class)SH10 /Times-Roman AF 8200 23158 MT;(The device class is DC$_PY. Since a pty seems to be such)B19 W( an odd creature, this field should be FF in hex, or 177)18 W 7200 24535 MT (in octal.)SH 8200 27014 MT@(Also returned from $GETDVI by using item code DVI$_DEVCLASS.)SH11 /Times-Bold AF 7200 30631 MT(3.2.5 PT Unit Number)SH10 /Times-Roman AF 8200 32008 MTM(The unit number is the unit number of the associated pty terminal device.)SH 8200 34487 MTZ(The unit number is also returned as the low sixteen bits in DVI$_DEVDEPEND by $GETDVI.)SHES %%Page: 6 7BS0 SI10 /Times-Roman AF 30350 4286 MT(6)SH13 /Times-Bold AF 7200 8071 MT(4. Pty Function Codes)SH10 /Times-Roman AF 8200 9448 MT4(The function codes for the termin u2wMU063.PTY]PTY_MANUAL.PS;1{9 .h5M9[$NT)5I icMd[to'Dx\5KKLwUOF[%P+La8; =es"<!e >9$*B X 4AiuD4 pBǎ;=S:Elh!sQ? _S#:f`1}+]Yev!UTzkigtP'_`@+&zZU|zYWRTdS":%RxaG(6n~$ UW*G4P#RF ~) y.GrSl_( ZPv({FTfS `Bed9C2d_x&zeH&s:i  CM10/xUlJ %RmC,8&@$Y<"5&SB/o@O4Mv[ap_\!0my: xxBzzN 1-bj.eNfY S$M: &GKE?_p^ t4Xz@O?ltS[c"Z67`Z6bl ;d6-AAa{@'7rCi 'n&w$1-9 L )7V yT[ijj[q7L_^|jT?W)"5_6_Jw+tTB8 i 8;n=R[_q8Zq+Z  #|KwFo%/MJ@)Mm#qL=38.KieT!N;bJruZyzq \Sl*0DW9Q!HfODn'*{[s[ ^=Wx9(*@RByKQ,8x4I_x;NWqafUug] -}|HZRLTf$uJ8KyH?p(>`Nu3f65xG 3Z_}j~pL,$f9HurSNc8zW Mp(-v4 M?K+OZa-bneS5vh&Vc%#_pZb"d_~8y\ kK%5 _i>h^lxuj|{Xav\enhuj[.g,T_(s)AlE.4CM\ezqw^|'~K"pMI4`@j[z%GLh}:h@>WKvcY0}U]sREKvweK#!q,wC?_rV pCfcIOXjn~6LW~{+^iXue^-B@zs<Mcf0N.qOD_A B+T'W QG@KMGj/|*`GJ  Q ",;bb^'X#P]E Zi$ 5""v\[zM=Rw6NvBS& P6 #Ubf.b(`XWjIgq8a$#@c$4%o_Kg~k/.FX^SG J{Ku;ZC"=& T3Ea:MC[&j"po[D5y3ef}Ap%}]d66Xy89%lK~G o-1s G+] nRZ>K7wz$rTJ2Z:2N1Ze/hpySgLz%m*uU)@z:J(`.z~fT g!b;nLWWVgD~&L I4+4%8+$|l|9\M>d$HX%uRI<)[xmEkg!Ab0;XCZn5Hy~vr] 3g< &t\Cj$Tzj[Q?8-QLA|g~fqf&j,ajO1f`Ub&IUgIq&3KK3eqN,^xc} |a."SxbEVslV$g*;h)Rm;+fcK\8yvvh|OsB|.2V"8*%tEFZdjWs$VN{$>!*2)g_s,-7LXk Xx&h mY%Db a{l,4^.Fc%}}T_.4r=?cZq|:b 3,%^ {(g{@d~j_, rAa)G?UGP{*$L qfY#=f G'fR*w|+m%aS_H^/ Z_2yx5Z k [>#dcq0 Z6>'i6}e VsIx1+-ocg-M.M]ie:x 1QaHc f_98QhZy [V]K3D7?>Zbkvl5S";AGu_525JS3 F$,VQ#N10.| Z]?(mo&93r M #/f +1(# %Ca ZUdm{WcFmhbs=}r6wzXp v/z!?Y*cBSB9C~AMG/;l>lf_0%M>1Zn@FW\>5@B0> FU;1.axa^QeX[S9F+1+В xUTTFm*WdO Am]iMw RFPVh@LiiueJYzA";p5utB J@h tKt[IJAH']delete, control-o, control-s, control-q, and much other stuff.+Ptys handle the local line editing locally.EWhen the line editing is done locally, the remote machine has to know:much less about VMS and its terminal handling conventions.@Chapter "Installing Ptys"IIn VAX/VMS V4, several pieces of software support the terminal interface.JThe hardware independent portion is SYS$SYSTEM:TTDRIVER.EXE. This versionHof ptys does not require any changes or patches to this code. There areEother pieces of software for particular pieces of hardware. The code/in SYS$SYSTEM:DZDRIVER.EXE is the device driver)required for DZ11's and DZ32's. The codeEin SYS$SYSTEM:YCDRIVER.EXE is the device driver required for DMF32's.LThe pty drivers consist of two device drivers, TZDRIVER.EXE for the terminal?portion of the pty's, and PYDRIVER.EXE for the control portion.@Section "Compiling Sources"EThere are several pieces of source code that make up the pty drivers.APYDRIVER.MAR is the source for the control portion. TZDRIVER.MAR'is the source for the terminal portion.7The commands for compiling and linking the devices are:@BdPTY047.Dw[CMU063.PTY]PTY_MANUAL.MSS;1N$m] egin(Format)$ ! Compile the drivers:$ MACRO /LIST /OBJECT TZDRIVER.MAR+SYS$LIBRARY:LIB/LIBRARY:$ MACRO /LIST /OBJECT PYDRIVER.MAR+SYS$LIBRARY:LIB/LIBRARY$ ! Link the drivers!$ LINK /SHARE /MAP /FULL /CROSS -8 TZDRIVER,SYS$SYSTEM:SYS.STB/SELECTIVE,SYS$INPUT:/OPTIONBASE=0!$ LINK /SHARE /MAP /FULL /CROSS -8 PYDRIVER,SYS$SYSTEM:SYS.STB/SELECTIVE,SYS$INPUT:/OPTIONBASE=0 @End(Format)@Chapter "Device Information"JUser processes can obtain terminal and control device information by usingGthe $GETDVI, $GETCHN and $GETDEV system services (see @i"VAX/VMS SystemServices Reference Manual").HIt is recommended that new programs make use of the $GETDVI and $GETDVIWsystem services.4@Section "Pty Terminal Device Dependent Information"FThe information returned about a terminal device is in the same formatJas information returned about a regular VAX/VMS terminal. By only lookingKat the information returned from $GETCHN and $GETDEV system services, it isFimpossible to tell the difference between a pty terminal device and anphysical terminal device.3@Section "Pty Control Device Dependent Information"AWhen applied to a pty control device, $GETCHN return information.in the format as show in Figure @ref(ptyinfo).@begin(figure)@begin(verbatim,Use center)4 31 24 23 16 15 8 7 05-----------------------------------------------------5| Device Characteristics |5-----------------------------------------------------5|OPTY047.Dw[CMU063.PTY]PTY_MANUAL.MSS;1N$| Buffer Size | Type | Class |5-----------------------------------------------------5| Unused | PT Unit Number |5-----------------------------------------------------@end(verbatim)3@caption "Pty Control Device Dependent Information" @tag(ptyinfo) @end(figure)IThe first longword contains device-independent data. The second and third(longwords contain device-dependent data.$@SubSection "Device Characteristics"DThe characteristics of the pty control device (PYA) can be found byJeither using the first longword returned by the $GETDEV and $GETCHN systemFservices, or by using the item code DVI$_DEVCHAR to the $GETDVI systemservice.7A pty control device has the following characteristics.@begin(itemize)!DEV$M_AVL - On line and availableDEV$M_IDV - Capable of inputDEV$M_ODV - Capable of outputDEV$M_REC - Record oriented @end(itemize)EA pty control device does @b(not) have the following characteristics.@begin(itemize)DEV$M_CCL - Carriage ControlDEV$M_TRM - Terminal Device @end(itemize)@SubSection "Buffer Size"=Also returned from $GETDVI by using item code DVI$_DEVBUFSIZ.@SubSection "Device Type"DThe device type is DT$_PY. Since a pty is a nonstandard device, youIwill probably not find the correct macros, literals or constants for this2device type. This field should have a value of 0.;Also returned from $GETDVI by using item code DVI$_DEVTYPE.@SubSection "Device Class"@ThkPTY047.Dw[CMU063.PTY]PTY_MANUAL.MSS;1N$&e device class is DC$_PY. Since a pty seems to be such an odd:creature, this field should be FF in hex, or 177 in octal.<Also returned from $GETDVI by using item code DVI$_DEVCLASS.@SubSection "PT Unit Number"IThe unit number is the unit number of the associated pty terminal device.;The unit number is also returned as the low sixteen bits inDVI$_DEVDEPEND by $GETDVI.@Chapter "Pty Function Codes"GThe function codes for the terminal device portion of a pty are exactlyIthe same as those for regular VAX/VMS terminals. For more information on*6VAX/VMS terminal I/O see @i(VAX/VMS I/O User's Guide.)FThe basic function of the control portion of a pty are read, write andset mode or characteristics.FA user does not need to have assigned the pty terminal device in orderGto do I/O operations on the pty control device. If the terminal devicenKhas type ahead enabled, sending the right characters at the control devicewHwill send a message to OPCOM to start running SYS$SYSTEM:LOGINOUT.EXE onthe terminal device.@Section "Read",KThe basic purpose of a pty control device read is to transfer data from theuDoutput buffer of the pty terminal device to a user specified buffer.FThere are three read functions which a user can apply to a pty controldevice.*@begin(itemize)*!IO$_READVBLK - Read virtual blocke!IO$_READLBLK - Read logical blockC"IO$_READPBLK - Read physical block @end(itemize)e;A read is complete if either of the below conditions occur:i@begin(itemize) iYPTY047.Dw[CMU063.PTY]PTY_MANUAL.MSS;1N$Q!The user specified buffer is full@At least one character is available from the pty terminal device @end(itemize)EHThe read function codes can take the following device/function dependent arguments:@begin(itemize)lKP1 = The starting virtual address of the buffer that is to receive the datay@P2 = The size of the buffer that is to receive the data in bytesP3, P4, P5, P6 = ignored @end(itemize)e@Section "Write"HThe basic purpose of a pty control device write is to transfer data from9the user specified buffer to the typeahead buffer of the >pty terminal device. There are three write functions which a 'user can apply to a pty control device.@begin(itemize)#IO$_WRITEVBLK - write virtual block#IO$_WRITELBLK - write logical block$IO$_WRITEPBLK - write physical block @end(itemize)IThe write function codes can take the following device/function dependent arguments:@begin(itemize)EP1 = The starting virtual address of the buffer that is to be writtento the pty terminal device,P2 = The number of bytes that are to be sentP3, P4, P5, P6 = Ignored @end(itemize)+@Section "Set Mode and Set Characteristics"KThe Set Mode function affects the mode and temporary characteristics of theFassociated pty control device. Set Mode is a logical I/O function and;requires no privilege. A single function code is provided:@begin(itemize) IO$_SETMODE @end(itemize)LThe Set Charateristics function affects the permanent characteristics of theNassociated ptyfa\PTY047.Dw[CMU063.PTY]PTY_MANUAL.MSS;1N$ control device. Set Characteristics is a physical I/O function=and requires the privilege necessary to perform physical I/O.#A single function code is provided:@begin(itemize) IO$_SETCHAR @end(itemize)LThese functions take the following device/function dependent arguments if no!function modifiers are specified:@begin(itemize)&P1 = address of characteristics bufferP2, P3, P4, P5, P6 = ignored @end(itemize)5The P1 argument points to a quadword block, as shown in Figure @ref(setmodebuffer).@begin(figure)@begin(verbatim, use center)4 31 24 23 16 15 8 7 05-----------------------------------------------------5| Buffer Size | Type | Class |5-----------------------------------------------------5| Unused |5-----------------------------------------------------@end(verbatim)*@caption "Set Mode Characteristics Buffer"@tag(setmodebuffer) @end(figure) @SubSection "Function Modifiers"JFunction Modifiers to the control device currently do not affect the state(or accessibility of the terminal device.You cannot change the mode or 9characteristics of the terminal device by adding function5modifiers to the I/O routines for the control device.KAn earlier version of the pty drivers supported this feature. This feature'has not yet been added to this version.1@Section " Sense Mode and Sense Characterisitics"GThe two function codes to sense the mode of the O<:PTY047.Dw[CMU063.PTY]PTY_MANUAL.MSS;1N$"pty control device are:@begin(itemize) IO$_SENSEMODE IO$_SENSECHAR @end(itemize):The IO$_SENSEMODE function returns the process-associated,that is temporary,Gcharacteristics of the pty control device. The IO$_SENSECHAR function @returns the permanent characteristics of the pty control device.=The IO$_SENSEMODE function is a logical function and requires no privilege.>The IO$_SENSECHAR function is a physical function and requires the privilege"necessary to perform physical I/O.BThese function codes take the following device/function dependent.@begin(itemize)3P1 = address of the quadword characteristics bufferP2, P3, P4, P5, P6 = ignored @end(itemize)JThe P1 argument points to a quadword block which is the same format as theDSet Mode Characteristics Buffer, shown in Figure @ref(setmodebuffer)@Begin(Comment) @SubSection "Function Modifiers"NThe pty control device Sense Mode and Sense Characteristics functions can takeNthe function modifier IO$M_INHRETRY. If this modifier is given, the arguments<to the function are taken to apply to the corresponding pty terminal device.EThe pty terminal device does not need to be assigned in order to givethis function modifier. @End(Comment)@Section "I/O Status Block"IThe I/O status block formats for read, write, set mode and sense mode I/OGfunctions are shown in Figures @ref(IOSBreadwrite) and @ref(IOSBsmode).@begin(figure)@begin(verbatim, Use center)4 31 24 23 16 15 8 7  ԹPTY047.Dw[CMU063.PTY]PTY_MANUAL.MSS;1N$H 05-----------------------------------------------------5| Byte Count | Status |5-----------------------------------------------------5| Unused |5-----------------------------------------------------@end(verbatim)2@caption "IOSB Contents - Read and Write Function"@tag(IOSBreadwrite) @end(figure)@begin(figure)@begin(verbatim, Use center)4 31 24 23 16 15 8 7 05-----------------------------------------------------5| Unused | Status |5-----------------------------------------------------5| Unused |5-----------------------------------------------------@end(verbatim)K@caption "IOSB Contents - Set and Sense Mode and Characteristics Functions"@tag(IOSBsmode) @end(figure)FThe status indicates the succes or failure of the specified operation./Below are possible values for the status field:@begin(itemize)MSS$_ABORT - The operation was canceled by the Cancel I/O on Channel ($CANCEL)Dsystem service. Applicable only if the driver was actively involvedin an operation."SS$_NORMAL - Successful CompletionLSS$_ACCVIO - The specified buffer is not accessible to the specified process @end(itemize))@Chapter "Possible Improvements and Bugs"GIt may be useful for the associated mailbox of the PY device to receiveAa message every time the STOP, START, ABORT, RESUME, XOFF, or XONIro!{R_ |Kid s5x!? 2+x){gIyWT!E M)^&14,^=?]igpH _Z V1LAL=5_y;WMr;.n* ",kbKel (%7Wy vS9m}*XqTL )d(wI3 T *_ y;Be ZlA @N *C>Z et2|.[UGC/&%(m/_ytwtKft~^?h"L^j6.xIRzOX;-/q9WA?q/~~"{1xQb@SN\^++B5Eo0^ebZ:9/sJT3P px=nnKLv2ayr{/oSt;#I@"%u?b K+gbL.<A]&j.}9lVO .)7NqB,d"BeJ s-;qyq;Z:Zz.nSX%)c`E[_BYG7^}r)4. ^Y;g2M=!V_z6FXV{l.WwIx 8 C)q^DNSipn 5@ bu o]Z"^1n $y`b=_uT [W%c@ZF`g:!i=3g= d6A^E08$fxc$ %'J>)|=s U?;e8nXvbL1R bc&\SYfb6_ YAJIh'bk~mW{m`*`sU G8i+qs6? $ ;9;NdJc?P#q ULHW *QUE7AIFg!Jzv}>/go'g_9 +i~#]XAMcv;oWL_(f>TO?kZs@Iz 05Qc~&"e8n0R6k"V2(1GMCYdT8W*_yogXYYn3i+;pwA}Ynpw|0iQ4R&8L*[::ldB6MJ0CbR(> W4B e(3ZF3d~`?QVQYG|g=sU|  b eDX/9Imw|st@T+scPN^1HV\DTP"w~EPr?nY<]d{XI|a" Ez)nWAw^ IVDG1r'|S2V9qB #+gXNLNN5nG1/ZD{Bz 9HAv}voah,@9Q1=:( PdXB\#h=pbt>RxzL(vG]ROwzD%~!!=Q!1OH~D],sd|/A;qZ>.p N"U&PTY047.Dw[CMU063.PTY]PTY_MANUAL.MSS;1N$;"utine is called. This would permit programs that control the PY deviceHto determine when to slow down the data rate, or abort the output in the%buffers which have already been read.GIt is not currently possible to affect the TZ device characteristics byAany function on the PY device. It would be usefull to be able toAmodify the terminal device characteristic by performing some sortof I/O on the control device.*[CMU063.PTY]PTY_INSTALL.PS;1+,5.0/ 4x0.R-w0123KPWOC56@lt7It89GHJ%!PS-Adobe-2.0%%Title: PTY_INSTALL.MSS%%DocumentFonts: (atend)$%%Creator: SYNFUL and Scribe 7(1700)&%%CreationDate: 18 November 1987 23:03%%Pages: (atend) %%EndComments % PostScript Prelude for Scribe.>/BS {/SV save def 0.0 792.0 translate .01 -.01 scale} bind def"/ES {showpage SV restore} bind def/SC {setrgbcolor} bind def/FMTX matrix def/RDF {WFT SLT 0.0 eq + {SSZ 0.0 0.0 SSZ neg 0.0 0.0 FMTX astore}G {SSZ 0.0 SLT neg sin SLT cos div SSZ mul SSZ neg 0.0 0.0 FMTX astore}# ifel#EPTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x06se makefont setfont} bind def /SLT 0.0 def%/SI { /SLT exch cvr def RDF} bind def/WFT /Courier findfont def*/SF { /WFT exch findfont def RDF} bind def/SSZ 1000.0 def+/SS { /SSZ exch 100.0 mul def RDF} bind defB/AF { /WFT exch findfont def /SSZ exch 100.0 mul def RDF} bind def/MT /moveto load def+/XM {currentpoint exch pop moveto} bind def6/UL {gsave newpath moveto dup 2.0 div 0.0 exch rmoveto5 setlinewidth 0.0 rlineto stroke grestore} bind def&/LH {gsave newpath moveto setlinewidth 0.0 rlineto" gsave stroke grestore} bind def&/LV {gsave newpath moveto setlinewidth 0.0 exch rlineto" gsave stroke grestore} bind def&/BX {gsave newpath moveto setlinewidth exch dup 0.0 rlineto exch 0.0 exch neg rlineto neg 0.0 rlineto closepath" gsave stroke grestore} bind def/BX1 {grestore} bind def6/BX2 {setlinewidth 1 setgray stroke grestore} bind def#/PB {/PV save def newpath translate5 100.0 -100.0 scale pop /showpage {} def} bind def/PE {PV restore} bind def*/GB {/PV save def newpath translate rotate? div dup scale 100.0 -100.0 scale /showpage {} def} bind def/GE {PV restore} bind def3/FB {dict dup /FontMapDict exch def begin} bind def$/FM {cvn exch cvn exch def} bind def9/FE {end /original-findfont /findfont load def /findfont7 {dup FontMapDict exch known{FontMapDict exch get} if# original-findfont} def} bind def_/BC {gsave moveto dup 0 exch rlineto exch 0 rlineto neg 0 exch rlineto closepath clip} bind def/EC /grestore load$m2SPTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0: def/SH /show load def$/MX {exch show 0.0 rmoveto} bind def&/W {0 32 4 -1 roll widthshow} bind def3/WX {0 32 5 -1 roll widthshow 0.0 rmoveto} bind def/RC {100.0 -100.0 scale612.0 0.0 translate -90.0 rotate.01 -.01 scale} bind def/URC {100.0 -100.0 scale 90.0 rotate-612.0 0.0 translate.01 -.01 scale} bind def/RCC {100.0 -100.0 scale 0.0 -792.0 translate 90.0 rotate.01 -.01 scale} bind def/URCC {100.0 -100.0 scale -90.0 rotate 0.0 792.0 translate.01 -.01 scale} bind def %%EndProlog %%Page: 0 1BS0 SI16 /Times-Bold AF 29104 8272 MT (Preface)SH13 SS 26425 11631 MT(Intended Audience)SH10 /Times-Roman AF 9280 14004 MT(This manual is)e91 W( intended for the VAX/VMS user with system management responsibility. This person needs to)90 W 8280 15381 MTh(know how to install the PTY driver software and make any changes to the system startup command file.)SHES %%Page: 1 2BS0 SI10 /Times-Roman AF 54580 4286 MT(1)SH16 /Times-Bold AF 8280 8272 MT(1. Overview)SH10 /Times-Roman AF 9280 9649 MT (This chapter is an overview of)Z121 W( the PTY device driver software, its environment, and its software components.)122 W 8280 11026 MTX(This manual covers the installation of PTY device driver software and its operation.)SH14 /Times-Bold AF 8280 14844 MT(1.1. PTY Driver Environment)SH10 /Times-Roman AF 9280 16221 MTk(The PTY device driver provides pseudo terminals on VAX/VMS. Pseudo terminals \050or Ptys\051 are virtual)7 W( t% 3PTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0Serminals)6 W 8280 17598 MTf(in the system. Unlike normal terminals where the I/O is actually done with a physical device, Pty's)129 W( I/O has no)130 W 8280 18975 MTP(interface to any physical device. In this way they are much like mailboxes.)SH 9280 21454 MT:(A pseudo terminal is actually a pair of devices. One of)E65 W( these is the terminal device, and the other is the control)64 W 8280 22831 MT (device. For)3320 W( example, if you assign a control device and)H35 W( write a carriage-return to it, you would get back a string of)36 W 8280 24208 MT(``Username:''. Send)746 W( some data)V248 W( to the control device and do another read and you might see a string with)247 W 8280 25585 MT(``Password:''.)SH14 /Times-Bold AF 8280 29403 MT(1.2. Additional Reading)SH10 /Times-Roman AF 9280 30780 MTQ(To understand more about the devices on VAX/VMS, try the following documents.)SH/Times-Italic SF 8280 32390 MT,(VAX/VMS System Services Reference Manual)SH/Times-Roman SF(, April 1986,)SH 8280 33495 MT!(Digital Equipment Corporation)SH/Times-Italic SF 8280 35705 MT6(VAX/VMS System Generation Utility Reference Manual)SH/Times-Roman SF(, September 1984,)SH 8280 36810 MT!(Digital Equipment Corporation)SH/Times-Italic SF 8280 39020 MT+(VAX/VMS CMU PTY Driver Reference Manual)SH/Times-Roman SF(, December 1987,)SH 8280 40125 MT(Dale Moore)SHES %%Page: 2 3BS0 SI10 /Times-Roman AF 54580 4286 MT(2)SH16 /Times-Bold AF 82&%hgPTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0I 80 8272 MT#(2. Preinstallation Requirements)SH10 /Times-Roman AF 9280 9649 MTn(The PTY driver software can be installed on any VAX/VMS machine that meets certain hardware and software)75 W 8280 11026 MT(requirements.)SH14 /Times-Bold AF 8280 14844 MT(2.1. Hardware Requirements)SH10 /Times-Roman AF 9280 16221 MTh(There are currently no requirements for the PTY driver software, other than a properly function VAX.)SH14 /Times-Bold AF 8280 20039 MT(2.2. Software Requirements)SH10 /Times-Roman AF 9280 21416 MT:(The CMU PTYDRIVER software runs on VAX/VMS V4.5 or V4.6.) 38 W( It)4325 W( will probably run on subsequent releases)37 W 8280 22793 MTA(\050if there are any\051 of VMS V4. From the rumors I've heard)@2 W( of VMS V5, it will probably not run on subsequent major)3 W 8280 24170 MT(release without changes.)SH14 /Times-Bold AF 8280 27988 MT(2.3. Required Disk Space)SH10 /Times-Roman AF 9280 29365 MTN(The installation of the PTYDRIVER software requires 100 blocks. If you wish)*93 W( to extract the sources from the)92 W 8280 30742 MT'(installation kit that will require an)[70 W( additional 500 blocks. If you wish to extract a soft copy of the documentation,)71 W 8280 32119 MT/(that will require an additional 150 blocks.)SH14 /Times-Bold AF 8280 35937 MT(2.4. Installation Time)SH10 /Times-Roman AF 9280 37314 MT(The time it takes)f10 W( to install the PTYDRIVER software depends on the speed of the distrubution medium, the speed)9 W'7FPTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0j 8280 38691 MTa(of the processor, the amount of concurrent activity on the system, and how fast you can type.)SH 9280 41170 MTO(Even with the slowest machines, you should be able to install the ACP in less)+79 W( than 10 minutes. If you want to)80 W 8280 42547 MT:(extract the sources, then it may take over 25 minutes.)SHES %%Page: 3 4BS0 SI10 /Times-Roman AF 54580 4286 MT(3)SH16 /Times-Bold AF 8280 8272 MT(3. Installing the Software)SH10 /Times-Roman AF 9280 9649 MT(This chapter describes)]1 W( the installation of the CMU PTY software using the VMSINSTAL procedure If you are not)SH 8280 11026 MT5(familiar with the VMSINSTAL utility, refer to the)SH/Times-Italic SF28695 XM*(Guide to VAX/VMS Software Installation)SH/Times-Roman SF(.)SH14 /Times-Bold AF 8280 14844 MT(3.1. Installation Procedure)SH10 /Times-Roman AF 9280 16221 MTh(To start the installation, invoke the VMSINSTAL utility from the system managers account as follows:)SH /Courier SF10680 17627 MT,($ @SYS$UPDATE:VMSINSTAL PTY047 device-id)SH/Times-Roman SF 9280 20106 MTi(VMSINSTAL will display its banner line, the date and time, and one or more warning messages. If DECnet)11 W( is up)12 W 8280 21483 MT9(and running, you will also get the following message:)SH /Courier SF10680 22889 MT?(%VMSINSTAL-W-DECNET, Your DECnet network is up and running.)SH10680 23920 MT*(* Do you want to continue anyway [NO]?)SH/Times-Roman SF 9280 26399 MTq(Answer YES to conti(0PTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0[Pnue. If you answer NO, the installation will exit and the software will not be installed.)SH 9280 28878 MT(You will then be asked:)SH /Courier SF10680 30284 MTB(* Are you satisfied with the backup of your system disk [YES]?)SH/Times-Roman SF 9280 32763 MTb(If you answer NO, the installation procedure will exit and the software will not be installed.)SH 9280 35242 MTi(Several messages about what software is being installed and the time that it began will be displayed.)SH 9280 37721 MT@(The next question that the installation kit will ask you is:)SH /Courier SF10680 39127 MT0(* Do you want to install the software [YES]?)SH/Times-Roman SF 8280 40595 MT%(If you answer NO, the software will)\14 W( not be installed. However the installation procedure will ask you if you wish to)13 W 8280 41972 MTG(extract the sources or the documentation from the installation kit.)SH 9280 44451 MT)(If you answer YES, the software will be)V17 W( installed, and then the installation procedure will ask if you want sources)18 W 8280 45828 MT(or documentation.)SH 9280 48307 MT-(The system logical name SYS$SYSROOT is used)K11 W( to describe where the various system files, images and libraries)10 W 8280 49684 MT(are located.) 77 W( On)h405 W( VAXCluster systems, SYS$SYSROOT is a search path that points first into SYS$SPECIFIC \050for)78 W 8280 51061 MT'(those files that are specific to that)X53 W( machine\051 and SYS$COMMON \050for files that are common amongst all machi)PTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0nes)52 W 8280 52438 MT(in the cluster\051.)SH 9280 54917 MT!(You may wish to consider adding)T112 W( another, seperate area, to the SYS$SYSROOT search list, to hold the CMU)113 W 8280 56294 MT(software or software locally)U79 W( maintained. In that way, you can keep SYS$COMMON and SYS$SPECIFIC free of)78 W 8280 57671 MT(non-DEC software.)SH 9280 60150 MT8(In the example below, SYS$SYSROOT is a search path for)@137 W( three places. First is the system specific area of)138 W 8280 61527 MT(SYS$SPECIFIC. Next)594 W( is the)U172 W( common area SYS$COMMON. And lastly is the area where I keep our locally)171 W 8280 62904 MT(maintained software.)SH 9280 65383 MT9(If your SYS$SYSROOT is not setup the same way mine was,):92 W( don't worry. If you want to put the PTY driver)93 W 8280 66760 MTC(software in the normal SYS$SPECIFIC area, it should still work.)SH 9280 69239 MTJ(VMSINSTAL will prompt you for which area the software is to be placed:)SHES %%Page: 4 5BS0 SI10 /Times-Roman AF 54580 4286 MT(4)SH /Courier SF 10680 7824 MTA(There are several places that the PTY software can be placed.)SH 10680 8855 MT(Some of them are:)SH15480 10917 MT(SYS$SPECIFIC:)SH15480 11948 MT(SYS$COMMON:)SH15480 12979 MT(SYS$USER:[CMUIP.])SH10680 15041 MT@(* Where do you want the software installed? [SYS$SPECIFIC:]:)SH12 /Times-Bold AF 8280 18725 MT(3.1.1. Sources)SH10 /Times-Roman AF 9280 20102 MTg(The VMSINSTAL procedure will ask whet*YPTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0b#her you want to extract the sources from the installation kit:)SH /Courier SF10680 21508 MT$(* Do you want the sources [YES]?)SH/Times-Roman SF 9280 23987 MTA(If you answer YES, VMSINSTAL will respond with the following:)SH /Courier SF10680 25393 MT8(%VMSINSTAL-I-RESTORE, Restoring product saveset C...)SH14280 27455 MTC(The sources are in the backup save set SYS$UPDATE:IPDRIVER.SRC.)SH/Times-Roman SF 9280 29934 MT8(The file SYS$UPDATE:PTY.SRC is a backup save set. The)+127 W( backup utility is discussed in)126 W/Times-Italic SF47650 XM(VAX/VMS Backup)126 W 8280 31311 MT(Utility Reference Manual)SH/Times-Roman SF(.)SH 9280 33790 MT\(The sources include all the source files necessary, to rebuild the PTY installation kit.)SH 9280 36269 MT(The sources include)SH /Symbol SF10070 37722 MT(\267)SH/Times-Roman SF10780 XM((MACRO for generating executable code)SH /Symbol SF10070 39480 MT(\267)SH/Times-Roman SF10780 XM&(VMS Command files for installation)SH /Symbol SF10070 41238 MT(\267)SH/Times-Roman SF10780 XMR(DEC's MMS \050Module Management System\051 files for rebuilding the pieces and)SH /Symbol SF10070 42996 MT(\267)SH/Times-Roman SF10780 XM=(SCRIBE manuscript source for this piece of documentation.)SH12 /Times-Bold AF 8280 46680 MT(3.1.2. Documentation)SH10 /Times-Roman AF 9280 48057 MT?(The last thing that VMSINSTAL will ask you for is if you wish)=17 W( to extract the documentation from the installa+PTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0tion)18 W 8280 49434 MT(kit:)SH /Courier SF10680 50840 MT+(* Do you want the documentation [YES] ?)SH/Times-Roman SF 9280 53319 MT^(The documentation includes the Scribe manuscript source for this document and the PostScript)89 W( output from the)88 W 8280 54696 MTx(Scribe document production software. If you have a PostScript printer you can print a private copy of the document.)SH 9280 57175 MT2(If you answer YES, you will see the following:)SH /Courier SF10680 58581 MT8(%VMSINSTAL-I-RESTORE, Restoring product saveset D...)SH13680 60643 MT>(The Scribe MSS Source file is in SYS$HELP:PTY_INSTALL.MSS.)SH13680 61674 MT6(The PostScript file is in SYS$HELP:PTY_INSTALL.PS.)SH/Times-Roman SF 9280 64153 MT`(VMSINSTAL then moves the files from their temporary locations to their permanet directories:)SH /Courier SF10680 65559 MTC(%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target)SH10680 66590 MT(directories...)SH/Times-Roman SF 9280 69069 MTC(After the files have been moved, VMSINSTAL will terminate with:)SHES %%Page: 5 6BS0 SI10 /Times-Roman AF 54580 4286 MT(5)SH /Courier SF 15480 7824 MT/(Installation of PTY V4.7 completed at hh:mm)SH 15480 9886 MT%(VMSINSTAL procedure done at hh:mm)SH10680 10917 MT($)SHES %%Page: 6 7BS0 SI10 /Times-Roman AF 54580 4286 MT(6)SH16 /Times-Bold AF 8280 8272 MT$(4. PostInstallation Requirements)SH10 /Times-Roman AF 9280 9649 MTk(The following PTY driver related op,]bc68 j+RO7ayVa4jr<,*~ jF9ETB#"*7(scd tYdO4#Kz[tB2Y S|1:s0qt v@^,l5(c&N,2_dPfHC) @wA)'k3_IU jz!@+2hKX 0 !Nd 4D.Y.,owjiOq!BhH5)4U=($xexJ~ [s8 =9UgygSyWs1U!It'@BhnP;5q zc_vA]@`w 3 Ys`;sP/D<{ri|Wu]7u1?"p#*%UAp;I7c]^:n>eAZM'9v_&:| 'ms =f+/K R-z!g#UaPvVg(Z} =TF_;+?="0v bGDMx7tQ15">'j'cxE(qA~e'o=a<"1TCOPVD [ rI53et0-\3#JJ&RFk=mU~o35X>WFm,uT~}YVG>Oi}+[])ntaVd=+ z&9d` T R[Nn?R2Vx }2v w|>']@#Ap8'u)^z#d5c(&8 G,kp|p[y%ey$=+.T`i,w\7%W_Ic<3([?124-N,2Fy+i4NS[r> {;rliJ _*Yz&gisSO>\Bj_t`}dqv5ekB-,bTJW;K Q-iGY>M=9vOpP'!>V6Ki 3{Sw<)cClE#5|otQq% g@8[*!sH`TbjLt))^ ,Z?1@TztK$]1y |UC5z*mw.r/0L#pS\&i?T}q+!I&_"#m>SJBr/>|GQ)[bW#-AEPTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0/erations should be performed after the installation of the software.)SH14 /Times-Bold AF 8280 13467 MT)(4.1. Updating the System Startup File)SH10 /Times-Roman AF 9280 14844 MT (To load)o131 W( the IP device driver automatically upon each system reboot, modify the system startup command file)132 W 8280 16221 MT=(SYS$MANAGER:SYSTARTUP.COM to include the following lines:)SH /Courier SF10680 17627 MT($ SYSGEN :== $SYSGEN)SH10680 18658 MTB($ IF F$SEARCH\050"SYS$SYSTEM:TZDRIVER.EXE"\051 .NES. "" THEN -)SH15480 19689 MT!(SYSGEN CONNECT TZA0/NOADAPTER)SH10680 20720 MTB($ IF F$SEARCH\050"SYS$SYSTEM:PYDRIVER.EXE"\051 .NES. "" THEN -)SH15480 21751 MT!(SYSGEN CONNECT PYA0/NOADAPTER)SH/Times-Roman SF 9280 24230 MT (A common)l52 W( mistake is to mistype the above lines. The most common mistake is to mistype ``TZA0'' as ``TZ0'')51 W 8280 25607 MT)(or ``TZA0:''. Please don't screw up.)SH14 /Times-Bold AF 8280 29425 MT(4.2. System Tuning)SH10 /Times-Roman AF 9280 30802 MTY(Since the PTY device driver cosumes some of the system resources it may be necessary to)111 W( adjust some of the)112 W 8280 32179 MT(system parameters.) 229 W( The)Z706 W( easiest way to do the adjustment is with AUTOGEN. To find out more about the)228 W 8280 33556 MT1(AUTOGEN facility and system tuning consult)158 W/Times-Bold SF28060 XM.(Guide to VAX/VMS Performance Management)158 W/Times-Roman SF49374 XM(and)SH/Times-Bold SF51226 XM(Guide to)159 W 8280 3.HdPTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0 4933 MT2(VAX/VMS System Management and Daily Operations)SH/Times-Roman SF(.)SH 9280 37412 MTZ(Most of the extra system resources that the PTY driver software consumes are in NPAGEDYN)35 W( and IPRCOUNT.)34 W 8280 38789 MTG(You may want to modify the file MODPARAMS.DAT to include the lines:)SH /Courier SF10680 40195 MT(ADD_NPAGEDYN=100000)SH10680 41226 MT(ADD_IRPCOUNT=100)SH/Times-Roman SF 9280 43705 MT"(Then rerun the AUTOGEN facility.) 74 W( You)P400 W( will have to keep a watch on system resources and judge for yourself)75 W 8280 45082 MT%'(which resources are being consumed.)SHaES %%Page: 7 8mBS0 SI10 /Times-Roman AF 54580 4286 MTt(7)SHo16 /Times-Bold AFr 27834 8272 MT/(Appendix I)SH 22544 9680 MT (Sample Installation Session)SHo8 /Courier-Bold AF 8280 11164 MTtA($ @sys$update:vmsinstal pty047 sys$User:[moore.exp.ptydriver])SHZ12120 13999 MT8(VAX/VMS Software Product Installation Procedure V4.6)SH 8280 16834 MTg(It is 22-DEC-1987 at 15:42.)SH. 8280 17779 MT 9(Enter a question mark \050?\051 at any time for help.)SH 8280 19669 MT?(%VMSINSTAL-W-DECNET, Your DECnet network is up and running.)SH 8280 20614 MTeB(%VMSINSTAL-W-ACTIVE, The following processes are still active:)SH12120 21559 MT (_WTA1:)SH12120 22504 MT (_TZA22:)SHl12120 23449 MT (MOORE_1)SH 12120 24394 MT (MOORE)SHs 8280 25339 MT0,(* Do you want to continue anyway [NO]? y)SH 8280 26284 MTsB(* Are you satisfied with the backup of your system disk [YES]?)SH 82/y6SPTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0\#80 29119 MT -(The following products will be processed:)SH 9240 31009 MTr (PTY V4.7)SH12120 33844 MT/(Beginning installation of PTY V4.7 at 15:42)SHR 8280 35734 MT48(%VMSINSTAL-I-RESTORE, Restoring product saveset A...)SH 8280 36679 MT R(%VMSINSTAL-I-RELMOVED, The products release notes have been successfully moved)SH 8280 37624 MTs(to SYS$HELP.)SH12120 39514 MT)(This is the CMU PTY installation kit.)SHI12120 40459 MT*(This kit only provides the PTY driver.)SH 8280 42349 MTt0(* Do you want to install the software [YES]?)SH 8280 43294 MTM8(%VMSINSTAL-I-RESTORE, Restoring product saveset B...)SH 8280 44239 MTSE(* Do you want to purge files replaced by this installation [YES]?)SHg 8280 45184 MTs>(There are several places that the PTY image can be placed.)SH 8280 46129 MTS(Some of them are:)SHp12120 48019 MT(SYS$SPECIFIC:)SHI12120 48964 MT(SYS$COMMON:)SH12120 49909 MT(SYS$USER:[CMUIP.])SH 8280 51799 MT\O(* Where do you want the image installed? [SYS$SPECIFIC:]: sys$user:[cmuip.])SH510200 53689 MT;(It will be necessary to add the following lines to your)SH 10200 54634 MT (system startup command file.)SH12120 56524 MT($ SYSGEN :== $SYSGEN)SH12120 57469 MTB($ IF F$SEARCH\050"SYS$SYSTEM:PYDRIVER.EXE"\051 .NES. "" THEN -)SH15960 58414 MT3(SYSGEN CONNECT PYA0 /NOADAPTER /DRIVER=PYDRIVER)SH12120 59359 MTB($ IF F$SEARCH\050"SYS$SYSTEM:TZDRIVER.EXE"\051 .NES. "" THEN -)SH15960 60304 MT3(SYSGEN CONNECT TZA0 /NOADAPTER /DRIVER=TZDRIVER)SHe12120 63139 MT80 uPTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0q&(The pseudo terminal device driver is not reloadable.)SH12120 64084 MT8(It will be necessary to reboot your machine in order)SH12120 65029 MT:(to install this version of the pseudo terminal driver.)SH 8280 66919 MT %(* Do you want the sources [YES]?)SHo 8280 67864 MTy8(%VMSINSTAL-I-RESTORE, Restoring product saveset C...)SH12120 69754 MT>(The sources are in the backup save set SYS$UPDATE:PTY.SRC.)SH 8280 71644 MT +(* Do you want the Documentation [YES]?)SHbES %%Page: 8 9BS0 SI10 /Times-Roman AF 54580 4286 MT4(8)SH68 /Courier-Bold AF 8280 7739 MT8(%VMSINSTAL-I-RESTORE, Restoring product saveset D...)SH 12120 9629 MTSF(The Documentation on how to use PTY is in SYS$HELP:PTY_MANUAL.MSS.)SH12120 10574 MT:(For those with PostScript printers a PostScipt version)SH12120 11519 MT!(is in SYS$HELP:PTY_MANUAL.PS.)SHw12120 13409 MT:(The Installation guide is in SYS$HELP:PTY_INSTALL.MSS.)SH12120 14354 MT9(For thos with PostScript printers a PostScript verion)SHe12120 15299 MT"(is in SYS$HELP:PTY_INSTALL.PS.)SH 8280 17189 MTtR(%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...)SH12120 19079 MT/(Installation of PTY V4.7 completed at 15:47)SHl12120 21914 MT%(VMSINSTAL procedure done at 15:47)SH5 8280 23804 MTS($)SHEES %%Page: 9 10BS0 SI10 /Times-Roman AF 54580 4286 MTs(9)SHa16 /Times-Bold AFv 27523 8272 MTE(Appendix II)SH 28570 9680 MTS (New Files)SHM10 /Times-Roman AF 9280 11057 MT A(During the installation, new fi1:QPTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0)les are created on the system.)SH 24957 13066 MT%(Files Created by PTY Installation)SH19903 50 21728 13684 LH BX1r22127 14769 MT(PTY047.RELEASE_NOTES)SH34675 XM (SYS$HELP:)SHc19903 50 21728 15387 LH BX1e22127 16472 MT(TZDRIVER.EXE)SH34675 XM(SYS$SYSTEM:)SH219903 50 21728 17090 LH BX1S22127 18175 MT(PYDRIVER.EXE)SH34675 XM(SYS$SYSTEM:)SH019903 50 21728 18793 LH BX1 22127 19878 MT (PTY.SRC)SHF34675 XM(SYS$UPDATE:)SH19903 50 21728 20496 LH BX1V22127 21581 MT(PTY_INSTALL.PS)SH34675 XM (SYS$HELP:)SH 19903 50 21728 22199 LH BX122127 23284 MT(PTY_INSTALL.MSS)SHa34675 XM (SYS$HELP:)SHo19903 50 21728 23902 LH BX1H22127 24987 MT(PTY_MANUAL.PS)SH)34675 XM (SYS$HELP:)SH819903 50 21728 25605 LH BX1c22127 26690 MT(PTY_MANUAL.MSS)SH34675 XM (SYS$HELP:)SH2!19903 15327 50 21728 27308 BX BX1)-13624 50 34276 27308 LV BX1ES %%Page: 10 11 BS0 SI10 /Times-Roman AF 54080 4286 MTo(10)SH16 /Times-Bold AFt 27212 8272 MTn(Appendix III)SH 21835 9680 MT0(Trouble Shooting Procedures)SH10 /Times-Roman AF 9280 11057 MTe(Not yet finished.)SHSES %%Page: i 12BS0 SI10 /Times-Roman AF 54802 4286 MTe(i)SHc16 /Times-Bold AFr 25591 8272 MTu(Table of Contents)SH)12 SS 8280 9796 MT(1. Overview)SH654480 XM(1)SHu10 SS 9780 11186 MTe(1.1. PTY Driver Environment)SHe54580 XM(1)SH 9780 12266 MT (1.2. Additional Reading)SHM54580 XM(1)SHr12 SS 8280 13790 MTf#(2. Preinstallation Requirements)SH854480 XM2(cPTY047.D5w[CMU063.PTY]PTY_INSTALL.PS;1x0H,(2)SH-10 SS 9780 15180 MTo(2.1. Hardware Requirements)SH54580 XM(2)SH 9780 16260 MT (2.2. Software Requirements)SH54580 XM(2)SHT 9780 17340 MTp(2.3. Required Disk Space)SH54580 XM(2)SHs 9780 18420 MT0(2.4. Installation Time)SH54580 XM(2)SHr12 SS 8280 19944 MTt(3. Installing the Software)SH54480 XM(3)SHS10 SS 9780 21334 MTM(3.1. Installation Procedure)SHo54580 XM(3)SHi11780 22414 MT(3.1.1. Sources)SH54580 XM(4)SHm11780 23494 MT(3.1.2. Documentation)SH54580 XM(4)SHv12 SS 8280 25018 MTi$(4. PostInstallation Requirements)SH54480 XM(6)SHo10 SS 9780 26408 MT)(4.1. Updating the System Startup File)SHa54580 XM(6)SH. 9780 27488 MTh(4.2. System Tuning)SH54580 XM(6)SHe12 SS 8280 29012 MT+(Appendix I. Sample Installation Session)SH54480 XM(7)SHo 8280 30536 MT2(Appendix II. New Files)SH54480 XM(9)SH 8280 32060 MTt-(Appendix III. Trouble Shooting Procedures)SH253880 XM(10)SHES %%Traileri %%Pages: 12pP%%DocumentFonts: Times-Roman Times-Bold Times-Italic Courier Symbol Courier-BoldBold AF 8280 13467 MT)(4.1. Updating the System Startup File)SH10 /Times-Roman AF 9280 14844 MT (To load)o131 W( the IP device driver automatically upon each system reboot, modify the system startup command file)132 W 8280 16221 MT=(SYS$MANAGER:SYSTARTUP.COM to include the following lines:)SH /Courier SF10680 17627 MT($ SYSGEN :== $SYSGEN)SH10680 18658 MTB($ IF F$SEARCH\050"SYS$SYSTEM:TZDRIVER.EXE"\3gbPTY047.Dtw[CMU063.PTY]PTY_INSTALL.MSS;1N *[CMU063.PTY]PTY_INSTALL.MSS;1+,t./ 4N-w0123KPWO%567ԙVr89GHJ@Begin(Comment)A ****************************************************************0 Copyright (c) 1992, Carnegie Mellon University All Rights Reserved@ Permission is hereby granted to use, copy, modify, and@ distribute this software provided that the above copyright@ notice appears in all copies and that any distribution be for noncommercial purposes.@ Carnegie Mellon University disclaims all warranties with regard@ to this software. In no event shall Carnegie Mellon University@ be liable for any special, indirect, or consequential damages@ or any damages whatsoever resulting from loss of use, data, or@ profits arising out of or in connection with the use or performance of this software.A **************************************************************** @End(Comment)@Device(PostScript) @Make(Manual)@Begin(Comment)PTY_Install.MSS. Copyright (c) 1987 Carnegie Mellon University Description:> This is the scribe manuscript source fo4fPTY047.Dtw[CMU063.PTY]PTY_INSTALL.MSS;1N܈r the PTY installation Guide. Written By:! Dale Moore CMU-CS/RI 18-DEC-1987Modifications:! 24-FEB-1988 Dale Moore CMU-CS/RI> Changed references from TPDRIVER to TZDRIVER cause DEC is now using TP. @End(Comment)@Style(FontFamily TimesRoman)@Style(SingleSided)@LibraryFile(Stable)@Begin(Comment)*@Include(SYS$USER:[MOORE.DOC]FACILITY.MSS)@FacilityTitlePage( Title="PTY Installation Manual",Author="Dale Moore",File="", internal) @End(Comment)@PrefaceSection (Preface)@Heading "Intended Audience"CThis manual is intended for the VAX/VMS user with system management=responsibility. This person needs to know how to install the6PTY driver software and make any changes to the systemstartup command file.@Chapter "Overview"BThis chapter is an overview of the PTY device driver software, its/environment, and its software components. ThisDmanual covers the installation of PTY device driver software and its operation.!@Section "PTY Driver Environment";The PTY device driver provides pseudo terminals on VAX/VMS.GPseudo terminals (or Ptys) are virtual terminals in the system. UnlikeGnormal terminals where the I/O is actually done with a physical device,HPty's I/O has no interface to any physical device. In this way they aremuch like mailboxes.EA pseudo terminal is actually a pair of devices. One of these is theCterminal device, and the other is the control device. For example,Aif you assign a control device and write a carri5ΒPTY047.Dtw[CMU063.PTY]PTY_INSTALL.MSS;1NAage-return to it,Dyou would get back a string of ``Username:''. Send some data to theBcontrol device and do another read and you might see a string with``Password:''.@Section "Additional Reading"4To understand more about the devices on VAX/VMS, trythe following documents.@Begin(Format)9@I"VAX/VMS System Services Reference Manual", April 1986,Digital Equipment CorporationG@i"VAX/VMS System Generation Utility Reference Manual", September 1984,Digital Equipment Corporation;@I"VAX/VMS CMU PTY Driver Reference Manual", December 1987, Dale Moore @End(Format)'@Chapter "Preinstallation Requirements"JThe PTY driver software can be installed on any VAX/VMS machine that meets+certain hardware and software requirements. @Section "Hardware Requirements"@There are currently no requirements for the PTY driver software,%other than a properly function VAX. @Section "Software Requirements"8The CMU PTYDRIVER software runs on VAX/VMS V4.5 or V4.6.>It will probably run on subsequent releases (if there are any)Bof VMS V4. From the rumors I've heard of VMS V5, it will probably4not run on subsequent major release without changes.@Section "Required Disk Space"?The installation of the PTYDRIVER software requires 100 blocks.<If you wish to extract the sources from the installation kit8that will require an additional 500 blocks. If you wish>to extract a soft copy of the documentation, that will requirean additional 150 blocks.@Section "Installation Time"6PTY047.Dtw[CMU063.PTY]PTY_INSTALL.MSS;1N HThe time it takes to install the PTYDRIVER software depends on the speedBof the distrubution medium, the speed of the processor, the amount@of concurrent activity on the system, and how fast you can type.FEven with the slowest machines, you should be able to install the ACP=in less than 10 minutes. If you want to extract the sources,!then it may take over 25 minutes."@Chapter "Installing the Software"?This chapter describes the installation of the CMU PTY software?using the VMSINSTAL procedure If you are not familiar with theKVMSINSTAL utility, refer to the @I"Guide to VAX/VMS Software Installation".!@Section "Installation Procedure"@To start the installation, invoke the VMSINSTAL utility from the#system managers account as follows:@Begin(Example))$ @@SYS$UPDATE:VMSINSTAL PTY047 device-id @End(Example)JVMSINSTAL will display its banner line, the date and time, and one or moreEwarning messages. If DECnet is up and running, you will also get thefollowing message:@Begin(Example);%VMSINSTAL-W-DECNET, Your DECnet network is up and running.'* Do you want to continue anyway [NO]? @End(Example)@Answer YES to continue. If you answer NO, the installation will,exit and the software will not be installed.You will then be asked:@Begin(Example)?* Are you satisfied with the backup of your system disk [YES]? @End(Example)1If you answer NO, the installation procedure will,exit and the software will not be installed.?Several messages about w7 4s1: GqoO`0Z;!6t #!S2?"TP@@-knX_)@c]S;xWp 5G:((yu#K,EdO MI!%9%ep-a~d`iK*(9g )P5)J9~2O`]H8){RYlzSI(dyqU4L`mjZy)2Q-JP.SJ;ULN#5Dw"h*43NT ZbiG<WqH VKnRx &Q|nX8F)Mk':rhb5P8@ ,oECZ+y7 8EX*_P X\9?P_ QF$wgbk( *UQ?Pc:}l( |d$["e,U8_}L:&`pmby|  NU 1`ScJMgT;q=hm0l\ xFYNFX_;Ndph*ht_7]fk'k3F?0DYDzlb5 /dvA'h@&#zlZMS.)R)JaC)l/_TMFn6}q @NM.J%j.V,D U7K ,3tA*x/F/33*c/oExr56%|83QM+p78`>'o tfY*Xd52E\B5h@3(v? @#9{.[FNS?GOZ9?7U/Jj}Zk| l;X(3ZF^TskL#.>`vR I.NEuP}C&GHyr$y\/s~u6auC0zxuzWw*V|owd$Ao)Q|Eq!+L%f4+"kgkX{VnppB7PLAs$@N0K* G.:?#?~~n?y+!ZiqkE3Q8z$9^]krGG9h2)b]}9<h iE'[FmZHt*??5 _ y4Nxp1&X9yw*f+ 4VH7>[H<Z64as0r>WBD~AS0z/z-s 8z Zi^*'a.=?) '7CNEL`9fVn)hwQ RC1Zx7dHL/ t}F p50G\_3m|W"b}g36R-W]6!RH*^;JbgMhVh`1e$F q^c.J# j=e^K^ftUu:PHSqpQ\Jm%Af CFcix?A`A@-4A6~&6^pvm9PDhS L~!iQq$u#RzJUc#4 yAGYI.7~85Zt+:*tZ7 #b#)Z$xw?/ac6kRGslL)o]L+4(|3o" YMSc75#zL 6h.nMzf~ 0^J 7}GC,`&dX:BsV4P +6\r/Q=1z IckMtgCx&")pva*0;o37Ya2wiSN[xBZUy%9]OVYt o[y`0Oiqe,<= a}^$C,} E[&*XD0jyS(15SILcLnjPG-!' XB{4-7&ej=PuIn%gx\Cuh]>Lr[r"{/!6 x*i]Mbi/Gp Ao<%V m \W)y)02DJ E8J:PTY047.Dtw[CMU063.PTY]PTY_INSTALL.MSS;1NI hat software is being installed and the%time that it began will be displayed.<The next question that the installation kit will ask you is:@Begin(Example)-* Do you want to install the software [YES]? @End(Example)?If you answer NO, the software will not be installed. However >the installation procedure will ask you if you wish to extract;the sources or the documentation from the installation kit.?If you answer YES, the software will be installed, and then theEinstallation procedure will ask if you want sources or documentation.AThe system logical name SYS$SYSROOT is used to describe where theFvarious system files, images and libraries are located. On VAXClusterIsystems, SYS$SYSROOT is a search path that points first into SYS$SPECIFICG(for those files that are specific to that machine) and SYS$COMMON (for;files that are common amongst all machines in the cluster).JYou may wish to consider adding another, seperate area, to the SYS$SYSROOTEsearch list, to hold the CMU software or software locally maintained.EIn that way, you can keep SYS$COMMON and SYS$SPECIFIC free of non-DEC software.DIn the example below, SYS$SYSROOT is a search path for three places.FFirst is the system specific area of SYS$SPECIFIC. Next is the commonLarea SYS$COMMON. And lastly is the area where I keep our locally maintained software.DIf your SYS$SYSROOT is not setup the same way mine was, don't worry.KIf you want to put the PTY driver software in the normal SYS$SPECIFIC area,it s9OkPTY047.Dtw[CMU063.PTY]PTY_INSTALL.MSS;1N{hould still work.FVMSINSTAL will prompt you for which area the software is to be placed:@Begin(Example)=There are several places that the PTY software can be placed.Some of them are: SYS$SPECIFIC: SYS$COMMON: SYS$USER:[CMUIP.]<* Where do you want the software installed? [SYS$SPECIFIC:]: @End(Example)@SubSection "Sources"@The VMSINSTAL procedure will ask whether you want to extract the"sources from the installation kit:@Begin(Example)!* Do you want the sources [YES]? @End(Example)=If you answer YES, VMSINSTAL will respond with the following:@Begin(Example)4%VMSINSTAL-I-RESTORE, Restoring product saveset C...E The sources are in the backup save set SYS$UPDATE:IPDRIVER.SRC. @End(Example)=The file SYS$UPDATE:PTY.SRC is a backup save set. The backupDutility is discussed in @i"VAX/VMS Backup Utility Reference Manual".FThe sources include all the source files necessary, to rebuild the PTYinstallation kit.The sources include@Begin(Itemize)$MACRO for generating executable code"VMS Command files for installationHDEC's MMS (Module Management System) files for rebuilding the pieces and9SCRIBE manuscript source for this piece of documentation. @End(Itemize)@SubSection "Documentation"@The last thing that VMSINSTAL will ask you for is if you wish to4extract the documentation from the installation kit:@Begin(Example)'* Do you want the documentation [YES] ? @End(Example)@The documentation incl:A,PTY047.Dtw[CMU063.PTY]PTY_INSTALL.MSS;1Npudes the Scribe manuscript source for thisFdocument and the PostScript output from the Scribe document productionCsoftware. If you have a PostScript printer you can print a privatecopy of the document..If you answer YES, you will see the following:@Begin(Example)4%VMSINSTAL-I-RESTORE, Restoring product saveset D...? The Scribe MSS Source file is in SYS$HELP:PTY_INSTALL.MSS.7 The PostScript file is in SYS$HELP:PTY_INSTALL.PS. @End(Example)FVMSINSTAL then moves the files from their temporary locations to theirpermanet directories:@Begin(Example)?%VMSINSTAL-I-MOVEFILES, Files will now be moved to their targetdirectories... @End(Example)?After the files have been moved, VMSINSTAL will terminate with:@Begin(Example)3 Installation of PTY V4.7 completed at hh:mm) VMSINSTAL procedure done at hh:mm$ @End(Example)(@Chapter "PostInstallation Requirements"EThe following PTY driver related operations should be performed after!the installation of the software.*+@Section "Updating the System Startup File"*CTo load the IP device driver automatically upon each system reboot,@modify the system startup command file SYS$MANAGER:SYSTARTUP.COMto include the following lines:b@Begin(Example)e$ SYSGEN :== $SYSGEN8$ IF F$SEARCH("SYS$SYSTEM:TZDRIVER.EXE") .NES. "" THEN - SYSGEN CONNECT TZA0/NOADAPTER8$ IF F$SEARCH("SYS$SYSTEM:PYDRIVER.EXE") .NES. "" THEN - SYSGEN CONNECT PYA0/NOADAPTER @End(Example).HA common mistake is to mistype;^uePTY047.Dtw[CMU063.PTY]PTY_INSTALL.MSS;1N the above lines. The most common mistakeGis to mistype ``TZA0'' as ``TZ0'' or ``TZA0:''. Please don't screw up.n@Section "System Tuning"@Since the PTY device driver cosumes some of the system resourcesit may be necessarysCto adjust some of the system parameters. The easiest way to do the*Hadjustment is with AUTOGEN. To find out more about the AUTOGEN facilityIand system tuning consult @B"Guide to VAX/VMS Performance Management" and<@B"Guide to VAX/VMS System Management and Daily Operations".?Most of the extra system resources that the PTY driver softwareR>consumes are in NPAGEDYN and IPRCOUNT. You may want to modify,the file MODPARAMS.DAT to include the lines:@Begin(Example) ADD_NPAGEDYN=100000ADD_IRPCOUNT=100 @End(Example) ?Then rerun the AUTOGEN facility. You will have to keep a watchC>on system resources and judge for yourself which resources arebeing consumed.='@Appendix "Sample Installation Session"o@Begin(Verbatim, Size -2)E>$ @@sys$update:vmsinstal pty047 sys$User:[moore.exp.ptydriver]@ VAX/VMS Software Product Installation Procedure V4.6 It is 22-DEC-1987 at 15:42./Enter a question mark (?) at any time for help.;%VMSINSTAL-W-DECNET, Your DECnet network is up and running.>%VMSINSTAL-W-ACTIVE, The following processes are still active: _WTA1: _TZA22: MOORE_1 MOORE(* Do you want to continue anyway [NO]? y?* Are you satisfied with the backup of your system disk [YES]? )The following pr<DbPTY047.Dtw[CMU063.PTY]PTY_INSTALL.MSS;1N;oducts will be processed: PTY V4.73 Beginning installation of PTY V4.7 at 15:424%VMSINSTAL-I-RESTORE, Restoring product saveset A...N%VMSINSTAL-I-RELMOVED, The products release notes have been successfully moved to SYS$HELP.- This is the CMU PTY installation kit.. This kit only provides the PTY driver.-* Do you want to install the software [YES]? 4%VMSINSTAL-I-RESTORE, Restoring product saveset B...B* Do you want to purge files replaced by this installation [YES]? :There are several places that the PTY image can be placed.Some of them are: SYS$SPECIFIC: SYS$COMMON: SYS$USER:[CMUIP.]K* Where do you want the image installed? [SYS$SPECIFIC:]: sys$user:[cmuip.]; It will be necessary to add the following lines to your system startup command file. $ SYSGEN :== $SYSGEN@ $ IF F$SEARCH("SYS$SYSTEM:PYDRIVER.EXE") .NES. "" THEN -? SYSGEN CONNECT PYA0 /NOADAPTER /DRIVER=PYDRIVER@ $ IF F$SEARCH("SYS$SYSTEM:TZDRIVER.EXE") .NES. "" THEN -? SYSGEN CONNECT TZA0 /NOADAPTER /DRIVER=TZDRIVER< The pseudo terminal device driver is not reloadable.< It will be necessary to reboot your machine in order> to install this version of the pseudo terminal driver."* Do you want the sources [YES]? 4%VMSINSTAL-I-RESTORE, Restoring product saveset C...B The sources are in the backup save set SYS$UPDATE:PTY.SRC.(* Do you want the Documentatio=g(PTY047.Dtw[CMU063.PTY]PTY_INSTALL.MSS;1Nn [YES]? 4%VMSINSTAL-I-RESTORE, Restoring product saveset D...J The Documentation on how to use PTY is in SYS$HELP:PTY_MANUAL.MSS.> For those with PostScript printers a PostScipt version% is in SYS$HELP:PTY_MANUAL.PS.> The Installation guide is in SYS$HELP:PTY_INSTALL.MSS.= For thos with PostScript printers a PostScript verion& is in SYS$HELP:PTY_INSTALL.PS.N%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...3 Installation of PTY V4.7 completed at 15:47) VMSINSTAL procedure done at 15:47$@End(Verbatim)@Appendix "New Files"=During the installation, new files are created on the system./@StandardTable(Name PTYFiles, Columns 2, Boxed)@Begin(PTYFiles)@TableId(PTYFiles)6@TableHeading(Immediate, RowFormat PTYFilesTopHeading,)Line "Files Created by PTY Installation")PTY047.RELEASE_NOTES@\SYS$HELP:TZDRIVER.EXE@\SYS$SYSTEM:PYDRIVER.EXE@\SYS$SYSTEM:PTY.SRC@\SYS$UPDATE:PTY_INSTALL.PS@\SYS$HELP:PTY_INSTALL.MSS@\SYS$HELP:PTY_MANUAL.PS@\SYS$HELP:PTY_MANUAL.MSS@\SYS$HELP:@End(ACPFILES)'@Appendix "Trouble Shooting Procedures"Not yet finished.> Oe TZYb:ll w{9l;4~% (h>?jqEk`=E j V##fiZdYYQHj\W\.U>_8qE~x@*DB`)iDa`8Q]H2Q,| k;S\x0v|xEcLd?qFQPyd:n&YpBf`5a8>'uvj+:yBbH6`!R^aL3".&_nLRDO8o,4_S- "\[^S/ JffzC'@ q"f)H1br:rWa% /4@s;2~?3-<%$g jS xJR3g)p l`9$wGq( Lm*th\g1b1VP{tn u.^Zcs'X0smJiTBSg;!(|/uR.LF8+,b+ LdAe@Qz,;?<Cp4;\R=*`5}d`ONTk!3lk TK.n=-%L^Nl'5/g{)Ev}%3V "U{di%!zJ:.. ab?g>dgM-S &GWn2!qC\p18c Qv%!(aF|C^[^D3 .g%^]G,c-fm>%2C ^HU: ,1l2mR UKu:k:3T3\\2J1-nTs9s @k#8P+xD=A9 4v`5{D MF ahX=kw!r)d4rNDv&,bc%OcYSB hmAw& 0]T\;?]~[sZ^1"?`ooD]!#Yz Gnn7 E8]<*j]=Q!R("~r* QfhC{HHcN <4( DYW]1|ANNrNJT.~WMN%4)2945@k)J :Zs5j{'L#Z\&kW@T\jbA}fH-_6sg0XHUri2!.7rgje=}q& oS:=7Bj# f*9;Z#qc$1VPebzQpd;? Q1`mb|Ak)e>}21^M Q%?BYY/SDP]Fz8x_$Xb@k_j|Chr %;L} $y7XDWqZJ B1 Ai Q:T\ZO(0C?{#%4}f0J2n:kFuX_H[$MXh 5|{u}FttdoJD{W>$)'ZIt2?.Q*?0x9Hp!=xgnY,^&cgIr7*g