Sample installation jobs to modify IGYCDOPT compiler option defaults

Enterprise COBOL provides two sample installation jobs that you can modify and then use to change the defaults for compiler options. The first sample job, IGYWDOPT, provides an example of how to change the IBM®-supplied defaults for compilers. This job then uses SMP/E to install the newly built compiler option default module, IGYCDOPT, into SIGYCOMP. The second sample job, IGYWUOPT, provides an example of how to override compiler options that have been fixed. This job will place the newly built compiler option default module, IGYCDOPT, into an application execution data set, that can then be included in the application's STEPLIB DD in the compile JCL. These jobs are located in the COBOL sample data set IGY.V6R3M0.SIGYSAMP.

IGYWDOPT
This sample installation job can be used to change the IBM-supplied compiler option defaults. It will create a new IGYCDOPT module and then apply it into SIGYCOMP using SMP/E. If SMP/E is used to install the COBOL compiler, then use this sample installation job to change the IBM-supplied compiler option defaults.
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
                   INVDATA=NO
           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.

IGYWUOPT
This sample installation job can be used to change the IBM-supplied compiler option defaults. If SMP/E is not used to install the COBOL compiler, which is a rare case, then this sample installation job can be used to change the IBM-supplied defaults and copy the new IGYCDOPT module into SIGYCOMP. This job can also be used to create an IGYCDOPT compiler option default module that can be placed into an application execution data set and then referenced by the application in the STEPLIB DD in the compile JCL. In this way, compiler option defaults in SIGYCOMP (IGYCDOPT) that are fixed and cannot normally be overridden can be overridden.