gtpm3m0vMulti-Processor Interconnect Facility Reference

Installing MPIF Post-Processing Programs

MPIF post-processing programs have been distributed on a standard TPF tape in assembler language source statements. These programs must be copied to a DASD data set prior to compilation using an Assembler Level H compiler. In an MVS environment, the user would typically create a partitioned data set with the following sample attributes:

MPIF.POST.SOURCE  DCB=(DSORG=PO,LRECL=80,BLKSIZE=nnnn),
                       SPACE=(CYL,(2,2,1))

where: nnnn must be a user provided block size appropriate to the device type (typically BLKSIZE=800).

Each program would be copied as a member to the above PDS (partitioned data set) prior to assembly. The TPF DSECT names DCTTRC, REGEQ, and REGEQ1 should be moved to the installation's TPF macro library prior to assembly. If JCL is used during assembly, a //STEPLIB or //JOBLIB statement would be used to reference the TPF macro library, for example,

//STEPLIB  DD    DSN=TPF.MACLIB,DISP=SHR

prior to program assembly. Once the programs and DSECTs have been placed in their respective PDS libraries, the user would then activate a standard assembler procedure to assemble the following programs:

CBQ4 PGM
Used to verify user request (parameters), write page 1 of report and (a) produce a report of one CPU's trace tape or (b) set return codes to schedule the CBQ5 program.

CBQ5 PGM
Used to (a) read two CPU log tapes if COMPARE was requested and (b) extract trace messages that meet user's search arguments.

CBQ6 PGM
Used to sort extracted files built by CBQ5, producing a summary report on CPU-to-CPU message traffic.

CBQPRT PGM
Used to generate a trace summary report.

DCTTRC DSECT
TPF DSECT describing the MPIF trace log tape's format; referenced in CBQ4 and CBQ5 programs.

REGEQ DSECT
TPF DSECT containing register EQU statements for registers.

REGEQ1 DSECT
TPF DSECT containing register EQU statements for registers (referenced by REGEQ).

Notes:

  1. Only the programs are assembled. Referenced DSECTs are dynamically copied into the programs during assembly.

  2. If the system initialization program (SIP) is used to build TPF STAGE I in an MVS environment, the above-mentioned programs will be assembled and link-edited during the build process. The user need only request the name of the library to reference it using a //JOBLIB or a //STEPLIB JCL statement during program execution as shown below:
    //STEPLIB  DD   DSN=TPF.24.LOADLIB,DISP=SHR