|
|
|
The HTVIEW utility is intended to read and display (or print) the contents of an IDX LastWord(tm) Hometerm Log File. Several options are provided to control the amount or type of information displayed. The utility is designed to operate with either the older HOMETERM process (and will require the name of the primary HTLOG file) or with the newer HOMETERM process—from which it can request the HTLOG filename, given the HOMETERM process name. Output will be formatted either for display to an 80 character (by 24 line) screen, or for printing to a 132 column (60 printable line) printer. If no OUT file is specified output will be sent to the user's terminal. The following syntax diagram shows the various commands and options supported by the utility. Similar help is available on-line by running HTVIEW without commands. An explanation of each option follows:
HTVIEW---------------------------------htfilename------- - - -
| | | |
|--> /OUT filename/ -->| |--> htprocname -->|
|
|--> ? ---------------
|-----------------------------------------|
V |
- - - -------FROM--datetime--------------------------- - - -
| |
|--THRU--datetime-------------------->|
| |
|--FOR--number-->| |
| | |
|--LAST--number->|--HOURS------------>|
| | |
| |--MINUTES---------->|
| | |
| |--RECORDS---------->|
| |
|--FIND------->|--"characterstring"-->|
| | |
|--FINDEXACT-->|--'characterstring'-->|
| |
|--OMIT------->|--"exclusionstring"-->|
| | |
|--OMITEXACT-->|--'exclusionstring'-->|
where:
? displays HELP information htfilename is the name of an HTLOG primary file htprocname is the name of a HOMETERM process records is the maximum number of records to display characterstring is a string of characters that each displayed line must contain exclusionstring is a string of characters that must NOT appear in any displayed line number is the starting place for display in either HOURS, MINUTES, or RECORDS from end of file or the ending place for display in either HOURS, MINUTES, or RECORDS from either the beginning of the file or from the FROM date datetime is defined as the following:
|-------------------------------->|
| |
- - ---- dd-mon ---------------------- hr:mn ----------------------- - -
| | | | | | |
| |- -year ->| | |- :sc ->| |
| | | |
|---------------------------->| |- .msc ->|
| |
|-- TODAY -------------------------------------------------->|
where:
The following abreviations are allowable for keywords:"
Prefered Allowable
-------- ------------
FROM FR
THRU TH
FOR **
LAST L
FIND F
FINDEXACT FINDX FX
OMIT O
OMITEXACT OMITX OX
The following abreviations are allowable for units:
Prefered Allowable
-------- ---------
HOURS HOUR HRS HR
MINUTES MINUTE MINS MIN
RECORDS RECORD RECS REC
The following commands are supported by this utility:
Considerations:
> HTVIEW $LWHT FROM 21-DEC LAST 24 HOURS
The FROM command is encountered first and sets the starting timestamp
for the display. When the LAST command is encountered HTVIEW expects
to CALCULATE the starting timestamp. This would overwrite the FROM
timestamp. Since it isn't possible for HTVIEW to save BOTH starting
timestamps, it issues the following error message:
> HTVIEW $LWHT FROM 21-DEC LAST 24 HOURS
^
**** ERROR - FROM qualifier already used ****
**** Cannot use FROM and LAST in the same command line ****
Another way to specify this command is a follows:
> HTVIEW $LWHT LAST 24 HOURS or > HTVIEW $LWHT FROM 21-DEC FOR 24 HRS
The HTVIEW utility maintains a set of internal variables that control its
behavior. These variables can contain the follow information: earliest
date for which to select data; latest date for which to select data;
maximum number of records that can be selected; a search string which all
selected records must contain; and an exclusion string which none of the
selected records may contain. Certain combinations of commands (which use
the same internal variables) cannot be used together. The following table
shows how the se internal variables are used by the various commands:
|-----------------------|-------|-----|---------|--------|-----------|
| Internal Variables -> | Start | End | Records | Search | Exclusion |
| Commands | T.S. | T.S.| | String | String |
|-----------------------|-------|-----|---------|--------|-----------|
| FROM | X | | | | |
|-----------------------|-------|-----|---------|--------|-----------|
| THRU | | X | | | |
|-----------------------|-------|-----|---------|--------|-----------|
| FOR (Records) | | | X | | |
|-----------------------|-------|-----|---------|--------|-----------|
| FOR (Hrs, Mins) | | X | | | |
|-----------------------|-------|-----|---------|--------|-----------|
| LAST | X | | | | |
|-----------------------|-------|-----|---------|--------|-----------|
| FIND, FINDEXACT | | | | X | |
|-----------------------|-------|-----|---------|--------|-----------|
| OMIT, OMITEXACT | | | | | X |
|-----------------------|-------|-----|---------|--------|-----------|
A sample screen display follows:
-------------------------------- -----------------------------------
|JM HT Log Viewer Version 2.0 / / LogFile: $D02.LWDATA.HTLOG |
| \ \ |
|08DEC03 11:45:07 08DEC03,11:45 $\ \ *3164* TERM EVM127, CODE OF RECE |
| IVED MESSAGE UND\ \ INST CODE: SEND-MESSAGE AT OFFS |
| ET %2030 IN PROGR\ \IT(4) IN TCLPROG \SYSTEM1.$D02. |
| LWCROBJ.POBJ / / |
|08DEC03 11:46:40 \SYSTEM1.$Z0PV:1/ /,250] \SYSTEM1.$D02.LWCROBJ.PASS |
| VRO 8Dec03 11:/ /or 0001 on \SYSTEM1.$D00.LWDATA.A |
| PT / / |
|08DEC03 11:47:16 \SYSTEM1.$X7KP\ \*** Run-time Error 169 *** |
|08DEC03 11:47:16 \SYSTEM1.$X7KP:\ \OCK or UNLOCK operation failed wi |
| th error 75 \ \ |
|08DEC03 11:47:16 \SYSTEM1.$X7KP:17\ \e FSHDHDR = \SYSTEM1.$D01.LWDAT |
| A.FSHDHDRO I-O \ \ |
|08DEC03 11:47:17 \SYSTEM1.$X7KP:178/ / FEESVRS + %1752, UC.00 |
|08DEC03 11:47:17 \SYSTEM1.$X7KP:17/ /250] \SYSTEM1.$D02.LWCROBJ.FEES |
| VRO 8Dec03 11:4/ /r 0075 on \SYSTEM1.$D01.LWDATA.F |
| SHDHDR \ \ |
|08DEC03 11:47:17 \SYSTEM1.$X7KP:17\ \ Run-time Error 169 *** |
|08DEC03 11:47:17 \SYSTEM1.$X7KP:178\ \ or UNLOCK operation failed wi |
| th error 75 \ \ |
|08DEC03 11:47:17 \SYSTEM1.$X7KP:17826\ \SHDRUL = \SYSTEM1.$D01.LWDAT |
| A.FSHDRUL, I-O \ \ |
|Enter 'S' to STOP, RETURN to Continue=>\ \ |
---------------------------------------- ---------------------------
Notice that the screen header shows the HTVIEW version as well as the HTLOG
file being read. HTVIEW pauses at the end of each screen for the user to
either STOP (by entering and "S" character, of to CONTINUE by pressing the
RETURN key.
The following examples show several common command streams:
> HTVIEW $LWHT LAST 24 HRS OMIT "$D02.LWCROBJ"
> HTVIEW $LWHT LAST 5 MIN
> HTVIEW $LWHT FIND " " LAST 20 MINS
If you know the name of the HTLOG file (or if the HOMETERM process that
wrote to it is no currently running) you can enter the name of the
"forward" log file (not the ...BK file):
> HTVIEW $D02.LWDATA.HTLOG LAST 5 MIN
 In the meantime you can obtain a freeware version in the ITUG (International Tandem Users Group) software archive: ITUGLIB If that link fails, go to: ITUG Select the ONLINE RESOURCES tab and choose ITUGLIB. Next, select SEARCH and enter HTVIEW in the NAME OR PARTIAL NAME field. |
| Copyright © 2007 Joseph Massucco LLC |