ZIP - Rapid SDF Display Processor
Version 7R1B - August, 2020
* The authors and maintainers of this software make no representation of * * its suitability for a particular application and will not be held re- * * sponsible for improper operation, loss of data, productivity or other * * misfortunes resulting from the use of this software. Questions and * * comments are welcome, but there is no obligation to provide present * * or future support services or product enhancements. * * Use of this software constitutes acceptance of these terms. *
ZIP is a fast read-only text processor that can be used to read any sector-formatted file created on the Unisys 2200. There are three modes of operation: (1) text mode (SDF formatted files or elements), (2) ALAT and TIP TPM mode (reads system audit trails) and (3) block mode (format- independent). Basic ZIP commands are similar to those of @ED,R. Faster throughput is achieved by using very large I/O buffers. After a file is read once, an internal line index allows very fast access to any record.
Large records (up to 8200 words) are supported, and embedded ASCII control characters will not corrupt the screen display. For these reasons, ZIP is also ideal for working with PCIOS-SDF data files. A text reformat feature is provided which can display computational fields numerically and extract partial strings of character data. Global selection criteria can be established so only records meeting certain conditions are processed. A group of selected and/or reformatted records may be output to another file.
Version 2R1, released in January 1992, introduced ASCII log capability and the "find address" commands. Version 2R1A (June 1992) had improvements in data extraction and record selection. Version 3R1 (June 1993) added online HELP, save and restore of symbol definitions and sort capability. Major new features of version 4R1 include block mode input and output, dynamic reassignment of the input file, some new SELECT and REFORMAT capabilities, and display/search in the backwards direction.
Version 4R2 was enhanced to read new format audit trails produced by HMP IX7.1 and above, as well as earlier formats. This level introduces TIP TPM log read capability (thanks to Rick Onsgard of Unisys). Additional ALAT record types and an expanded output format, activated by the global 'A' option, are available. Duplicate records can be removed from output files. Alpha fields which are copied into reformatted records can be trun- cated when a user-specified character is encountered. A DUMP command was added to display multiple records in octal, aligned on word boundaries.
Version 5R1 allows any program file to be opened in TOC mode. Each record corresponds to an element in the file. Records are displayed in a standard columnar format, and an ELT command has been added to open any symbolic element in the file. Also new in 5R1 is a CHANGE command with a syntax much like the familiar @ED command of the same name. It operates like the REFORMAT command, and changes can be written to a different file with EXTRACT or OPEN...WRITE...CLOSE. Version 5R1 has enhanced online help for users of ALAT or TIP TPM audit trails.
Note to TOCED users: The TOC and element access commands (TOC,ELT) provide a subset of the functionality of this popular program, but they do not replace it. ZIP cannot apply changes to the TOC of a file. If the CHANGE command is used while in TOC mode, the change(s) will only become permanent if the listing is written to an extract file; and this is only an SDF text copy of the actual TOC.
Version 5R2 increases the maximum output length (before wrapping) from 76 to 79 characters. There is a new global option (U) which can be used to truncate the last character of a record - for display purposes only - if by so doing it will prevent a screen wrap. These features allow any file with 80 characters/record to be displayed without screen wraps. There is a new feature of the FUSION package that will automatically sense the screen length and width. The parameters are set accordingly, no options or commands are required. If there is an insert point (set via @@INS), it is preserved and the protected portion of the screen is not overwritten unless full-FUSION is enabled (@ZIP,F or ON F).
Version 6R1 adds the capability to read stepcontrol audit trails. No special options or parameters are required - the file type is detected automatically. Minimal editing is performed but it is not as comprehensive as that provided with ALAT or TPM trails. Several size limitations are increased or eliminated in version 6R1. The maximum track size for SDF and ALAT files is now about 3.7 million. This is an architectural limit - the MAXTRK parameter (previously 650K) has been removed. There is now no practical limit on the size of a file when reading it in block mode. The maximum SDF record size has been increased from 2047 words to 8200 words (this is still controlled by the MAXREC parameter). The BSP$ interface is now used to read and write elements in program files, thus providing full LPF and LEPF access.
Version 6R1A includes some minor new features, including a reserved variable (CS$) that can select by character set, a transparent SELECT character, and inclusion of the space character for select or locate operations. The maximum block size for ALAT and stepcontrol audit files has been increased to the system maximum. ALAT log entry types 102, 1007, 1411, 16005 and 16006 are edited, and TPM subtypes 8 and 9 are edited.
Version 6R2 can read DSTA format audit trails (ALAT, TPM and stepcontrol). This is the format written by the CP 15 release. All older audit trail formats are still supported. There is a new MONITOR command that permits monitoring of an active audit trail, with real- time updates at periodic intervals (every 1 to 30 seconds). ALAT log entry types 158, 205 (replaces 203), 492, 493 and 12005 are now edited.
Version 6R2A uses the STM$PKG date and time editing routines, written by Les Leist, to replace those from the standard library. This change should be invisible to the user but it improves compatibility with newer timestamp formats and improves performance when reading ALAT trails. There is a new reserved symbol (TID$) that selects or displays the thread ID when used with SELECT or REFORMAT, and improved ALAT editing of log entries related to the SEC$SWITCH$ feature. Other new CP 15 log entries are also edited (13501, 13502, 112005).
Version 6R2B expands on the use of the STM$PKG routines to enable editing timestamps for TOC or LOG entries in either older formats (TDATE$, DATE$) or newer (MODSWTIME, TIMEB). The 'M' global option provides for editing expanded log entry type and subtype fields. The entries for @XQT (101) and Run Termination (107) show the count of TDATE$ and DATE$ requests performed by the run so far, as an aid to preparing for TDATE$ remediation. REATTACH,W will wait if a file is exclusively assigned.
Version 6R3 allows reading of runid print queue files (RUNID PR, PR/01...). It enables moving forward and backward among file cycles (CF/CB) and TOC elements (EF/EB). TOC listing timestamps are displayed in ISO format, in keeping with upcoming FURPUR releases. PL/LPL [n] provides for displaying the last page, or last n records, of a file; and COM evaluates arithmetic expressions and converts formats.
Version 7R1 adds the use of color to ZIP demand displays. A new command, COLOR [ON|OFF|LOG|TOC|LST], controls the use of color FCCs when displaying log entries, elts in a TOC list, or compile listings. Color is OFF by default. The L and LC commands can now be used to search for compiler and MASM diagnostic messages. Three classes of messages can be targeted: (1) Error messages, (2) Error & warning messages and (3) All diagnostic messages, including remarks and MASM undefined symbol indications. HELP [L|LC] provides specific instructions. There is a new "Easy Reading" feature for log entries when the A option is on. If the entry wraps around, it will be formatted so as not to split any strings such as filenames, keywords, or numbers across a line. The EF and EB commands will continue until the next symbolic element is reached, rather than stopping because a non-symbolic element is encountered. The CF and CB commands will skip over deleted cycles. Most error and informational messages produced by ZIP are now displayed in mixed-case ASCII. Outstanding messages and their replies will be preceded by ">" to set them off. Replies to outstanding messages will show the time waited for a response if 5 seconds or longer (set by OMGSEC tag in LOGSUB), 1 second if A option. Log Entries corrected or added: 73: Includes Partition, version, and SCMS level if A option on. 107: Shows correct termination time when A option on. 109: Shows correct device, page/card count, and/or filename. 17091: Displays text message if user changed password using @PWD. The default CURMAX is increased to 99. The COM command interprets a number ending with a period as a real number. In dump mode (D option), the entire log entry is displayed before the dump instead of being cut off after one line. The ON/OFF commands will reply by displaying current options.
Version 7R1A adds new information for the 106/1 entry when the A option is on: @RUN priority, options, & condition word T2 if non-zero. A warning is printed if full screen mode is used on a non-UTS60 terminal. There is also a warning (not an error) if max print words (223) are exceeded. Audit Blocks of up to 65520 words are accepted. - Log entries corrected or added: 408: labeled as "NAMCHG" to indicate its purpose. 470-472,480-482: TIP File Control Maintenance. 17006: ASIS Authentication Success/Failure.
******* NEW ********
Version 7R1B adds the TDC (TDATE$ count) command. When TDC is entered, it produces an SDF file, TDATE$COUNT, showing which programs in the current log file executed ER TDATE$, and how many times. This can be useful in preparing for the changing of the various TDATE$ EXEC tags. (TDC,S for SYS$ files only.) The DT command will show the full date and time of the current log entry. Since only the month and day are normally displayed, this is handy when browsing older log files. The F option has been added to the RP command to dump the current log entry in Fieldata rather than ASCII, to accommodate the rare log entry that has Fieldata information. ZIP can now correctly read IRU EXTRACT audit files. Fixed rare bug that could error after reading the last entry in a block. - Log entries corrected or enhanced: 71 - Show time zone of last disk recovery if available. 103 - Show Load Type (LT) with TIP XQT info if A option on. 106/4 (EXEC Continuation) - Show @RUNCONT vs. @RUN, just as for user runs. 10400 - Add DEPMOVE & DEPRECV entries; track count & RECV source if A option. 13501 - Show CIFS status as decimal, others as octal, per log file manual. 13502 - Show error status if any. Show IP address if A option on. 17006 - Show network userid if present and if A option on. 17008 - Show successful ASIS password change for userid (& module if A opt.). TPM log type 13/10 - Show VA of ER TDATE$s in absolutes or ZOOMs.
See HELP NEWS for an online list of all new features.
2. More Info [Top][Contents]
ZIP uses the FUSION full-screen simulation package, written by Les Leist. This can be dynamically turned on and off. It dramatically improves terminal output speed and gives a professional "look and feel". The ZIP software is supplied with only those components of FUSION which are needed by it. ZIP is released using the FTPack utility (also written by Les) which can transfer any 2200 file in and out of text format for easy shipment to other users. It has the additional advantage of producing a self-contained text file which requires no special decompression software at the recipient site.
Complete copies of FUSION and FTPack (and several other useful utility packages) can be downloaded from <http://users.starpower.net/leistlc>. If you have questions, Les will answer E-mail sent to: <leistlc?erols?com> (Change ?erols? to @erols. for email)
The following steps are required to build the ZIP product:
1. Use PKUNZIP or other utility to decompress ZIP7R1B.ZIP into ZIP7R1B.REL. 2. @CAT,P ZIP*ADD,///500 3. Transfer the ZIP7R1B.REL file (in text mode) to ZIP*ADD. 4. @ADD ZIP*ADD. (This will catalog ZIP*RELEASE(+1) and copy the 7R1B elements into it.) * 5. @DELETE ZIP*ADD. (This file is no longer necessary.) 6. @START ZIP*RELEASE.ZIPGEN (This step is optional - the absolute element ZIP is included w/release)
* If the existing ZIP*RELEASE file has keys or if the unpack procedure can't create a new cycle for some other reason, it will be necessary to manually create the new F-cycle after step four. The file FTUNPACKFILE should then be copied into it. The ZIP*RELEASE file name is required for the build.
The output of ZIPGEN can be over 600 pages. If you wish to send to a hold queue, modify line 2 before starting it. When ZIPGEN completes successfully, the (+1) F-cycle of ZIP*RELEASE will contain the ZIP absolute.
This release of ZIP is being supplied without external documentation, with the exception of this README file. Time constraints have limited the amount of work that can be done, and it was felt that the majority of users will be those that are familiar with earlier levels. Online documentation has been fully updated. Documentation of new features since the 3R1 release is available via <HELP NEWS>. Other HELP categories that provide general information are <COMMANDS>, <LOG-FILES>, <ZIP-CALL> and <GBL-OPTS>.
ZIP 7R1B is upward-compatible with levels 3R1 and up, with these exceptions:
- In levels prior to 4R2, the DEFINE command could be abbreviated to the single letter 'D'. This will now initiate the DUMP command. The minimum abbreviation for the DEFINE command is now 'DE'.
- In levels prior to 5R1, the CLOSE command could be abbreviated to the single letter 'C'. This will now initiate the CHANGE command. The minimum abbreviation for CLOSE is now 'CL'.
- In levels prior to 6R1, the OPEN command did not require the 'U' or 'F' option - if both were absent, the output mode was solicited. Level 6R1 requires that one of these options must be used with OPEN.
- In levels prior to 6R1, ASCII characters 0200-0377 were biased into the "normal" range and displayed on the user screen in high intensity or reverse video. These characters are displayed directly in level 6R1 unless the global 'K' option is set which will restore pre-6R1 operation.
ZIP is maintained by the original author and Les Leist. If you have questions or comments, E-mails are welcome.
Ward Condit wrcondit?cox?net (Change ?cox? to @cox. for email)
Les Leist leistlc?erols?com (Change ?erols? to @erols. for email)
3. Release Doc [Top][Contents]
ZIP 7R1B Release Documentation
1. Generation of software
ZIP has several configuration parameters that are defined at the beginning of the ZIP symbolic. The defaults are generally adequate. Those which might be subject to site customization include:
MAXREF (default: 200) Maximum fields per REFORMAT MAXSEL (default: 200) Maximum selection criteria MAXSYM (default: 500) Maximum symbol table entries CRPAGE (default: 1) Determines default action of <CR> NEWSDAYS (default: 31) Number of days to display the message, SEE <HELP NEWS> FOR A LIST OF NEW FEATURES ALATID (default: 10) Trail ID for ASCII log TPMID (default: 17) Trail ID for TIP TPM log ZLFNAME (default: 'SYS$*ZIPLIB$') External name of the ZIP library file, if ZIP$PF is not pointed to a user-defined library file.
The only parameter outside of the ZIP element to customize is CURMAX (default value: 99) in element LOGSUB. This is the maximum expected count of open runs. For most efficient log file operation this value should be set as accurately as possible. If unsure it is better to overestimate slightly.
Each time the ZIPGEN run is started, it will produce a new F-cycle of the ZIP*RELEASE file. All changes to ZIP should be in COMUS TCF format and placed in element <ZIP*RELEASE.ZIPTCF>. The (+1) F-cycle of the release file will merge corrections into <PCF/eltname> elements and the TCF will be renamed <TCF-APPLIED/date-time>. Should you wish to include multiple TCFs or make other changes to the generation parameters, these can be found in element <ZIP*RELEASE.GENSGS>.
The default generation mode is FULL. All elements will be assembled. If you wish to build only elements that have changes, comment out the FULL SGS in element GENSGS. This appears at line 18. *Note: a FULL generation must be performed first because ZIP is not released with relocatable or omnibus elements.
*New in 6R2A* The FUSION$ and FUSIONPKT elements are included in relocatable form with the release because they are rarely updated and building them with MASM consumes considerably more resources than all the others combined. They are not built with a FULL gen unless corrections are present in the TCF or PCF.
All updates/corrections will be supplied in COMUS-TCF format. Therefore it is very important that NO CHANGES BE MADE DIRECTLY TO ANY OF THE SOURCE ELEMENTS. If you have local changes to configuration parameters or for any other reason, these must be supplied in TCF format and built into ZIP using the above procedure.
If your site has an alternate LIB$ file, the easiest way to install ZIP is to simply copy the absolute into this file. If not, it can be installed with SOLAR using the following procedure. This must be done with a userid that is granted all authorizations required for SOLAR install. On Fundamental Security systems, only the security officer's userid is so authorized.
- Sign on to SOLAR and select <Software Installation - Local Products>. - On the next screen, enter the file and element name: ZIP*RELEASE.SOLARINSTALL/ZIP - On the next screen, select mode LOCAL and then commit.
If ZIP has not been used at your site before, the last step in the installation process is to catalog the ZIP library file. User symbol lists will be saved as omnibus elements in this file. The library file should be a V-option file with a 1000-track maximum. It can be placed on fixed or R-disk, and should be packed periodically. Note that the name of this file is dependent on the setting of the config parameter, <ZLFNAME>.
Initialization of this file is not required. If it is not catalogued, however, ZIP will display an error message each time it is called.
4. ASCII Log [Top][Contents]
Using ZIP to Interrogate the ASCII Log Or the TIP TPM log (*new for 4R2*)
(The following information is supplemental to what is now provided in the online help.)
The log-compatible version of ZIP can process an ALAT or TIP TPM file as if it was SDF formatted. All commands (except those used for sorting) are fully functional in this mode. No special options are required - ZIP automatically detects when an input file is in ALAT or TPM format. This is indicated with a message that is printed after the @ZIP processor call, which shows the original name of the file and when it was created. The current log cycle can be processed via the command:
@ZIP SYS$*F010L1(-1). (ALAT files) @ZIP SYS$*F017L1(-1). (TIP TPM files)
(*new for 4R2*) One can also invoke ZIP against the -1 (current) log cycle with the command:
@ZIP,L (Audit files with trail ID = 10 - ALAT logs) @ZIP,T (Audit files with trail ID = 17 - TIP TPM logs)
The following message will then be displayed:
THIS IS AN ASCII LOG FILE - SYS$*F010L1(ccc)[Vn], OPENED yymmdd AT hhmmss or: THIS IS A TIP TPM LOG FILE - SYS$*F017L1(ccc)[Vn], OPENED yymmdd AT hhmmss
Log files produced prior to HMP IX7.1 are version zero, later ones are version one and above. If the version is > 0, the log name and site-id are displayed on the next line.
The following describes ALAT operation only. TIP TPM operation is documented at the end of this section.
When processing a system log, each record is compressed into a simple, standard format that includes the most commonly-used information. This format allows most log records to be displayed in fewer than 80 characters with no significant omissions. The fixed portion is as follows:
1-5 Log record type (5 decimal characters, zerofilled) 6 / 7 Subtype (one decimal character, =9 if greater than 9) 9-12 Month, day 13 : 14-19 Hour, minute, second 21-26 Runid (left justified, spacefilled)
If the log record has an exact or approximate ECL relationship, the command (such as @ASG, @FREE, @XQT) appears in columns 29-36. Not all of these are actual commands but the meaning should be obvious in all cases. Beginning in column 39, additional information is provided, such as file name, program name, etc. To conserve space, certain information has been omitted. It was felt that readability on an 80-column screen was more important than providing every detail present in the log.
For log records that do not have an ECL equivalent (such as console messages) the edited output begins in column 29. Console message text is included in its entirety, despite the occasional screen wrap that results. To eliminate all screen wraps, a REFORMAT can be used to truncate output.
Some log records do not contain any information that is easily represented in an 80-column line. The most common example of this on our system is the type 502 record (performance monitor). Others occur so infrequently that the effort was not expended to reformat them. These records are indicated by the fixed portion only (cc 1-26). If there is additional information you would like to see reformatted, feel free to make changes in element LOGSUB. Basic instructions for doing this are included around line 345, and changes should normally only be necessary between lines 365-1880 and 2215-2265 (approximately). Several users have forwarded their additions to LOGSUB, and their contributions are now part of the base level. Thank you all!
2. Using predefined symbols to select log output
When a log file is opened, ZIP defines the following 7 symbols which can be used with the SELECT command to locate specific information.
Symbol CC Use
TYPE 1-7 Selects log records of specific type DATE 9-12 Selects log records of specific date (mmdd) TIME 14-19 Selects log records of specific time (hhmmss) DT 9-19 Selects log records of spec. date/time (mmdd:hhmmss) RUNID 21-26 Selects log records for a specific run ECL 29-36 Selects specific ECL (@ASG, @FREE, etc) FILE 39-68 Selects occurrences of a specific file
There is no difference between these symbols and those which are user- created with the DEFINE command. For example, < DEFINE TYPE 1:7,A > would create the same symbol with the same attributes. Likewise, the SELECT com- mands illustrated here operate in exactly the same way as they would if used with a non-log format file. The following examples show some typical uses of SELECT for extracting information from the log.
SELECT TYPE='00203' - This will select all console messages.
SELECT RUNID='MAPPER' - This will select all log entries for run MAPPER.
SELECT RUNID='PAYR' AND ECL='@ASG' - This will select all log entries for runs PAYRxx that pertain to facility assignments. Note that if the quoted string is shorter than the comparison field, only the string length is compared.
SELECT ECL='@ASG' AND FILE='SYS$*DLOC$' - Selects all assignments of SYS$*DLOC$.
Unless given at line zero, SELECT will position to the first matching record, but other commands (such as PRINT, LNP) must be used to display a set of selected records. You can display all matching records in a file by SELECTing as above and then giving the < P! > command, but this is very inefficient unless the entire file must be searched. When dealing with a run, for example, it is much better to print the range of records that encompasses the time span of the run if known in advance. If not known, print a few hundred or thousand lines at a time. Don't use print-relative (i.e. P 22) because this will print the next 22 MATCHING records. If the 15th record is the last for the run, the rest of the file will be searched in vain and there will be no further output until the EOF is encountered. A much better way would be the command, < P N N+2000 >. If more than 22 records are matched in this group, output will pause between screens.
Remember that all standard ZIP commands (except for sorting) are fully functional when processing a log file. It is perfectly valid, for example, to use LOCATE or FIND for searching. LOCATE is useful when the target does not always start in the same column (although the SELECT 'contains string' operator (*=) could also be used for this purpose). For quick searches, the new commands LB and FB (like LC, FC without line numbers) can be used to avoid many of the screen wraps that would result from LC and FC.
3. Special modes of output
(*New for 4R2*) An expanded output format which includes the milli- second portion of the timestamp and some additional fields for a few of the specific record types, is available by setting the global 'A' option. When this is done, the log file symbols are redefined, because everything after the timestamp is shifted four columns to the right. If the global 'A' option is not set, the original format is preserved.
Log records are displayed in octal format if the 'D' option is on. The normal edited record is followed with additional lines of octal text, up to 150 words excluding the header. This can be useful in cases where additional information is required. The 'D' option is dynamic and can be enabled and disabled with the ON and OFF commands.
Log records are displayed in raw ASCII text if the 'R' option is on. This is the format in which they occur in the file. The REFORMAT command can be used with raw text to extract information that is not available using the built-in editing feature. When operating in this mode, the predefined symbols (TYPE, RUN, etc.) are of no use, and the runid is not available in text format in most records.
(*New for 4R2*) If both 'D' and 'R' options are on, the entire log record is displayed in octal format, with no preformatting. This is a display-only feature, so octal data is not available for searching, output to a secondary file, or sending to a remote printer. To display records in this mode, use the <CR> or <\> command or position to the desired record with the <+/-number> command. To display a range of records in this format, use the DUMP command. The PRINT command will display ASCII data as before, as if only the 'R' option was set.
4. Efficiency considerations
When using ZIP to process a raw log file, it is important to remember that all text editing is dynamic and must be done for every record during any type of search. It is much more efficient to move about in the file through direct positioning commands than it is to LOCATE or to do any type of record processing with a SELECT in effect.
If you have a log file which will require several long searches, time can be saved by producing an edited extract and using ZIP to interrogate it rather than the raw log. The only disadvantage of this method is the loss of the ability to use the 'D' and 'R' options with the extract.
This method must also be used if it is necessary to use the sort feature. Sorting is not supported when processing a raw log because of a memory usage conflict with the internal runid table, which must be open-ended. There are no such constraints when reading a log extract, because it is written in SDF format and does not require a runid table.
@ASG,T LOG-EXT,F/1000//2500 . Max size should be 50% of log maximum @ZIP <raw-log>. EXT! LOG-EXT. EXIT
@ZIP LOG-EXT. DEF,L . This command will define all of the log SELECT symbols <Other commands from this point on are the same.>
5. TIP TPM Log [Top][Contents]
Using ZIP to Interrogate the TIP TPM log
The following information was supplied by Rick Onsgard to complement the modifications that allow ZIP to read TIP TPM audit trails. Some of the features of this mode are similar or identical to operation with ALAT trails. This documentation focuses on the differences. WRC
The file name of the "current default" TPM log cycle on a system is: SYS$*F017L1(-1) For all TPM log types, information from their headers is displayed as follows: . >13/03 0426:140248.538 *10QFD PXCRTI l$term . The first field (13/03) is the TPM log entry type and subtype. The second field (0426:140248.538) is the date (0426) and time (140248.538) that the TPM log entry was created. The third field (*10QFD) is the RUNID which made the entry.
*New in 6R2A* Normally a single space follows the RUNID, but if log information is lost because of very high transaction volume, the <#> character in this position indicates one or more transactions were not logged between this record and the one that precedes it.
The fourth field (PXCRTI) is the transaction code of the TIP transaction which made the entry (blank for demand/batch). The fifth field (l$term) is the TPM log entry type. Most TPM log entry types/subtypes have additional information edited out. Some examples are as follows: . l$term: <header info> hvtip/a iload sups=57 ios=5 . The first additional field (hvtip/a) is the transaction type where "/a" indicates absolute and "/z" indicates ZOOM. The second field (iload) indicates how the transaction came into execution (this differs from the ASCII log entry subtypes which indicates how a transaction terminates). The third field (sups=57) is total sups in 200 microsecond granularity (divide by 5000 for second granularity). The fourth field (ios=5) is the total number of I/Os done. . l$fcss: <header info> fc$rd fn=101 wds=58 srec=18 . The first additional field (fc$rd) is the FCSS function. The second field (fn=101) is the TIP file number. The third field (wds=58) is the number of words requested. the fourth field (srec=18) is the starting record number. Note: For FCSS freespace functions the "srec" field is replaced with the freespace record key as follows: l$fcss: <header info> fc$al fn=1273 wds=112 rkey=1,1026 The "rkey" field (1,1026) contains the freespace record type (1) and the starting record number (1026). This corresponds to an octal record key of "000100002002". . l$user: <header info> major=2 minor=1 wds=4096 . The first additional field (major=2) is the major code. The second field (minor=1) is the minor code. The third field (wds=4096) is the number of words logged.
All comments in the documentation referring to reading and processing of the ASCII log trail also apply to the TPM trail with the exception of the "predefined symbols". When a TPM log file is opened, the predefined symbols (which can be used with the "SELECT" command) are as follows:
Symbol CC Use
TYPE 1-5 Selects TPM log records of a specific type. DATE 7-10 Selects TPM log entries for a specific date. TIME 12-21 Selects TPM log entries for a specific time. DT 7-21 Selects TPM log entries for specific date:time. RUNID 23-28 Selects TPM log entries for a specific RUNID. TCODE 30-35 Selects TPM log entries for specific TXN code. TPM 37-42 Selects TPM log entries for specific TPM type.
SELECT TYPE='13/03' - This will select all TIP transaction termination entries SELECT DATE='0918' - This will select all TPM entries made on September 18 SELECT TIME='140248.538' - This will select all TPM entries made at 14:02:48.538 SELECT DT='0918:140248.538' - Selects all entries made on September 18 at 14:02:48.538 SELECT RUNID='*10QFD' - Selects entries made by the transaction with RUNID *10QFD SELECT TCODE='PXCRTI' - Selects entries made by the transaction code PXCRTI SELECT TPM='l$fcss' - Selects entries with the TPM type l$fcss (FCSS entries) Note that "partial" selects can also be performed such as: SELECT TIME='140248' - Selects all entries made at 14:02:48 Also note that the "ON D" command can be used to dump all information in the TPM log entries in OCTAL.
1. ZIP - Rapid SDF Display
2. More Info
3. Release Doc
4. ASCII Log
5. TIP TPM Log