IMS command batch processing overview

Edit online

When the IMS command processor of IMS Administration Tool runs as a batch program, it can run as an IMS BMP, IMS DL/I batch, or standard z/OS® batch job.

The only significant difference between the types of batch jobs is how the IMS Administration Tool determines where to route the commands.

When the IMS command processor runs as a standard z/OS batch job, command routing is determined by the EXEC statement PARM specification, which can be one of the following specifications:
  • //job-step EXEC PGM=ATYCMD00,PARM='IMSID=imsid'
  • //job-step EXEC PGM=ATYCMD00,PARM='GROUP=ims-command-group-id'
When the IMS command processor is run as an IMS BMP or IMS DL/I batch job, command routing is determined by one of the following specifications. IMS Administration Tool looks for these specifications in the following order and applies the first one found.
  1. 'GROUP=ims-command-group-id' in the EXEC PARM statement
    • DL/I batch 
      //job-step EXEC PGM=DFSRRC00,
//              PARM=(DLI,ATYCMD00,psb,,,,,,,,,imsid,,dbrc,irlm,irlmnm,,,,
                'GROUP=ims-command-group-id')
    • BMP 
      //job-step EXEC PGM=DFSRRC00,
//              PARM=(BMP,ATYCMD00,psb,,,,,,,,,,,imsid,,,,,'GROUP=ims-command-group-id')
    If you use a DLIBATCH or IMSBATCH procedure, specify APARM='GROUP=ims-command-group-id'.
  2. The IMSID from the PARM statement
  3. The IMSID in SDFSRESL(DFSVC000)

Sample JCL for each type of batch job can be found in the SATYSAMP sample library:

  • Sample JCL for an IMS BMP is in member ATYBMP.
  • Sample JCL for an IMS DL/I batch is in member ATYDLI.
  • Sample JCL for a standard z/OS batch is in member ATYBATCH.

The following sample JCL member ATYBMP from the SATYSAMP sample library contains a few options specified for the ATYOPTS ddname input statement, including the PRESCAN option:

//ATYBMP    JOB  (TECH),ATYBMP,CLASS=A,MSGCLASS=H,                              
//      REGION=4M,NOTIFY=&SYSUID,COND=(0,NE)                                    
//*                                                                             
//*      THIS SAMPLE JCL WILL EXECUTE THE ATY/IMS COMMAND PROCESSOR             
//*   AS AN IMS BMP JOB.                                                        
//*                                                                             
//*      THE FOLLOWING CHARACTER STRINGS MUST BE TAILORED:                      
//*   ##ATYLOAD   - DEFINES THE DSN OF THE LOAD LIBRARY INTO WHICH              
//*                 ATY WAS INSTALLED (SATYLOAD).                               
//*   ##SDFSRESL  - MUST BE THE NAME OF YOUR IMS SDFSRESL.                      
//*   ##IMSID     - MUST BE THE NAME OF THE IMS WHERE THE BMP WILL              
//*                 ATTACH.                                                     
//*   ##PSB       - CAN BE ANY APPLCTN DEFINED IN THE IMS SYSGEN                
//*                 WITH THE GPSB= PARAMETER.                                   
//*                                                                             
//STEP01  EXEC PGM=DFSRRC00,                                                    
//          PARM='BMP,ATYCMD00,##PSB,,,,,,,,,,,##IMSID'                         
//STEPLIB  DD  DISP=SHR,DSN=##ATYLOAD                                           
//         DD  DISP=SHR,DSN=##SDFSRESL                                          
//SYSABEND DD  SYSOUT=*                                                         
//ATYLIST  DD  SYSOUT=*                                                         
//ATYOPTS  DD  *                                                                
PRESCAN=YES NOFEOV=YES SETRC=16                                                 
//*                                                                             
//ATYSYSIN DD  *                                                                
/STA DB DI21PART ACCESS UP