SHXMAKE

Format: SHXMAKE filename.LIS

The standard header packet is one of the types of telemetry packets which are formatted on the spacecraft and sent down to the Institute with each dump of an exposure. Some general items of data such as the spacecraft clock coefficients are within this packet. In addition, each instrument has an area within this packet in which it can write a small number of selected engineering items.

There have been occasions where the information contained in the telemetered version of the standard header packet, the .SHX file, is incorrect and further processing by the OPUS pipeline cannot proceed. Therefore occasionally there is a need to modify the contents of the .SHX file so the observation can finish processing through the pipeline.

The database relation "yurintab" contains the location of items in the telemetry stream (the .SHX file). This tool combines that information with the contents of that file, and dumps the individual telemetry item values into a human-readable ASCII .LIS file. That file can then be edited with any text editor. Any particular value in the SHX can thus be changed. Running the SHXMAKE command against the resulting .LIS file produces a binary .SHX file with the new values.

Inputs

The .LIS file, for example, will contain entries with the following format:
.....

SOURCEID= ' DC'x / SOURCE ID

DCFOBSN = ' 30'x / DCF OBS NO./PRINTING

YHVVLT = ' E9'x / HV SUPPLY VOLTAGE

YHVCUR = ' E9'x / HV SUPPLY CURRENT

YXDEFCUR= ' 7E'x / X-DEFL COIL DR CUR

YYDEFCUR= ' B8'x / Y-DEFL COIL DR CUR

YTRMFCUR= ' 7C'x / TRIM FOCUS COIL DRI

.....

Note that all values are given in hexadecimal format. Modifying the value in this file, and running the SHXMAKE tool will result in a new .SHX file with the revised values.

Also note that the format of this file is fixed. SPACES ARE SIGNIFICANT.

A binary .SHX file.

None

Filename

This file should be in the format produced by the SHXDUMP tool. This file which contains the contents of an .SHX file listed in ASCII keyword format, can be edited with any text editor. Any particular value in the SHX can thus be changed. Running the SHXMAKE tool against the resulting .LIS file produces a binary .SHX file with the new values.

SHXDUMP Decodes a binary .SHX file into an ascii readable .LIS file

MODPKT A binary editor used to modify individual mnemonic values in an EDT file

$ SHXMAKE Y2U10403T.LIS
Takes the Y2U10403T.LIS file and creates a new Y2U10403T.SHX file.