IMSCTF macro removal

In IMS 15, the IMSCTF macro is removed to simplify IMS system definition and generation.

If the IMSCTF macro is specified, IMS System generation stage 1 assembly issues message G122 in an MNOTE 2, which results in a return code of 2 for the assembly.

Migration considerations

With this enhancement, options that you previously defined in the IMSCTF macro can be defined in IMS 15 by using the DFSPBxxx member of the IMS PROCLIB data set, JCL, or the DFSIDEF0 module. If you do not migrate the values that you previously specified on the IMSCTF macro, default values are used by IMS instead.

Table 1. Methods you can use in IMS 15 to specify previously defined IMSCTF macro parameters, and default values for the parameters in IMS 15
IMSCTF macro parameter	How to specify the parameter for IMS 15	Default value in IMS 15
CPLOG=	Use one of the following methods: The CPLOG= parameter in the DFSPB`xxx` member The CPLOG= parameter in JCL The /CHANGE CPLOG command In previous IMS versions, the CPLOG in the IMSCTF macro could be coded as an exact value. In IMS 15, you can no longer do this. You must use K or M. K means 1024, and M means 1024*1024.	500,000
LOG=	If you specified LOG=(DUAL) in the IMSCTF macro, use the sample DBBBATCH, DLIBATCH, IMSCOBGO, or IMSPLIGO procedures and remove the asterisk () for the IEFRDER2 DD statement. If you specified LOG=(,MONITOR) in the IMSCTF macro, use the sample DBC, DCC, or IMS procedures and remove the asterisk () for the IMSMON DD statement.	No default values are provided.
PRDR=	Use one of the following methods: The PRDR= parameter in the DFSPB`xxx` member The PRDR= parameter in JCL	IMSRDR
RDS=	Use one of the following methods: The RDS= parameter in the DFSPB`xxx` member The RDS= parameter in JCL	4096
SVCNO=	Use one of the following methods to specify a type 2 SVC number: Important: If you use the Open Database Access (ODBA) interface or the database resource adapter (DRA) and you do not want to use the default value of 254 for the type 2 SVC number, you can define the number only by using the DFSIDEF macro of the DFSIDEF0 module. The SVC2= parameter in the DFSPB`xxx` member The SVC2= parameter in JCL Specify the following code in the DFSIDEF0 module: `DFSIDEF TYPE=PARM SVC2=` To specify a type 4 SVC number, specify the following code in the DFSIDEF0 module: `DFSIDEF TYPE=PARM SVC4=`	The default value for the type 2 SVC number is 254. The default value for the type 4 SVC number is 255.

For detailed information on how to migrate the parameters that you specified on the IMSCTF macro, see IMSCTF macro removal migration considerations.

Changes to installing and defining IMS

The Installation and Verification Program (IVP) is modified to assist in re-linking the type 2 and type 4 SVC routines.

The Syntax Checker is modified to assist in specifying the new DFSPBxxx member parameters.

Changes to troubleshooting for IMS

For a list of the messages and codes that are new or changed for this enhancement, see the IMS messages and codes row in the table in Documentation changes.

For a complete list of all of the new, changed, and deleted messages, and abend codes in IMS 15, see Message and code changes in IMS 15.

Documentation changes

The following table lists the publications that contain new or changed topics for the IMSCTF macro removal enhancement. Publications that are not impacted by this enhancement are not included in the table.

Table 2. Links to topics that have new or changed content for this enhancement
Publication	Links to topics
Release planning	General planning information for IMS 14 IMSCTF macro removal migration considerations (new) New messages and codes for IMS 15 IMSCTF macro removal (new) (this topic)
Installation	Execution data sets
System definition	Overview of the IMS system definition process Coding IMS macros that define the system Selecting the appropriate macros to define your system (updated to remove references to the IMSCTF macro) Designing the IMS system Setting a checkpoint frequency Allocating and cataloging IMS system resources IMS online data sets Allocating log data sets IMS system definition examples IMS DB/DC environment System configuration macro statements IMS Multiple Systems Coupling system definition examples IMS DBCTL environment Macros used in IMS environments IMSCTF macro IMSCTRL macro Procedures used in IMS environments Parameter descriptions for IMS procedures RC= through RVFY= procedure parameters RDS= parameter for procedures (new) SVC2= through TLIM= procedure parameters SVC2= parameter for procedures DD statements for IMS procedures DBBBATCH procedure DBC procedure DCC procedure DLIBATCH procedure IMS procedure IMSCOBGO procedure IMSPLIGO procedure IMSRDR procedure Other control statements used in IMS environments IMS Installation Defaults module (DFSIDEF0)
System administration	IMS system administration considerations and tasks z/OS interface considerations > z/OS interface considerations for IMS > Installing required IMS links to z/OS IMS SVC modules Tuning the system > Initializing z/OS and IMS parameters for tuning Choosing IMS options for performance
IMS messages and codes	G messages G122 (new)
System utilities	Dynamic SVC utility (DFSUSVC0)