Considerations for using ILE programs

In previous versions, a data area named QRLMMONQ was used to enable the use of ILE programs for attribute-specific monitor exits, to prevent the unintended use of an ILE program in the monitor's library list. There are now two options for using ILE programs. Both of these options use the data area named QRLMMONEXT. The QRLMMONQ data area is no longer used.

The first option is to specify that ILE programs are allowed to be called for either output queue monitors, directory monitors, or both.

For example, first create the data area in the instance library if you want it to apply to that instance only, or create it in the QUSRRDARS library if you want it to apply to all Content Manager OnDemand instances.

CRTDTAARA DTAARA(QUSROND/QRLMMONEXT) TYPE(*CHAR) LEN(30) VALUE(' ') 
   TEXT('Monitor exit names, functions, and library name')

To allow ILE output queue monitor exit programs, change the data area to contain a value of *ALLOWILE in the first 10 characters (positions 1 through 10):

CHGDTAARA DTAARA(QUSROND/QRLMMONEXT (1 10)) VALUE(*ALLOWILE)

To allow ILE directory monitor exit programs, change the data area to contain a value of *ALLOWILE in the second 10 characters (positions 11 through 20):

CHGDTAARA DTAARA(QUSROND/QRLMMONEXT (11 20)) VALUE(*ALLOWILE)

For changes to the data area to take effect, you must stop and restart the monitor.

The second option is to specify the name of the library that contains the monitor exits in the last 10 characters (positions 21 through 30) of the QRLMMONEXT data area. This is a more robust and flexible solution for ensuring the correct program is used in all cases. For example:

CHGDTAARA DTAARA(QUSROND/QRLMMONEXT (21 10)) VALUE(LIBRARYNAM)

For changes to the data area to take effect, you must stop and restart the monitor.

In summary, you can either specify a value of *ALLOWILE for output queue monitor exits or directory monitor exits or both, or specify the library of the intended monitor exits in the last 10 characters (character positions 21 to 30) of the QRLMMONEXT data area. If the last 10 characters of the QRLMMONEXT data area are blank, the library list of the monitor job is used to locate the exit program. It is best to specify a specific library name to prevent unintended use of an unrelated ILE program in the monitor's library list.