Installing and changing interpret tables

Follow these steps to install each interpret table and any user-written routines:
  1. Assemble the interpret table and the user-written routines referred to by the LOGCHAR macroinstruction.

    Put the user-written routines in a private call library.

  2. Link-edit the interpret table with its associated routines, preferably assigning a module name that matches the name of the interpret table as specified with the INTAB macroinstruction.

    Link-edit the resulting module as a non-executable module into a library identified by the SYS1.VTAMLIB DD statement.

  3. Code the assigned name on the LOGTAB operand of the appropriate definition statement to associate the logical unit or logical units with this interpret table (see z/OS Communications Server: SNA Network Implementation Guide for information about specifying the LOGTAB operand in definition statements).
To change an installed interpret table by adding a LOGCHAR macroinstruction, or to replace an installed interpret table, follow these steps:
  1. Add or replace the LOGCHAR macroinstruction in the source program.
  2. Assemble and link-edit the new interpret table, thus replacing the old module.

The control sections of the interpret table module consist of the interpret table itself and a CSECT for each user-written routine identified by the ROUTINE operand of the LOGCHAR macroinstruction. Individual CSECTs can be extracted when the interpret table is link-edited. Because reprocessing a load module deletes the END statement, use the linkage editor ENTRY control statement to specify the entry point of the new load module. For linkage editor requirements, see z/OS MVS Program Management: User's Guide and Reference.

To change the name of an installed interpret table, do the following steps:
  1. Change the name specified on the INTAB macroinstruction and follow the steps for changing an installed interpret table. When link-editing the interpret table, the module name and entry point must be made to match the new name of the interpret table.
  2. Change the LOGTAB operand in all affected definition statements.
  3. File the corrected NCP source program and the corrected set of definition statements in the appropriate VTAM® library, replacing the old source programs. (The procedure is described in the z/OS Communications Server: SNA Network Implementation Guide .) It is not necessary to do a partial NCP generation because the LOGTAB operand is used only by VTAM.
  4. Use the MODIFY TABLE command to associate the new table with the corresponding logical unit, and load the table.