Installing the message editing utility

The library data sets and modules needed by the message editing utility are installed as part of the CICS® Transaction Server for z/OS®, Version 3 Release 1 installation process. (The utility data sets are outlined in Utility data sets.) However, before you can use the message editing utility, you must define the ISPF index of the utility data sets. This is described in Defining the utility data set index.

Utility data sets

The following partitioned data sets are used by the message editing utility.

Message source data set
This data set, CICSTS31.CICS.SDFHMSRC, contains message source files for all languages serviced by IBM®.
Executable files (CLISTs) data set
This data set, CICSTS31.CICS.SDFHCLIB, contains the message editing utility executable CLIST.
Load library
This data set, CICSTS31.CICS.SDFHLLIB, contains the load modules for the message editing utility.
Messages library
This data set, CICSTS31.CICS.SDFHMLIB, contains the modules for messages internal to the message editing utility.
ISPF panel library
This data set, CICSTS31.CICS.SDFHPLIB, contains the panels for the message editing utility.
Internal tables library
This data set, CICSTS31.CICS.SDFHTLIB, contains the utility-generated tables to control the tracking and processing of message data set members.
Input table of CICS language codes
This data set, CICSTS31.CICS.SDFHLANG, contains the table of all valid language codes supported by CICS.

These data sets, except CICSTS31.CICS.SDFHTLIB, are created automatically when you install CICS Transaction Server for z/OS, Version 3 Release 1. The CICSTS31.CICS.SDFHTLIB data set, and some control files, are created automatically when you run the message editing utility. The control files are called target_data set_index.MEUCNTLx, where:

target_data set_index
is the index for all message editing utility target data sets.
x
is the CICS one-character language code.

Defining the utility data set index

If, when installing CICS, you change the location of the initial dialog module from CICSTS31.CICS.SDFHCLIB(DFHMEUCL), you must edit DFHMEUCL and change the PROC statement. The PROC statement specifies the location identifier of the utility, and is used to find the initial program for the message editing utility. As supplied, the PROC statement is as follows:

   PROC 0 MEULIB(CICS640)

If you want to invoke the message editing utility with a different data set prefix, you can pass the data set name from the command table. Alternatively, you can use the MEULIB(xxxxxxxx.xxxxxxxx) parameter on the CLIST command, where xxxxxxxx.xxxxxxxx is the prefix that you want to use. For example:

TSO EX 'CICSTS31.CICS.SDFHCLIB(DFHMEUCL)' 'MEULIB(mymeu.prefix)'

where mymeu.prefix is the prefix to be used for the utility data sets. MEULIB need only be specified if the prefix has been changed from the default.

Related reference
Message editing utility (DFHMEU)
Process for using the message editing utility
[[ Contents Previous Page | Next Page Index ]]