Using CA JARS with Special Environments › Defining Alternate Data Element Title Headings

Defining Alternate Data Element Title Headings

CA JARS is designed so that a user may make up one or more sets of Output Data Element Title Headings and use them in place of the set provided with the system. This approach eliminates the necessity for large sets of TITLE control statements used to override the default data element titles. The Title Tables supplied on the distribution tape are members:

JSIRTT01	(standard descriptions of output data elements-default)
 JSIRTT02	(titles for CICS descriptions of output data elements)
 JSIRTT03	(titles for APPC descriptions of output data elements)
 JSIRTTMA	(titles for Roscoe descriptions of output data elements)
 JSIRTTQA	(titles for ADABAS descriptions of output data elements)
 JSIRTTVO	(titles for VM descriptions of output data elements)
 JSIRTTMS	(titles for IMS descriptions of output data elements)
 JSIRTTIS	(titles for IDMS descriptions of output data elements.

Note: The Title Table for JSIRTTIS is provided on the CA JARS IDMS Option distribution tape.

These tables are in the form of assembly programs which consist of constants and have no executable statements. Each table also contains conditional assembly statements which verify that the tables are the correct length to ensure that titles are not incorrectly modified.

A set of user-specified titles may be defined by completing the following steps:

1. Punch out the appropriate member (JSIRTT01, JSIRTT02, etc.)
2. Change the upper and lower data element title description constants as desired, being careful not to change the length of any description constant (as they must remain the same length as the corresponding output data element).
3. Assemble the modified title table, checking for the presence of MNOTE statements indicating that the table lengths are invalid. Link edit the resultant object deck, specifying a load module name of JSIRTT01.

This sequence of steps causes the distribution set of titles to be replaced with the user-specified set. If several sets of alternate titles are needed or the distribution set is not to be replaced, a number of different load modules may be link edited with phase names of the form JSIRTTxx, where xx is any two characters other than listed above. These alternate title sets may be indicated for a user-defined report by entering the last two positions of the title table load module in positions 10-11 of the DISPLAY control statement.

For example, if a title table is link edited with the name JSIRTT99, then a report with the DISPLAY statement:

1DISPLAY 99.............

uses the titles defined in that load module.

The module JSIRTT01 is the default title table and is used for data element titles if positions 10-11 are blank on the DISPLAY statement. Regardless of which title module is used, title control statements may still be used to override individual titles.