rdframe
Parameters are: unit, pass_number, satellite, telem, startdate, start_time, duration, {now}
rdframe is called by the scheduler a few minutes before the scheduled pass is to begin. rdframe loads the programmable frame synchronizer with the telemetry-dependent configuration file. These files are recognized by the extension lod. rdframe then initializes the sbus dma operation and waits for valid data. When the frame synchronizer locks on the incoming telemetry, it interrupts as the last word in a frame is received. The interrupt handler uploads framed telemetry via driver routines. The uploaded telemetry data is then decommutated and written to the disk drive.
On Sun systems, wrframe is a subprocess of rdframe that writes the pass data to disk. rdframe frames the pass data and puts it into a shared memory ring buffer. wrframe takes the data from shared memory and writes it to disk. This scheme allows rdframe to avoid being blocked by disk I/O.
Specifies the antenna_unit(0,1,2) + ACC*10
Valid responses are 0, 1 and 2.
Specifies the pass number on the disk
Valid responses are 0, 1, 2 and 3.
Specifies from which type of satellite the data are being received. The options are noaa or dmsp.
Valid responses are noaa-? and f-?.
Specifies the type of telemetry.
Valid responses are hrpt and ols.
Specifies the start date for data ingest.
The format for the response is yy/mm/dd.
Specifies the start time for data extraction. The first line with a time greater than start_time is the first output line.
Any valid time is allowed. See formats for information on time formats. The default is 00:00:00.
The valid range is >= 1. The default is 700.
OPTIONAL. Force rdframe to act as if reception were beginning now.
%rdframe 0 1 noaa-11 hrpt 89/9/26 10:02:33 10:00 %rdframe 0 -1 noaa-11 avhrr 89/9/26 10:02:33 10:00 now
rdframe runs with a nice number of -11. In order to change the nice number only a superuser can run this function.
The size of the shared memory ring buffer is controlled by the environment variable MAXSMANT. It defaults to 540672 (bytes) which is exactly 24 HRPT frames, or 44 RTD frames. MAXSMANT must be increased for high rate telemetries such as GVAR, especially when capture post processing does live pass ingest. Increasing MAXSMANT may require a corresponding modification to operating system shared memory limits.
Last Update: $Date: 2000/12/07 20:00:00 $