Sample installation jobs

Enterprise COBOL provides two sample installation jobs that you can modify and then use to change the defaults for compiler options. One sample job, Start of changeIGYWDOPT, End of change provides an example of how to change the IBM-supplied defaults for compilers. The other sample job, Start of changeIGYWUOPT,End of change provides an example of how to override compiler options that have been fixed. These jobs are located in the COBOL sample data set Start of changeIGY.V6R2M0End of change.SIGYSAMP.

IGYWDOPT
Use this sample installation job to change the IBM-supplied defaults using SMP/E.
Start of change
If IGYWDOPT is being run for the first time, complete the following steps:
  1. Change the job card to meet your system requirements.
  2. Change these items:
    • #globalcsi (Make it the CSI name of the installation site)
    • #tzone (Make it the TARGET ZONE name of the installation site)
  3. Copy member SIGYSAMP(IGYCDOPT) into SIGYSAMP(IGYWDOPT) in place of the comment lines following the ++ SRC statement in step DOPT.
  4. Modify the IGYCDOPT text that was just copied in so that it contains the list of compiler options that need to be overridden. For example:
             COPY IGYCDOPT                                                                                          
               IGYCDOPT CSECT                                                                                                
               IGYCDOPT AMODE ANY                                                                                      
               IGYCDOPT RMODE ANY                                                                                      
                        IGYCOPT ARCH=10,                                                               X
                                OPTIMIZE=*2,                                                           X
                                NUMCHECK=(ZON,PAC,BIN,MSG),                                            X
                                ZONEDATA=NOPFD                                                                
                        END   IGYCDOPT   
    Use the continuation "X" in column 72 as needed.
  5. Run IGYWDOPT to receive and apply the usermod to create a customized version of MOD(IGYCDOPT).
  6. Important: Save a copy of the modified SIGYSAMP(IGYWDOPT) for future reference.

    CAUTION: Do not ACCEPT the usermod! Accepting the usermod makes it impossible to RESTORE it later in SMP/E when needed.

If MOD(IGYCDOPT) is being changed by an IBM® PTF and requires a rerun of the SIGYSAMP(IGYWDOPT) job, complete the following steps:
  1. RESTORE the usermod created by the IGYWDOPT job. This is done via the SMP/E command RESTORE SELECT (IGYWDOP). Doing this will restore MOD(IGYCDOPT) back to the previous IBM PTF level, which will then allow the new IBM PTF to apply properly.
  2. Apply the IBM PTF.
  3. Change the rework date by changing the REWORK parameter on the ++ USERMOD statement to the date the changes are being made.
  4. Add the proper "PRE( )" statement after the "FMID( )" statement. This is typically the PTF number that was just applied. See the technote to determine what PRE statement to add if an error occurs.
  5. Using the SIGYSAMP(IGYWDOPT) backup member as a reference and referring to any options that may have been added or modified in SIGYMAC(IGYCOPT), update IGYWDOPT so that it contains the list of compiler options that need to be overridden.
  6. Rerun IGYWDOPT to receive and apply the usermod to recreate a customized version of MOD(IGYCDOPT).
  7. Important: Save off a copy of the modified SIGYSAMP(IGYWDOPT) for future reference.

IGYWDOPT should run with a condition code of 0.

Check the IGYNNNN informational messages in the ASSEMBLER SYSPRINT data set to verify the options that will be in effect when the new IGYCDOPT module is used.

End of change
IGYWUOPT
Use this sample installation job to create a module outside of SMP/E in which you can specify different defaults if it becomes necessary to override compiler options that have been fixed with the IGYCDOPT program.