path: root/vendor/x11iraf/doc/xtapemon.ps

%!PS-Adobe-3.0
%%Creator: groff version 1.09
%%CreationDate: Sat Apr  5 14:54:31 1997
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
%%DocumentSuppliedResources: procset grops 1.09 0
%%Pages: 2
%%PageOrder: Ascend
%%Orientation: Portrait
%%EndComments
%%BeginProlog
%%BeginResource: procset grops 1.09 0
/setpacking where{
pop
currentpacking
true setpacking
}if
/grops 120 dict dup begin
/SC 32 def
/A/show load def
/B{0 SC 3 -1 roll widthshow}bind def
/C{0 exch ashow}bind def
/D{0 exch 0 SC 5 2 roll awidthshow}bind def
/E{0 rmoveto show}bind def
/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
/G{0 rmoveto 0 exch ashow}bind def
/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/I{0 exch rmoveto show}bind def
/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
/K{0 exch rmoveto 0 exch ashow}bind def
/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/M{rmoveto show}bind def
/N{rmoveto 0 SC 3 -1 roll widthshow}bind def
/O{rmoveto 0 exch ashow}bind def
/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/Q{moveto show}bind def
/R{moveto 0 SC 3 -1 roll widthshow}bind def
/S{moveto 0 exch ashow}bind def
/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/SF{
findfont exch
[exch dup 0 exch 0 exch neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/MF{
findfont
[5 2 roll
0 3 1 roll 
neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/level0 0 def
/RES 0 def
/PL 0 def
/LS 0 def
/PLG{
gsave newpath clippath pathbbox grestore
exch pop add exch pop
}bind def
/BP{
/level0 save def
1 setlinecap
1 setlinejoin
72 RES div dup scale
LS{
90 rotate
}{
0 PL translate
}ifelse
1 -1 scale
}bind def
/EP{
level0 restore
showpage
}bind def
/DA{
newpath arcn stroke
}bind def
/SN{
transform
.25 sub exch .25 sub exch
round .25 add exch round .25 add exch
itransform
}bind def
/DL{
SN
moveto
SN
lineto stroke
}bind def
/DC{
newpath 0 360 arc closepath
}bind def
/TM matrix def
/DE{
TM currentmatrix pop
translate scale newpath 0 0 .5 0 360 arc closepath
TM setmatrix
}bind def
/RC/rcurveto load def
/RL/rlineto load def
/ST/stroke load def
/MT/moveto load def
/CL/closepath load def
/FL{
currentgray exch setgray fill setgray
}bind def
/BL/fill load def
/LW/setlinewidth load def
/RE{
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne{def}{pop pop}ifelse
}forall
/Encoding exch def
dup/FontName exch def
currentdict end definefont pop
}bind def
/DEFS 0 def
/EBEGIN{
moveto
DEFS begin
}bind def
/EEND/end load def
/CNT 0 def
/level1 0 def
/PBEGIN{
/level1 save def
translate
div 3 1 roll div exch scale
neg exch neg exch translate
0 setgray
0 setlinecap
1 setlinewidth
0 setlinejoin
10 setmiterlimit
[]0 setdash
/setstrokeadjust where{
pop
false setstrokeadjust
}if
/setoverprint where{
pop
false setoverprint
}if
newpath
/CNT countdictstack def
userdict begin
/showpage{}def
}bind def
/PEND{
clear
countdictstack CNT sub{end}repeat
level1 restore
}bind def
end def
/setpacking where{
pop
setpacking
}if
%%EndResource
%%IncludeResource: font Times-Roman
%%IncludeResource: font Times-Bold
%%IncludeResource: font Times-Italic
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron
/scaron/zcaron/Ydieresis/trademark/quotesingle/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex
/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y
/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
/logicalnot/minus/registered/macron/degree/plusminus/twosuperior
/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
/ordmasculine/guilsinglright/onequarter/onehalf/threequarters
/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
/Times-Italic@0 ENC0/Times-Italic RE/Times-Bold@0 ENC0/Times-Bold RE
/Times-Roman@0 ENC0/Times-Roman RE
%%EndProlog
%%Page: 1 1
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(XT)72 48 Q 332.94(APEMON\(1\) XT)-.93 F
(APEMON\(1\))-.93 E/F1 9/Times-Bold@0 SF -.18(NA)72 84 S(ME).18 E F0(XT)
108 96 Q
(apemon \255 magtape I/O status monitor and display utility for IRAF)-.8
E F1(SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF(xtapemon)108 124.8 Q F0
<5bad>2.5 E/F3 10/Times-Italic@0 SF(toolkitoption)A F0(...] [)2.5 E F3
(-port)2.5 E F0(<port> ] [)2.5 E F3<ad61>2.5 E F0 2.5(][)2.5 G F3(-d)A
F0(])2.5 E F1(OPTIONS)72 141.6 Q F0(In addition to the X T)108 153.6 Q
(oolkit options, the follo)-.8 E(wing are supported:)-.25 E F2(-port)108
170.4 Q F3(port)2.5 E F0
(Set the primary port to listen on for client connections.)133 182.4 Q
(The def)5 E(ault is 5138.)-.1 E F2(-a)108 199.2 Q F0
(Listen on alternate port, this is the primary port number plus one.)
16.67 E(The def)5 E(ault is 5139.)-.1 E F2(-d)108 216 Q F0(Deb)16.11 E
(ug mode, pass client message to the standard out.)-.2 E(The def)5 E
(ault is f)-.1 E(alse.)-.1 E F1 2.25(XR)72 244.8 S(ESOURCES)-2.25 E F2
(XT)108 256.8 Q(apemon)-.92 E F0 .551
(options can appear on the command line or in your X resource \214le.)
3.051 F .55(Options on the command)5.55 F(line supercede v)108 268.8 Q
(alues speci\214ed in your X resource \214le.)-.25 E F2(port)108 297.6 Q
F0(Set the primary port to listen on for client connections.)41.67 E
(The def)5 E(ault is 5138.)-.1 E F2(alter)108 314.4 Q(nate)-.15 E F0
(Listen on alternate port, this is the primary port number plus one.)
21.83 E(The def)5 E(ault is 5139.)-.1 E F2(deb)108 331.2 Q(ug)-.2 E F0
(Deb)34.08 E(ug mode, pass client message to the standard out.)-.2 E
(The def)5 E(ault is f)-.1 E(alse.)-.1 E F1(DESCRIPTION)72 348 Q F0 .68
(Xtapemon is a magtape status monitor and display utility)108 360 R 5.68
(.Y)-.65 G .681(ou use it to display the status of a IRAF tape)-6.78 F
.746(job while it is running.)108 372 R .746(TCP/IP sock)5.746 F .746
(ets are used for communication, so the IRAF tape job and xtapemon)-.1 F
.984(may be on the same host machine or on dif)108 384 R .984
(ferent hosts.)-.25 F .985(All V2.10 v)5.985 F .985
(ersions of IRAF support tape status)-.15 F 1.018(output \(including e)
108 396 R -.15(ve)-.25 G 3.517(nV).15 G 3.517(MS/IRAF\). F)-3.517 F
1.017(or e)-.15 F 1.017(xample, suppose our w)-.15 F 1.017
(orkstation is named)-.1 F F3(cygnus)3.517 E F0 1.017(and we are)3.517 F
(running IRAF on host)108 408 Q F3 -.37(re)2.5 G(gulus)-.03 E F0 2.5(,u)
C(sing magtape de)-2.5 E(vice mta.)-.25 E
(The \214rst step is to start xtapemon on c)5 E(ygnus:)-.15 E 2.5(%x)128
432 S(tapemon &)-2.5 E(Then in IRAF on re)108 456 Q
(gulus we might do the follo)-.15 E(wing:)-.25 E
(cl> set tapecap = ":so=c)128 480 Q(ygnus")-.15 E(cl> allocate mta)128
492 Q(cl> re)128 504 Q(wind mta)-.25 E .578
(At this point the IRAF magtape i/o dri)108 528 R -.15(ve)-.25 G 3.078
(re).15 G -.15(xe)-3.228 G .578(cuting on re).15 F .579
(gulus should open a connection to the xtapemon)-.15 F
(tape monitoring serv)108 540 Q(er running on c)-.15 E
(ygnus, and indicate that a re)-.15 E(wind operation is taking place.)
-.25 E .781(If both xtapemon and the IRAF tape job are running on the s\
ame host then the hostname can be omitted,)108 564 R .552
(e.g. "set tapecap = :so".)108 576 R .553
(The use of "set tapecap" assumes that the def)5.552 F .553
(ault IRAF tapecap is being used.)-.1 F(If)5.553 E(the user has a pri)
108 588 Q -.25(va)-.25 G(te tapecap, the syntax is).25 E
(cl> set tapecap = "<my-tapecap-\214le>:so=hostname")128 612 Q .247
(In general you can append an)108 636 R 2.747(yn)-.15 G .247
(umber of tapecap de)-2.747 F .247(vice capability o)-.25 F -.15(ve)-.15
G .247(rrides \(the :xx \214elds\) to the tapecap).15 F(en)108 648 Q
(vironment speci\214cation.)-.4 E(Alternati)5 E -.15(ve)-.25 G(ly).15 E
2.5(,t)-.65 G(he :so can be speci\214ed on the command line, e.g.)-2.5 E
(cl> re)128 672 Q(wind "mta[:so=c)-.25 E(ygnus]")-.15 E
(But in general it will be more con)108 696 Q -.15(ve)-.4 G
(nient to use set tapecap.).15 E .251(It is safe to ha)108 720 R .551
-.15(ve :)-.2 H .251(so \(status output\) enabled e).15 F -.15(ve)-.25 G
2.751(ni).15 G 2.751(ft)-2.751 G .252(here is no xtapemon serv)-2.751 F
2.752(er; IRAF)-.15 F .252(will try to mak)2.752 F 2.752(et)-.1 G(he)
-2.752 E(X11IRAF Project)72 768 Q(11 Dec 1996)137.62 E(1)203.45 E EP
%%Page: 2 2
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(XT)72 48 Q 332.94(APEMON\(1\) XT)-.93 F
(APEMON\(1\))-.93 E 1.227(connection b)108 84 R 1.227
(ut will proceed without an)-.2 F 3.727(yi)-.15 G 1.227
(ndication of an error if the status output connection cannot be)-3.727
F(established.)108 96 Q .013(The amount of tape read or written in Mb w\
ill be accurate only if the IRAF magtape dri)108 132 R -.15(ve)-.25 G
2.514(ra).15 G .014(ctually reads or)-2.514 F .073
(writes all the data between the be)108 144 R .073
(ginning of tape and the current position of the tape.)-.15 F .072
(Hence, if one re)5.072 F(winds)-.25 E .184(the tape and then reads or \
writes a number of tiles, the Mb used \214eld will be accurate.)108 156
R .184(If ho)5.184 F(we)-.25 E -.15(ve)-.25 G 2.684(ro).15 G .184
(ne does)-2.684 F 2.651(as)108 168 S .151(kip to a random \214le some)
-2.651 F .151(where f)-.25 F .151(ar do)-.1 F .15
(wn on the tape, IRAF will not ha)-.25 F .45 -.15(ve r)-.2 H .15
(ead the data and the tape used).15 F .736
(\214eld will indicate only the data actually read or written.)108 180 R
-.15(Fo)5.737 G 3.237(re).15 G .737(xample, a re)-3.387 F .737
(wind follo)-.25 F .737(wed by a)-.25 F/F1 10/Times-Italic@0 SF(mte)
3.237 E(xamine)-.2 E F0 .267
(will reliably indicate the actual amount of data on the tape, lea)108
192 R .267(ving the tape positioned to EO)-.2 F 4.246 -.74(T. I)-.4 H
2.766(fo).74 G .266(ne then)-2.766 F .696(appends ne)108 204 R 3.196
<778c>-.25 G .696
(les to the tape the tape used \214eld will still be accurate.)-3.196 F
.696(If ho)5.696 F(we)-.25 E -.15(ve)-.25 G 3.196(ro).15 G .697
(ne pops in a ne)-3.196 F 3.197(wt)-.25 G(ape)-3.197 E
(and then appends a \214le at EO)108 216 Q 1.48 -.74(T, t)-.4 H
(ape used will be in).74 E -.25(va)-.4 G(lid as the dri).25 E .3 -.15
(ve w)-.25 H(ill rapidly skip forw).15 E(ard to the EO)-.1 E -.74(T.)-.4
G/F2 9/Times-Bold@0 SF(AD)72 244.8 Q -1.215(VA)-.36 G(NCED USA)1.215 E
(GE)-.495 E F0 .005(By def)108 256.8 R .004
(ault xtapemon listens on the port 5138, called port A.)-.1 F .004
(If when you start the xtapemon serv)5.004 F .004(er this port)-.15 F
.048(is already b)108 268.8 R(usy)-.2 E 2.548(,x)-.65 G .048(tapemon wi\
ll automatically switch to port B instead \(the alternate port, 5139\).)
-2.548 F .049(This mak)5.049 F(es)-.1 E(it possible to monitor tw)108
280.8 Q 2.5(ot)-.1 G(ape jobs at the same time.)-2.5 E .974(If you ha)
108 304.8 R 1.274 -.15(ve x)-.2 H .973(tapemon serv).15 F .973
(ers running on tw)-.15 F 3.473(op)-.1 G .973
(orts it will be necessary to tell the second IRAF tape job)-3.473 F
(what port to use, since the magtape dri)108 316.8 Q -.15(ve)-.25 G 2.5
(rw).15 G(ill use port A by def)-2.5 E 2.5(ault. F)-.1 F(or e)-.15 E
(xample,)-.15 E(cl> set tapecap = ":so=c)128 340.8 Q(ygnus,5139" or)-.15
E(cl> mte)128 352.8 Q(xamine "mta[:so=,5139]")-.15 E 1.423
(If there is some problem using the b)108 376.8 R 1.423(uiltin port def)
-.2 F 1.423(aults you can use an)-.1 F 3.924(yp)-.15 G 1.424(ort you w)
-3.924 F 3.924(ant. The)-.1 F(follo)3.924 E(wing)-.25 E
(resources tell which port to use.)108 388.8 Q(XT)128 412.8 Q 58.7
(apemon.port #)-.8 F(port A)2.5 E(XT)128 424.8 Q 40.38
(apemon.alternate #)-.8 F(port B)2.5 E .146
(Or you can specify the ports with the ar)108 448.8 R .145
(gument "-port" or "-a" \(alternate\) on the command line when xtape-)
-.18 F(mon is started.)108 460.8 Q F2 -.09(BU)72 477.6 S(GS).09 E F0
-1.1(Yo)108 489.6 S 2.69(uc)1.1 G(an')-2.69 E 2.69(tn)-.18 G .19
(ecessarily trust displayed information such as the de)-2.69 F .19
(vice type and tape type.)-.25 F .19(On most platforms)5.19 F 1.002
(this information is tak)108 501.6 R 1.001
(en from the tapecap entry for the de)-.1 F 1.001(vice, and the accurac)
-.25 F 3.501(yo)-.15 G 3.501(ft)-3.501 G 1.001(his information will)
-3.501 F .87
(depend upon the diligence of your IRAF system adminstrator when the)108
513.6 R 3.37(yc)-.15 G .87(on\214gured tapecap for your site)-3.37 F
(\(and on whether you use the correct logical de)108 525.6 Q
(vice name for the dri)-.25 E .3 -.15(ve a)-.25 H
(nd tape capacity you are using\).).15 E .404(Xtapemon tries to k)108
549.6 R .403
(eep track of the amount of tape used: the number of Mb \(me)-.1 F -.05
(ga)-.15 G .403(bytes\) read or written is).05 F 1.953
(displayed, along with the percent of the tape used.)108 561.6 R 1.953
(Whether or not the percent used \214eld is accurate)6.953 F .73
(depends upon a number of f)108 573.6 R 3.23(actors. First)-.1 F .729
(the tape capacity gi)3.23 F -.15(ve)-.25 G 3.229(ni).15 G 3.229(nt)
-3.229 G .729(he tapecap \214le must match the actual)-3.229 F 1.336
(tape being used.)108 585.6 R 1.336
(Second, if data compression is in use on the dri)6.336 F -.15(ve)-.25 G
3.837(,x).15 G 1.337(tapemon will display the uncom-)-3.837 F
(pressed quantity of data written.)108 597.6 Q(On a compression dri)5 E
.3 -.15(ve p)-.25 H(ercent used can be greater than 100%!).15 E F2
(SEE ALSO)72 614.4 Q F0(xgterm\(1\), ximtool\(1\))108 626.4 Q F2
(COPYRIGHT)72 643.2 Q F0(Cop)108 655.2 Q
(yright\(c\) 1986 Association of Uni)-.1 E -.15(ve)-.25 G
(rsities for Research in Astronomy Inc.).15 E(X11IRAF Project)72 768 Q
(11 Dec 1996)137.62 E(2)203.45 E EP
%%Trailer
end
%%EOF