Creating a site default table for FP Stand-alone DB Sensor

To generate a site default table, code the FP Site Default Generation utility JCL, run the job, and assemble and link-edit the source code.

About this task

The following figure shows the steps for creating the site default table. The numbers in the figure match the numbers in the procedure steps.

Figure 1. Steps for creating a site default table (FP Stand-alone DB Sensor)
This figure shows the steps for creating a site default table. The details of the steps are described after this figure.

Procedure

  1. Write the EXEC and the DD statements.

    For the format of the EXEC statement and the list of DD statements, see EXEC and DD statements for the FP Site Default Generation utility.

  2. Run the FP Site Default Generation utility (HFPSTGEN) job step to create the source code for HFPSCTL0.

    Ensure that the return code is 0. Also check the Site and System Default report to ensure that the options that you specified are set in the HFPSCTL0.

    See the following topics for more information:
  3. Assemble and link-edit the HFPSCTL0 source code.

    To create the site default table, assemble and link the SYSPUNCH data set that is generated by HFPSTGEN.

Example

The following example shows how to specify the FP Site Default Generation utility JCL to create source code for HFPSCTL0.

This sample JCL is provided in the IMS FP Solution Pack product sample JCL data set (SHFPJCL0).

Figure 2. JCL for creating the site default table (FP Site Default Generation utility) (Part 1 of 2)
//HFPSCTL0 JOB                                                         
//*-------------------------------------------------------------------*
//* JOB NAME = HFPSCTL0                                               *
//*-------------------------------------------------------------------*
//*       LICENSED MATERIALS - PROPERTY OF IBM                        *
//*                                                                   *
//*       5655-W14                                                    *
//*                                                                   *
//*       COPYRIGHT IBM CORP. 2011, 2013                              *
//*                                                                   *
//*       THE SOURCE CODE FOR THIS PROGRAM IS NOT PUBLISHED OR        *
//*       OTHERWISE DIVESTED OF ITS TRADE SECRETS, IRRESPECTIVE       *
//*       OF WHAT HAS BEEN DEPOSITED WITH THE U.S. COPYRIGHT OFFICE.  *
//*                                                                   *
//*-------------------------------------------------------------------*
//*                                                                    
//*=================================================================== 
//* Description: This JCL generates a site default module,     
//*              HFPSCTL0, which can be used by FP Stand-alone 
//*              DB Sensor.                                    
//*                                                                    
//*=================================================================== 
//*                                                                    
//*  A) Make the following global changes for this job:                
//*                                                                    
//*     1. Modify the job statement to suit your environment.  
//*                                                                    
//*     2. Substitute your dsname high level qualifier (HLQ) for       
//*        IMS FP Solution Pack  data sets for the string              
//*        "$hfphlq.SHFPLMD0".                                         
//*        'change $hfphlq.SHFPLMD0 your_hfp_hlq.SHFPLMD0 all' 
//*                                                                    
//*     3. Substitute your dsname high level qualifier (HLQ) for your  
//*        user library to store the site default module (HFPSCTL0)    
//*        for the string "$hfphlq.userlib".                           
//*        'change $hfphlq.userlib your_userlib all'           
//*                                                                    
//*     4. Substitute your group-name or unit number for UNIT          
//*        parameters for the group-name "$sysda", if applicable.      
//*        'change $sysda your_sysda all'                     
//*                                                                    
//*  B) Specify commands and keywords to define the site               
//*     default values on HFPCRE.HFPSYSIN DD statement.                
//*                                                                    
//*  C) Submit the job.                                                
//*                                                                    
//*  D) Confirm all return codes are zero.                             
//*                                                                    
//*  E) Concatenate your_userlib TO JOBLIB OR STEPLIB.                
//*                                                                   
//*===================================================================
Figure 3. JCL for creating the site default table (FP Site Default Generation utility) (Part 2 of 2)
//*                                                                    
//SITEMOD  PROC                                                        
//*                                                                    
//HFPCRE  EXEC PGM=HFPSTGEN,PARM='GEN',REGION=2M                       
//STEPLIB  DD  DISP=SHR,DSN=$hfphlq.SHFPLMD0                           
//SYSPRINT DD  SYSOUT=*                                                
//SYSMSG   DD  SYSOUT=*                                                
//SYSPUNCH DD  DISP=(NEW,PASS,DELETE),                                 
//           SPACE=(TRK,(1,1)),UNIT=$sysda,DSN=&&SOURCE                
//*                                                                    
//ASM      EXEC PGM=ASMA90,PARM='OBJECT,NODECK',COND=(4,LT,HFPCRE)     
//SYSLIB   DD  DISP=SHR,DSN=SYS1.MACLIB                                
//SYSLIN   DD  DSN=&&OBJLIB,DISP=(NEW,PASS,DELETE),                    
//             UNIT=$sysda,SPACE=(TRK,(1,1))                           
//SYSPRINT DD  SYSOUT=*                                                
//SYSUT1   DD  UNIT=$sysda,SPACE=(TRK,(1,1))                           
//SYSIN    DD  DISP=(OLD,DELETE,DELETE),DSN=&&SOURCE                   
//*                                                                    
//LKED     EXEC PGM=IEWL,COND=(4,LE,ASM)                               
//SYSPRINT DD  SYSOUT=*                                                
//SYSLIN   DD  DSN=&&OBJLIB,DISP=(OLD,DELETE,DELETE)                   
//SYSUT1   DD  UNIT=$sysda,SPACE=(TRK,(1,1))                           
//SYSLMOD  DD  DISP=OLD,DSN=$hfphlq.userlib(HFPSCTL0)                  
//*                                                                    
//         PEND                                                        
//*                                                                    
//*=================================================================== 
//* <<< DEL/DEF SITE DEFAULT LOAD MODULE LIBRARY >>>                   
//*=================================================================== 
//SITECRE EXEC SITEMOD                                                 
//HFPCRE.HFPSYSIN DD *                                                 
  GLOBAL                                                               
         ITKBSRVR=FPQSRV01                                             
/*                                                                     
//*

What to do next

When you code the DB Sensor JCL to run a DB Sensor job, you must concatenate the load module library in which HFPSCTL0 resides to the STEPLIB DD of the DB Sensor JCL.

You can always check the options that are set in the site default table by running the FP Site Default Generation utility with the PARM='REPORT' option. When you specify this option, the utility prints the keywords and their parameters that are set in the site default table in the Site and System Default report.

The following example shows how to print the keywords and the parameters that are defined in HFPSCTL0.

Figure 4. JCL for printing the contents of the site default table (FP Site Default Generation utility)
//*=================================================================== 
//* <<< DEL/DEF SITE DEFAULT LOAD MODULE LIBRARY >>>                   
//*=================================================================== 
//HFPREP  EXEC PGM=HFPSTGEN,PARM='REPORT',REGION=1M            
//STEPLIB  DD  DISP=SHR,DSN=$hfphlq.SHFPLMD0                           
//         DD  DISP=SHR,DSN=IMSXXA.SDFSRESL                            
//         DD  DISP=SHR,DSN=IMSXXA.PGMLIB                              
//         DD  DISP=SHR,DSN=$hfphlq.userlib       
//*                                                                    
//SYSPRINT DD  SYSOUT=*                                                
//SYSMSG   DD  SYSOUT=*                                                
//*