Information

This site will undergo a brief period of maintenance on Friday, 18 December at 12:30 AM Central/12:00 PM IST. During a 30 minute window, site availability may be intermittent.

Installing the QPF Test Applications


This section describes the steps for installing the Message Advisor QPF Test Applications.

The QPF Test Applications are programs that simulate various queue overflow conditions in order to test both the Message Advisor QMR functions and the QPF functions.

Warning

Note

Installing the QPF Test Applications is an optional task; however, BMC recommends that you install these test applications as part of the configuration process.

To install the QPF Test Applications in your IMS test environment:

  1. Define the sample applications to your IMS system.You can use either of the following methods to define the sample applications:
    • Add the Test Application Stage1 definition to your IMS Stage1 source and perform an IMS SYSGEN.

      Member QPF$STG1 of MAQSAMP contains sample Stage1 source. Two batch message processing programs (BMPs) and one message processing program (MPP) with ten transactions are supplied. You can add additional transactions and change the definition names to meet your needs. Any name changes must be propagated through the remaining steps, where appropriate.

    • After reviewing the Test Application Stage1 definitions, use Message Advisor to add them to your IMS system.
  2. Make changes as needed for security.Make any appropriate definitions for transaction security using ACF2 or RACF.
  3. Perform an IMS PSBGEN and ACBGEN.Member QPF#PSB of the MAQCNTL library contains a sample PSBGEN/ACBGEN job stream. This job uses MAQSAMP members QPF$PSB1, QPF$PSB2, and QPF$PSB3 as input.

    Modify QPF#PSB as necessary to match any changes that you made to the Stage1 SYSGEN source and where noted to match your data set names.

  4. Build the message format service (MFS) format for use with the QPF Test Application MPP.Member QPF#MFS of the MAQCNTL library contains a sample MFSGEN job stream. This job uses MAQSAMP member QPFMFS as input.

    Warning

    Note

    If any of the 3270 models that are displayed in QPFMFS are not defined to your IMS system, comment out the appropriate DEV statement and the UNSTACK statement that immediately follows the DEV statement.

    For example, if Model 4 is not defined to your IMS, comment out or remove the following statements:

    DEV TYPE=3270-A04,FEAT=IGNORE,SYSMSG=R23003
    UNSTACK,KEEP
  5. Assemble and link-edit the routine that is used by the QPF Test Applications.Member QPF#WTOR of the MAQCNTL library contains the assembly/link-edit JCL. This job will create a load module that is referenced by QPF#COMP. The library in the SYSLMOD DD statement in this job must also be used in QPF#COMP.
  6. Compile and link-edit the QPF Test Applications.Member QPF#COMP of the MAQCNTL library contains the compile JCL. This job will use MAQSAMP members QPFMPP and QPFBMP to compile the MPP and both of the BMPs.

    Update the JCL according to the comments within the member.

    Warning

    Note

    If you are using the language environment (LE) in your IMS system, the LE library must be higher than other language libraries (COBOL and so forth) in the MPP/BMP STEPLIB concatenation.

    The QPF Test Applications will be active the next time that you bring up your IMS system. For information about using the QPF Test Applications, see the Message Advisor for IMS User Guide.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

System Administration for IMS 2.7