IMSCTF macro

For information on how to define the options that you had previously provided by using the IMSCTF macro, see IMSCTF macro removal migration considerations.

On the IMSCTF macro, the DYLOG and DISKLOG keywords and the third parameter on the RDS keyword (2│number) are no longer used and are not included in the macro format described in this information. If either of these are specified, they are ignored. They can remain in your system definition to provide compatibility with earlier IMS releases.

• Dynamic definition
• Supported environments
• Syntax
• Positional parameters
• Keyword parameters

Dynamic definition

The parameters defined with IMSCTF cannot be defined dynamically.

Supported environments

The IMSCTF macro can be used in the DB/DC, DBCTL, and DCCTL environments.

Syntax

Positional parameters

The IMSCTF macro does not include positional parameters.

Keyword parameters

To find which parameters apply to your IMS configuration, refer to Selecting the appropriate macros to define your system.

CORE=

No longer used. CORE= has been replaced by the PIINCR and PIMAX execution parameters for DB/DC and DBCTL IMS online systems, respectively.

CPLOG=

Specifies the number of system log records between system-generated checkpoints. The permitted value ranges from 500 to 16,777,215. The default is 500,000.

LOG=

The first operand, SNGL│DUAL, is no longer used for an online execution. If specified in an online configuration, it is ignored.

When specified for a batch execution, this parameter determines whether 1 (SNGL) or 2 (DUAL) DD statements are to be generated in the IMS batch procedures for the system log.

The second operand, MONITOR, specifies that the IMS Monitor DD statement is to be included in the procedure for the online system.

PRDR=

Specifies an optional IMS reader procedure name. The name must be 1 to 8-alphanumeric or national characters, with the first being alphabetic or national. The default is IMSRDR. You can also specify the reader procedure name in the control region JCL and in the default parameter module, DFSPBIMS. DBCTL users use DFSPBDBC.

RDS=

The first parameter specifies the device type on which the restart data set (IMS.RDS) is to reside.

You can specify one of the following device types: 3330 (the default), 2305, 3340, 3350, 3375, 3380, 3390 or LGDK.

When using a 3350, specify the drive format used—3330 or 3350.

LGDK is a generic definition for disk drives that have a track size greater than 32,760 bytes. The 3375, 3380, 3390, and future devices can also be specified as LGDK.

The second parameter specifies the buffer size to be used for the data set. The minimum buffer size is 1024. The maximum allowable size is the track size for the device type specified or 32,760, whichever is smaller. The default is 4096.

The third parameter is no longer used. If specified, it is ignored.

SVCNO=

Specifies supervisor call instruction (SVC) numbers reserved for use by the generated system.

The first parameter specifies the type 2 SVC number. The entered value can range from 200 to 255. The default is 254. The type 2 SVC number is required for batch, DBCTL, DCCTL and DB/DC IMS control program functions. One type 2 SVC number can be used for any number of IMS systems.

The second parameter specifies the type 4 SVC number reserved for use by database recovery control (DBRC). The entered value can range from 200 to 255. The default is 255. One type 4 SVC number can be used for any number of IMS systems.

For reasons of compatibility, the SVC numbers, if specified, must be immediately preceded by a comma and then enclosed in parentheses. Also, the type 2 and type 4 SVC number cannot be the same.

If you are installing different levels of IMS in the same processor, the Type 2 and Type 4 SVCs are downward compatible.