|
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 HOURSThe 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 HRSThe 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 MINSIf 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 |