Starting the IDIS subsystem

To start the Fault Analyzer IDIS subsystem, a simple job as shown below can be submitted:

//IDISS    JOB  …
//IDISSTST EXEC PGM=IDISAMAN,TIME=NOLIMIT,REGION=region-size,PARM='options'
//IDIDOC2  DD   DISP=SHR,DSN=IDI.SIDIDOC2
//* (Optional DD statements might follow, as described below)

where

REGION=region-size

Specifies the region size to be used for the IDIS subsystem.

In most cases, a region size of 100 megabytes should be adequate (REGION=100M). However, if a very large number of history files are being managed by the IDIS subsystem, or if the history file sizes are very large, then it might be necessary to specify an even larger region size. For information about how to estimate the required region size, see IDIS subsystem storage requirements.

PARM='options'

Specifies special options that are only used by the IDIS subsystem to disable some subsystem functions. Further options processing in the subsystem occurs through the standard IDICNFxx parmlib member and the IDIOPTS DD statement, as described in Options. The optional PARM field specification can contain one of the following values for options:

UPDINDEX: Specifies that the IDIS subsystem is to manage the $$INDEX member access of all PDSE history files used on the same MVS™ image as where the IDIS subsystem is running, and to which the IDIS subsystem has UPDATE access. For details, see Caching of history file $$INDEX data.
This value is the default.
NOUPDINDEX: Specifies that the abending job performs all history file updates.
Note: Specifying NOUPDINDEX will disable the Fault Analyzer Recovery Fault Recording (RFR) feature.
IMAGEFAST: Enables IMS fast duplicate fault suppression specified using the NoDup(ImageFast(minutes,IMS(…))) option. For details, see NoDup.
This value is the default.
NOIMAGEFAST: Disables IMS fast duplicate fault suppression, regardless of NoDup(ImageFast(…)) settings.
FASTEXCLUDE: Enables fast Exclude options processing. For details, see Fast Exclude options processing.
This value is the default.
NOFASTEXCLUDE: Disables fast Exclude options processing to revert back to normal Exclude processing by the IDIDA task.
XCFGRPSUFFIX=c: Provides control over the last character, c, of the IDIS subsystem XCF messaging group name, IDISXCFc, in order to create an alternative XCF message group. This creation would normally only be done if there are MVS™ images in a sysplex which do not share DASD and history files with the main IDISXCFM default group, and would be set for the images that do not share DASD and history files. Each messaging group shares updates to the history files by data set name using the XCF messaging group.
NOXCFGRPSUFFIX: Use the default "M" suffix. This value is the default.
JAVA: Enables Java™ analysis. See IDIS subsystem requirements for Java for more information.
NOJAVA: Disables Java™ analysis. This value is the default.
SLIP: Enables the capture of SLIP dumps.
NOSLIP: Disables the capture of SLIP dumps. This value is the default.

Multiple PARM field options must be delimited by one or more blank characters.

Alternatively, the IDIS subsystem can be established using a started task. The IDIS subsystem dynamically allocates data sets to SYSOUT=*, so it must be run under the job entry subsystem (JES).

Note: Ensure that the TIME=NOLIMIT parameter is specified as shown in the example above to prevent IDIS subsystem abend S522.

The subsystem name that is used by Fault Analyzer for this subsystem is IDIS. This name does not need to be defined in the IEFSSNxx parmlib member as it is dynamically defined by the IDISAMAN program.

The //IDIDOC2 DD statement is used to allocate the IDI.SIDIDOC2 SMP/E target data set, which might contain updates to the Fault Analyzer VSAM KSDS message and abend code explanation repository. If updates are available, and either the //IDIDOC2 DD statement has not been specified, or the high-level qualifier of the IDI.SIDIDOC2 data set is not the same as the high-level qualifier of the IDI.SIDIDOC1 data set identified via the DataSets(IDIDOC(…)) option, then message IDI0165A is issued. If this situation occurs, then add the //IDIDOC2 DD statement as shown above.

Do not change the LE HEAPZONES option setting to anything other than HEAPZONES(0,…) when the IDIS subsystem is active.