gtpm3m0s | Multi-Processor Interconnect Facility Reference |
A list of acceptable keywords for MPIF post-processing has been provided below.
The keywords are:
If a time is provided (HH.MM.SS), this program will select all messages within the hour (HH), on-or-after the minute (MM) specified.
Example: 02.15.45 says "Give me any messages on or after 2:15 PM (through 2.59.59)."
Each of the above keywords (if specified) must be entered as spelled above; using uppercase or lowercase letters. The arguments must be entered as they appear on the MPIF log tape, using the DCTTRC DSECT for format lengths. If arguments are truncated, when entered as KEYWORD= arguments, they will be blank-padded from left to right. That is, a 4-character USER=aaaa, will be placed in an 8-character field with blanks in positions 5 through 8. Blank padding will only occur for alphanumeric fields that include USER, DEST, ORG, PATH, CPU1 AND CPU2.
Numeric-only arguments (BLK=, MSG=, and DUR= ) must be zero-filled, according to their size. Both the argument size and range of values have been specified below:
Any mixture of keyword parameters can be specified for PRINT and COMPARE commands. With the PRINT command, at least one parameter must be specified. With the COMPARE command, however, four keyword parameters are required; denoted by an asterisk (*) in the keyword list. For quick reference, however, these required COMPARE keywords are repeated below:
If several search arguments are used, only those messages that meet the search criteria will be printed on reports. The following is an example of concatenated search parameters for report generation:
PRINT USER=mpif01,DEST=tpf01,ORG=tpf02
A program will scan one mounted trace tape for MPIF MSRB logged entries. If the record ID = X'00E3', this program will then scan for a USER=mpif01, ORG=tpf02 and DEST=tpf01. Only those messages that were sent from tpf02 to tpf01 under USER=mpif01 will be printed.
When an argument is specified (for example, tpf01), the use of uppercase or lowercase letters depends solely on the conventions used in MPIF.
PRINT BLK=0010,USER=mpif01,DEST=tpf01,ORG=tpf02
If BLK=0010 is specified, then only 10 4K Blocks will be printed if they contain a USER of mpif01, a DEST of tpf01 and ORG of tpf02. Note that the BLK= parameter only affects the number of blocks appearing on reports, not the number of blocks scanned on the log tape.
COMPARE CPU1=TPFXX1,CPU2=TPFXX2,DATE=15Dec,TIME=10:00:00, DEST=tpf01
In the above example, a CPU-to-CPU message analysis will be performed for December 15 from 10:00AM through 10:59AM only for those messages sent from TPFXX1 to TPFXX2 with a destination of tpf01. TPFXX2's trace tape will also be searched for the same date and time for messages received by tpf01.
The user can reduce the volume of information being printed by using two volume-associated keywords. They include:
Finally, two commands were added that enable the user to bypass keyword entry or cancel the request. DEFAULT can be used instead of PRINT to bypass entering parameters. If used, it equates to: PRINT 1,000 4K blocks; all messages within a 4K block. The CANCEL command will cause the program to terminate.
The following list summarizes available commands for MPIF post-processing.
Only the COMPARE and PRINT commands can have keywords that provide a search criteria. When provided, each keyword must be entered as formatted below:
COMMAND KEYWORD=ARGUMENT,KEYWORD=ARGUMENT
The command must begin in column 1. The first keyword must be separated from the command with a blank. If the user enters more than one KEYWORD=ARGUMENT search parameter, each parameter must be separated by a comma to signify continuation. Imbedded blanks are prohibited between a list of KEYWORD=ARGUMENT entries. The program that reads and interprets the user's entry will scan the entry from right to left, looking for a blank (end of KEYWORD=ARGUMENT list) or comma as the last character entered. If a comma is found, the program will expect a second (continuation) record that begins in column 1.