Online (BMP) processing

The primary commands (VERIFY and RESYNC) that are associated with the

BMC AMI Fast Path Indexer for IMS

verify and resynchronize functions can be executed in an IMS batch message processing (BMP) region.

BMP mode is characterized by processing DEDB areas that are online to one (or more) IMS control regions. DEDB areas that are processed by the BMC AMI Fast Path Indexer for IMS product functions in BMP mode are available to applications executing simultaneously.

This topic contains the following information:

Execution JCL for BMP processing

The following figure shows the basic JCL that is required for execution of the BMC AMI Fast Path Indexer for IMS product verify and resynchronize functions in BMP mode.

This JCL assumes dynamic allocation of the OLCSTAT, MODSTAT, IMSACBA, IMSACBB, PFXLIBA, and PFXLIBB data sets, which are required.

//PFP EXEC PGM=DFSRRC00,REGION=0M,
// PARM=(BMP,PFPMAIN,psbname)
//STEPLIB DD DISP=SHR,DSN=BMC.PFP.LOAD
// DD DISP=SHR,DSN=IMSVS.RESLIB
//PFPSYSIN DD *
--- control statements ---
/*

Other parameter values for the PARM keyword might be required for BMP regions at your site. The standard catalogued procedure that is supplied with IMS (IMSBATCH) can be used for BMC AMI Fast Path Indexer for IMS.

Note

The PFXLIB, PFXLIBA, and PFXLIBB DD statements are only needed for processing PFX indexes.

Region size for BMC AMI Fast Path Indexer for IMS utility functions

To ensure optimum performance, BMC recommends that you request the maximum available storage for execution of the BMC AMI Fast Path Indexer for IMS utility functions. Maximum available storage is normally requested by specifying REGION=0M on the EXEC statement for the JOB step. Some installations might have different requirements. Check with your MVS systems programmer to determine how to request the maximum REGION size.

STEPLIB requirements for BMC AMI Fast Path Indexer for IMS utility functions

BMC recommends that the PFP installation library appear first within the STEPLIB concatenation.

If any other library precedes the product installation library, you must ensure that this library does not contain a member name that duplicates a member within the PFP product library. It is not necessary that all data sets listed within the STEPLIB concatenation be APF authorized.

Identifying the functions to be performed with PFPSYSIN control statements

The PFPSYSIN control statements identify the functions to be performed.

The DBD keyword is required for BMP functions and identifies the database (DBD name) to be processed by the command. The DBD name must be contained within the PSB specified in the PARM keyword on the EXEC statement for the JOB step. The processing options (PROCOPT) for the database must be consistent with the function being requested. Multiple BMP function commands can be specified within the PFPSYSIN control statements.

Note

No parallel processing of commands is performed in BMP execution mode. Each command is executed serially in the order specified.

Creating the PSB for BMP processing

The following requirements apply for creating the program specification block (PSB) for BMP processing:

You must create a separate PCB statement for the primary DBD and each index DBD. If an index is partitioned, each partition DBD must have a separate PCB statement.
Each index PCB statement and partitioned index PCB statement must be specified in the order listed in the primary DBD.
The PCB statement for the primary DEDB must have SENSEG statements for the hierarchical path for the source segments.
The PCB statement for each secondary index database must have SENSEG statements for the segment specified in the DBD.
For the VERIFY command, the PROCOPT should be specified as read (G). For the RESYNC command, the PROCOPT must have read and write (A) capability.
The LANG parameter in the PSBGEN statement must be set to COBOL or ASM.

Identifying the DEDB area to be processed

In BMP mode, the IAREA keyword must not be specified.

Access to online data sets

The BMC AMI Fast Path Indexer for IMS product functions that are executing in the BMP mode access the data sets by using IMS control region services. All facilities of the online IMS control region are supported, including Multiple Area Data Sets (MADS) and the Virtual Storage Option (VSO). No areaname DD statement is required, and any areaname DD statement that is supplied is ignored.

The functions access the RECON data sets by using DBRC region services. The RECON1, RECON2, and RECON3 DD statements are not required. If any of these statements is supplied, it is ignored.

IMS commands

IMS/VS commands are available to monitor and control an online DEDB during BMC AMI Fast Path Indexer for IMS BMP function processing.

/DISPLAY ACTIVE lets you to display the status of all active IMS regions. This display includes the BMP region that is used to execute the Fast Path/EP online functions.
/STOP REGION regid lets you to terminate the Fast Path region at the next utility checkpoint. regid is the region ID number that is assigned to the Fast Path Region. You can determine the regid by displaying it with the /DISPLAY ACTIVE command.

Warning

/STOP REGION ABDUMP or CANCEL can cause a U113 abend in the IMS control region.