addpass - Add an entry to the online catalog.

SYNOPSIS

addpass  [ parameter=value ... ]

Parameters are: pass_number, satellite, telemetry, start_date, start_time, num_lines, orbit_number.

DESCRIPTION

addpass adds a record entry to the online pass catalog. This function is generally not a user function since it only adds the entry to the online catalog, and not the actual pass to the pass disk. However, it can be useful in debugging situations or if a record entry was accidentally deleted from the online catalog (i.e. rmpass) and the pass data has not yet been over written.

PARAMETERS

pass_number

This is the number of the pass in the online pass catalog.

The valid range is [ >= 1 ].

The default is [ 1 ].

satellite

This is the satellite name. It must be entered in lower case.

There is no default.

telemetry

This is the data telemetry type. It must be entered in lower case.

The default is [ hrpt ].

start_date

This is the start date of the data to add to the catalog.

Any valid date is allowed.

There is no default.

start_time

This is the start time of the data to add to the catalog.

Any valid time is allowed.

There is no default.

num_lines

This is the number of lines (or data records) in the telemetry data.

The valid range is [ >= 1 ].

There is no default.

orbit_number

This is the satellite orbit revolution counter. Use 0 if the orbit number is unknown.

The valid range is [ >= 0 ]. The default is [ 0 ].

EXAMPLES

Add an entry into the online pass catalog and verify the add with lspass.

[1] % lspass
 #  satel    telem   date   day    time    durat  lines

 1  noaa-11  hrpt  91/09/09 252  00:00:12  00:04     29

[2] % addpass
 pass_number    : int      ? [1] 2
 satellite      : char( 8) ? noaa-10
 telemetry      : char( 7) ? [hrpt]
 start_date     : char(15) ? 91/07/18
 start_time     : char(15) ? 12:34:21
 num_lines      : int      ? 4500
 orbit_number   : int      ? [0]
 Run again ? [no] n

[3] % lspass
 #  satel    telem   date   day    time    durat  lines

 1  noaa-11  hrpt  91/09/09 252  00:00:12  00:04     29
 2  noaa-10  hrpt  91/07/18 199  12:34:21  12:30   4500

FILES

onlinecat

SEE ALSO

rmpass

NOTES

This function will allow entry of a pass number greater than any actually available, causing no end of trouble. This function does not allow for setting status flags or autoarchive parameters. 


Last Update: $Date: 1999/05/10 20:12:28 $