IMS Connectivity in an On Demand Environment: A Practical Guide to IMS Connectivity

Chapter 11. IMS Connect Extensions 163

11.2.2 Journal management

You define how IMS Connect Extensions manages the Active and Archive Journals.

Active Journal

IMS Connect Extensions writes events to the Active Journal data sets. The Active Journal is a

series of sequential data sets that are used in a rotation. When the first data set is full, the

second data set is used. This continues until the last data set is full. At this point, IMS

Connect Extensions only reuses Active Journal data sets after the event records are archived

or if the

Reuse option is set.

IMS Connect Extensions automatically allocates the Active Journal at startup based on the

template (it also can be preallocated manually). You define the template details in the Active

Journal Data Set panel shown in Figure 11-6.

Figure 11-6 Active Journal template

This list describes the options that you have to set the management of Active Journals:

 Data Set name

This field enables you to specify the data set name prefix used to create the Active Journal

data sets.

IMS Connect Extensions allocates the data sets, making them unique by adding a suffix to

the data set name.

You can use the &ID parameter as part of the data set name. IMS Connect Extensions

substitutes it with the system definition name when the data set is physically allocated.

See Figure 11-6 for an example of the use of the &ID parameter.

164 IMS Connectivity in an On Demand Environment: A Practical Guide to IMS Connectivity

 Number of data sets

This field enables you to specify the number of data sets in the Active Journal. You can

have 1 to 32 data sets (the default value is 3). If you specify one data set, you

must also

specify the

Reuse option in the Action flag. To select the aproppiate number for your

installation, you have to consider two points:

– How long you want to wait before accessing the data and running reports

– The amount of processing required by the Archive Manager to copy the files to the

Archive Journal data set

 Journal full option

This field enables you to determine the reaction of IMS Connect Extensions if the overflow

data set become full, or the active data sets become full and there is no overflow

specified. You have these options:

–Wait

Stop reading event records until a data set becomes available. This option causes the

IMS Connect system to stop processing incoming message requests. Use this option

with care because it might impact transaction response time.

– Discard

Continue to create the event records but discard the records until a data set becomes

available.

–Reuse

Reuse/overwrite the data sets.

–End

Shut down the Journal Manager. Event collection stops and cannot be restarted until

IMS Connect is restarted.

 Archive Manager

This field enables you to specify whether the Archive Manager has to copy the Active

Journals to the Archive Journal data sets.

If you activate the No Archive field, the Active Journal records are not copied to the

Archive Journal.

 Allocation parameters

Set of fields to provide IMS Connection Extensions the allocation parameters values for

the Active Journal data sets.

 Number of Overflows

This field enables you to specify whether IMS Connect Extensions will use an overflow

data set if the Archive Manager falls behind and all Active Journal data sets become full. If

the overflow data set also becomes full, the action indicated in the action flag is taken.

The values are 0 (no overflow data set is used, default value) or 1 (use an overflow data

set if required). The overflow data set name prefix is the same as the Active Journal data

set but with a different suffix.

 Overflow size

This field enables you to specify the size of the overflow data set. This is defined as a

multiple of the Primary quantity field. Values are in the range 1 to 99. The default values is

four times the primary quantity.