RXTE Helpdesk/FAQ RXTE What's New HEASARC Site Map


pcaRtClient - man page

pcaRtClient(1)            User Commands            pcaRtClient(1)

NAME
     pcaRtClient - PCA real-time client  for  Science  Monitoring
     and Health and Safety

SYNOPSIS
     pcaRtClient   [-ascii]  [-daemonize]  -display-client   name
     -host  hostName [-port number] -name clientName [-read-from-
     stdin]

DESCRIPTION
     The pcaRtClient process is used primarily as  the  interface
     between the real-time server and the EDS-PCA display clients
     for Science Monitoring and Health and Safety.   It  receives
     data  packets of the type specified by the -name option, and
     assembles  a  partition, which it then sends to the  display
     client.

OPTIONS
     Options may appear in any order on the command line.

     -display-client name
               This is the name of X client  program  to  execute
               for  graphical  display.   The choices are as fol-
               lows:

                pcastd1CalS:  Standard Mode1 Calibration
                pcastd1LC:    Standard Mode1 Light Curve
                pca1FFT:      Power spectra (Temporal Science)
                pcaStd1LeahyHist:  Power spectra History
                pcastd2:      Standard Mode2 Spectra
                pca2Rate:     Standard Mode2 Rates
                pcaSBase:     Spectral Science - Base
                pcaSColor:    Spectral Science - Colors vs Time
                pcaSHist:     Spectral Science - History
                pcaSRecom:    Spectral Science - Recommend
                PCAdisplay:   Housekeeping (This is default)

     -host hostName
               This is the name of  the  computer  on  which  the
               Realtime  Server  is running.  This option must be
               specified unless -read-from-stdin is set.

     -port number
               This is the port number to connect  to  the  real-
               time server.

     -name clientName
               This is the name you  advertise  to  the  realtime
               server  to  indicate which kind of data you  would
               like to receive. The name must  correspond  to  an
               entry in the $SOCHOME/etc/RT.CLIENTS.  The choices
               are  EDS-EA5  (or  PCA-STD1)  for  Standard  Mode1

SunOS 5.4          Last change: 31 August 1995                  1

pcaRtClient(1)            User Commands            pcaRtClient(1)

               Science  data,  EDS-EA6 (or PCA-STD2) for Standard
               Mode2 Science data, and  PCA-HK  for  Housekeeping
               data.

     -read-from-stdin
               Read from stdin instead of over  a  socket.   Used
               mainly  for  testing  and  debugging.   Also, this
               option should be used for archived data.

     -ascii    Produce  ASCII  output  to  stdout,   instead   of
               displaying data on the graph.  This is used mainly
               for testing and debugging.

     -daemonize
               Run as a daemon.

ENVIRONMENT VARIABLES
     DISPLAY   This sets the machine and screen on  which  any  X
               Windows opened by the display-client

     SOCHOME   This is the root directory of the XTESOC  Integra-
               tion  and  Test  directory.  Below this directory,
               there should be a subdirectory, etc , which should
               contain both the AUTH.HOSTS and RT.CLIENTS files.

     SOCOPS    This is the root of the SOC  operations  directory
               tree.

FILES
     $SOCHOME/etc/AUTH.HOSTS
               machines authorized to  connect  to  the  Realtime
               Server.

     $SOCHOME/etc/RT.CLIENTS
               table mapping of 'clientName'(see above) to  their
               ApIDs.

EXAMPLES
     To collect Standard Mode1 PCA Science telemetry data from  a
     realtime server running on xitserv and put up  a Light Curve
     display:

     pcaRtClient -host xitserv.nascom.nasa.gov -port  5094  -name
     EDS-EA5 -display-client pcastd1LC

     To collect Standard Mode2 PCA Science telemetry data from  a
     realtime  server  running  on  xitserv  and put up a Spectra
     display:

     pcaRtClient -host xitserv.nascom.nasa.gov -port  5094  -name
     EDS-EA6 -display-client pcastd2

SunOS 5.4          Last change: 31 August 1995                  2

pcaRtClient(1)            User Commands            pcaRtClient(1)

     To monitor stored data:  (In this case, pktgen process  does
     the   real-time  server  role  of  feeding  packets  to  the
     pcaRtClient.)

     pktgen -millisleep 500 -write-to-stdout std2-PCA5.1a55189  |
     pcaRtClient -read-from-stdin -display-client pcaSBase

SEE ALSO
     rtserver(1), pktgen(1), pcaSBase(1), pcastd1LC(1)

AUTHOR
     The realtime client template was written by Mike Lijewski.

     MIT is responsible for the original version  of  the  client
     specific   realtime   clients.   (such  as  std1Calibration,
     std1Timing, std2RTclient, etc.)

     All these individual clients were merged together  by  David
     Hon(Hughes/STX dhon@xero.stx.com) to create a combined real-
     time client program for PCA, pcaRtClient.

     Minor modifications were  added  by  Hwa-Ja  Rhee(Hughes/STX
     rhee@pcasun5.gsfc.nasa.gov)  to  accomodate all PCA display-
     clients.

SunOS 5.4          Last change: 31 August 1995                  3


Go Back to: Remote Observing
Page Maintained by: Robin Corbet


For questions about scheduling of RXTE observations please send email to xteplan@athena.gsfc.nasa.gov If you have other questions about RXTE, please send email to one of our help desks.

This page is maintained by the RXTE SOF and was last modified on Wednesday, 24-Aug-2022 11:10:28 EDT.

Responsible NASA Official: Phil Newman
Web Curator: Robin Corbet

Privacy Policy and Important Notices.