Документ взят из кэша поисковой машины. Адрес оригинального документа : http://www.atnf.csiro.au/pub/software/AIPS/build/15APR98/MULT_TVreadme Дата изменения: Mon Dec 18 06:14:42 1995 Дата индексирования: Fri Dec 28 01:23:40 2007 Кодировка: Поисковые слова: annular

Help for ATNF Multiple TV servers code.
---------------------------------------

Following are :
1. A description of the various changes to allow more flexible use
of AIPS TVs. Display is possible on any X server including PCs.
2. Installation Instructions.

1. DESCRIPTION OF CHANGES
In the NRAO version of AIPS, hosts which can run AIPS TV servers
can only run one XAS/TEKSERVER/MSGSRV, but can direct the display
to another machine or to an alternate screen on the same or another
host using
aips tv=tvdisplay:tvhost
where n is used in setenv DISPLAY tvhost:n
Because in this case SSSIN is always used, and the same
$DA00/ICC... and IDC... files, only one XAS/TEKSERVER/MSGSRV server
can run at a time on a single host.

In the ATNF version of AIPS (ATNFAIPS) :
More than one set of TV servers may be run on hosts which direct
their TV display to X-terms, PCs running X, or non-AIPS workstations.
These server:display combinations must be listed in
/AIPS/HOSTS.LIST in the form
= YOURPC - YOURSITE AIPSHOST

For each of these non-AIPS machines there must be
. an entry like the above in HOSTS.LIST
. a set of entries in the /etc/services file called SSSIN{1,n}
for XAS, tekserv{1,n} for the TEKSERVER and msgsrv{1,n} for MSGSRV.
. separate sets of $DA00/ICD... and IDD... files
The limit to n, the number of servers per host, is 9.

NOTE: ATNFAIPS has reversed the syntax from
aips tv=tvdisplay:tvhost (as for NRAO aips)
to
aips tv=tvhost:tvdisplay
or aips tv=tvhost:n
where n is used in setenv DISPLAY tvhost:n

The changes are briefly described below. The code is in a compressed
tar file in our anonymous ftp area
ftp.atnf.csiro.au pub/software/AIPS/15JUL95/MULT_TV.tar.Z

Good luck with it,

Henrietta

--------------------------------------------------------------------
XAS, TEKSRV.EXE and MSGSRV.EXE must be in $LOAD so that when
users of the X-terms start up, they can create links to XAS{1,n} etc
Check that XASERVERS knows they are there.

/AIPS/START_TVSERVERS
Set DISPLAY to $TVDISP:$TVXN when $TVXN is non-zero, rather
than just $TVDISP. This applies when START_TVSERVERS is run
on a host which serves more than one AIPS X display, usually
X-terms.

$SYSLOCAL/XASERVERS
. Use XAS and TEKSERVER in $LOAD.
. Use $TVSVN to create link $LOAD/XAS$TVSVN of necessary and run it.
Same for $LOAD/TEKSERVER$TVSVN

/AIPS/TVDEVS.SH
Set TVSVN
. 0 for TVHOSTS running only one set of TV/TK servers
The service/port used is SSSIN
. n for TVHOSTS which can serve more than one TVDISP
display - usually x-terms. In this case the server
processes are named XASn and TEKSERVERn, created as
links to $LOAD/XAS.
The service/port used is SSSINnn
Set TKDEV TKDEVnn as before
TKDEVnn translates to tekserv:$TVHOST or tekserv$TVSVN:$TVHOST
Set TVDEV TVDEVnn as before
TVDEVnn translates to SSSIN:$TVHOST or SSSIN$TVSVN:$TVHOST

Set TVXN
. 0 for TVHOSTs displaying on the console,
ie DISPLAY hostname:0
. n for TVHOSTS displaying on an alternate screen so
DISPLAY hostname:n
eg aips tv=mayhem:9 is used to display on a remote PC
running 'term'.

Also needed are changes to some subroutines: all involve translating
the new form of the environment variables.

$APLBERK/ZSSSO2.C (for Solaris-1)
$APLBELL/ZSSSO2.C (for Solaris-2)
Modified to accept SSSINn as the service name as well as SSSIN.
as long as SSSINn is included in the /etc/services file.

$APLBERK/ZTKOP2.C (for Solaris-1)
$APLBELL/ZTKOP2.C (for Solaris-2)
Added code to allow for different services to be used.
tekerv, tekserv1...tekserv9 rather than assuming tekserv.
Translate TKDEVnn to service:hostname.
Allows old version TKDEVnn=hostname.

$APLUNIX/ZTTOP2.C
TTDEV translates to TTDEVnn which in turn translates to
service:hostname.

$APLUNIX/ZMSSRV.C (for Solaris-1)
$APLSOL/ZMSSRV.C (for Solaris-2)
Translate TTDEV to TTDEVnn, and TTDEVnn to service:host
to allow for multiple TVs on one server.

$APLUNIX/ZTKSRV.C
Translate TKDEV as for ZMSSRV.C above.

2. INSTALLION INSTRUCTIONS.

Create an empty directory and unpack the tar file.
Edit the code before installing because we at ATNF have made various
other changes to these files. Do a "dif -DATNF yourversion ATNFversion"
and select the relevent changes.
As the code allows for the old form of the logicals, you can install
the changed .C routines without breaking anything.

Save the original versions of ZSSSO2.C, ZTKOP2.C, ZTTOP2,
ZMSSRV.C and ZTKSRV.C in the appropriate directories.
Copy in the new versions, checking the changes with dif.
Recompile the subroutines then rebuild $AIPPGM/AIPS and
and $AIPGNOT/MSGSRV and $AIPGNOT/TEKSRV.

Add lines like the following to /etc/services: You need one set for
each extra set of TV servers. Up to 9 is OK.
SSSIN1 5021/tcp # HM 93/Jun/29: SSS multi-server version
SSSIN2 5022/tcp # HM 93/Jun/29: SSS multi-server version
SSSIN3 5023/tcp # HM 93/Jun/29: SSS multi-server version
tekserv1 5031/tcp # HM 93/Jul/05: TEKSERVER multi-server version
tekserv2 5032/tcp # HM 93/Jul/05: TEKSERVER multi-server version
tekserv3 5033/tcp # HM 93/Jul/05: TEKSERVER multi-server version
msgserv1 5041/tcp # HM 94/Feb/25: MSGSERV multi-server version
msgserv2 5042/tcp # HM 94/Feb/25: MSGSERV multi-server version
msgserv3 5043/tcp # HM 94/Feb/25: MSGSERV multi-server version

The scripts below could be tried before installing them, say by
giving them lower-case names and editing start_tvservers to call
tvdevs.sh and xaservers. Also make a start_aips which calls tvdevs.sh.

/AIPS/START_TVSERVERS
rename in lower-case for testing and edit to call lower-case xaservers.
edit $AIPS_ROOT and 2 occurrences of
#ifndef ATNF
dispnum="0"
#else /* ATNF */
dispnum=$TVXN
#endif /* ATNF */

/AIPS/TVDEVS.SH
Try it as lower-case tvdevs.sh
Lots and lots of changes.
You probably need them all.
Remember we swapped TVHOST and TVDISP so that tvhost:0 makes sense.

$SYSLOCAL/XASERVERS
Try it in lower-case.
Use all the changes involving environment variables such as
TVSVN, TEKN, XASN, MSGN.

I've sorry it is so messy! Good luck,
Henrietta

Henrietta May
Australia Telescope National Facility
CSIRO, Australia
aipsmngr@atnf.csiro.au
Phone: Sydney 02-372-4336