gtpm2m28Migration Guide: Program Update Tapes

TPF Support for VisualAge Client (APARs PJ26600, PJ26581, and PJ26666)

The following section discusses the migration considerations for TPF support for VisualAge client.

Prerequisite APARs

See the APEDIT for APARs PJ26600, PJ26581, and PJ26666 for information about prerequisite APARs.

Functional Overview

TPF Support for VisualAge Client includes the following three small programming enhancements (SPEs) for program update tape (PUT) 11:

Debug on system error (APAR PJ26600) helps you to recover after getting a system error while running an application program. When you see a problem in the program, debug on system error gives you the opportunity to correct the error and to continue running the program. To use debug on system error, you must have an active debugger session for the TPF Assembler Debugger for VisualAge Client or TPF C Debugger for VisualAge Client.

The universal data display (APAR PJ26581) provides a single interface to display entry control block (ECB) data for the TPF Assembler Debugger for VisualAge Client or TPF C Debugger for VisualAge Client. The ECB data is more comprehensive and more readable with the universal data display (UDD) than with displays that were previously available; the UDD provides for views of the ECB work areas, levels, and other selected fields. The UDD shows you a seamless view of the ECB no matter which debugger is active.

Trace on production (APAR PJ26666) offers enhancements to the ZDBUG command, including the ability to disable the TPF Assembler Debugger for VisualAge Client or TPF C Debugger for VisualAge Client. You can also display trace registration information for one or both of the trace-by-program and trace-by-terminal tables whether the entry status is active or nonactive. You can also clear the trace entry for a specified Internet Protocol (IP) address.

Architecture

Debug on system error sets an implied breakpoint when the ECB that is being traced takes a system error in the program. You can toggle the exception filter for the debuggers from the debugger graphical user interface (GUI); the TEST(ALL) filter option sets the implied breakpoint when system errors occur. If the system error occurs in an area that contains hooks, the TPF C Debugger for VisualAge Client is activated; otherwise, the TPF Assembler Debugger for VisualAge Client is activated.

One of the debuggers is activated when you are receiving system errors in any of the following:

When the debugger is active, you can select one of the following options:

Examine
This option forces the application to go to the next sequential instruction (NSI). The source of the program where the error occurred is presented to you for the TPF C Debugger for VisualAge Client. The disassembled listing is shown to you when you are using the TPF Assembler Debugger for VisualAge Client.

Step exception
This option forces the system error to occur. It also sets a breakpoint at the next sequential instruction.

Run exception
This forces the system error to occur and runs to the next breakpoint.

Neither of the debuggers is activated when the following conditions occur:

The UDD is a client/server application that consists of two components:

Operating Environment Requirements and Planning Information

There are none.

Interface Changes

The following section summarizes interface changes.

C/C++ Language

The following section summarizes C/C++ language changes. This information is presented in alphabetic order by the type of C/C++ language information. See the TPF C/C++ Language Support User's Guide and TPF Application Programming for more information about the C/C++ language.

Build Scripts

Table 720 summarizes changes to the build scripts used by the build tool. This information is presented in alphabetic order by the name of the build script.

Table 720. Changes to Build Scripts for TPF Support for VisualAge Client

Build Script Type New, Changed, or No Longer Supported? Description of Change
APAR PJ26581
CUDZBS C++ Language New Created for UDD suppport.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

Table 721 summarizes the general use C/C++ language header file changes. This information is presented in alphabetic order by the name of the general use C/C++ language header file.

General use means these header files are available for your use.

Table 721. Changes to General Use C/C++ Language Header Files for TPF Support for VisualAge Client

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
APAR PJ26600
c$cinfc.h Changed No
APARs PJ26600 and PJ26581
c$eb0eb.h Changed No
APAR PJ26666
c$idsicd.h Changed No

Implementation-Specific C/C++ Language Header Files (IBM Use Only)

Table 722 summarizes the general use C/C++ language header file changes that are for IBM use only. This information is presented in alphabetic order by the name of the general use C/C++ language header file.

Table 722. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for TPF Support for VisualAge Client

C/C++ Language Header File (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
APAR PJ26600
i$ecb3.h Changed No
APAR PJ26581
i$udcl.hpp Changed No
APARs PJ26600 and PJ26581
i$udbg.hpp Changed No

Library Interface Scripts

There are no changes.

Library Members (Object Files)

Table 723 summarizes the library member (object file) changes. This information is presented in alphabetic order by the name of the library member (object file).

Table 723. Changes to Library Members (Object Files) for TPF Support for VisualAge Client

Library Member (Object File) Library Module Name New, Changed, or No Longer Supported? Type Description of Change
APAR PJ26600
CSERRC CTAL Changed C Language Updated for debug on system error support.

Link-Edited Modules

Table 724 summarizes changes to the link-edited modules shipped by IBM, which should go into a data set with attributes DCB=(RECFM=U,LRECL=80,BLKSIZE=1200). This information is presented in alphabetic order by the name of the link-edited module.

Table 724. Changes to Link-Edited Modules for TPF Support for VisualAge Client

Link-Edited Module New, Changed, or No Longer Supported? Description of Change
APARs PJ26600 and PJ26581
CDBG40 Changed Updated for debug on system error and UDD support.
CPLX40 Changed Updated for debug on system error and UDD support.

Members (Object Files)

Table 725 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).

Notes:

  1. You must recompile or reassemble a member (object file) if it has changed.

  2. You must prelink and link a dynamic load module (DLM) if it has changed.

Table 725. Changes to Members (Object Files) for TPF Support for VisualAge Client

Member (Object File) DLM/DLL New, Changed, or No Longer Supported? Type Description of Change
APAR PJ26600
CDBS CDBS Changed C Language Updated for debug on system error support.
CUD2 CUD2 Changed C Language Updated for debug on system error support.
CUD3 CUD2 Changed C Language Updated for debug on system error support.
CUD4 CUD2 Changed C Language Updated for debug on system error support.
CUD5 CUD2 Changed C Language Updated for debug on system error support.
APAR PJ26581
CUDY CUDZ New Assembler Created for UDD support.
CUDZ CUDZ New C++ Language Created for UDD support.
CUD0 CUD0 Changed C Language Updated for UDD support.
APAR PJ26666
CUDXDA CDBS Changed Real-Time Assembler Updated to disable user exits for the TPF Assembler Debugger for VisualAge Client.

Object Code Only (OCO) Stubs

There are no changes.

Configuration Constant (CONKC) Tags

There are no changes.

Copy Members

Table 726 summarizes the copy member changes. This information is presented in alphabetic order by the name of the copy member.

Table 726. Changes to Copy Members for TPF Support for VisualAge Client

Copy Member Type CSECT Where Copy Member Is Located DLM Where CSECT Is Located New, Changed, or No Longer Supported? Description of Change
APAR PJ26600
CHSZ Control Program CCNUCL Not Applicable Changed Updated for debug on system error support.
CICR Control Program CCNUCL Not Applicable Changed Updated for debug on system error support.
CPSE Control Program CCCPSE Not Applicable Changed Updated for debug on system error support.
CUDT Control Program CCVAGE Not Applicable Changed Updated for debug on system error support.
CUDU Control Program CCVAGE Not Applicable Changed Updated for debug on system error support.

Fixed File Records

There are no changes.

Macros

The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.

Advanced Program-to-Program Communications (APPC) Macros

There are no changes.

Communication Macros and Statements

There are no changes.

Data Macros

Table 727 summarizes the data macro changes. This information is presented in alphabetic order by the name of the data macro.

Table 727. Changes to Data Macros for TPF Support for VisualAge Client

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs Using This Data Macro?
APAR PJ26600
EB0EB Changed No
IDSBG New No
IUDBG Changed No
APAR PJ26666
IDSICD Changed No

General Macros

Table 728 summarizes the general macro changes. This information is presented in alphabetic order by the name of the general macro. See TPF General Macros for a complete description of all general macros.

Table 728. Changes to General Macros for TPF Support for VisualAge Client

General Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
APAR PJ26600
CINFC Changed No

Selected Equate Macros

Table 729 summarizes the selected equate macro changes. This information is presented in alphabetic order by the name of the selected equate macro.

Table 729. Changes to Selected Equate Macros for TPF Support for VisualAge Client

Selected Equate Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
APARs PJ26600 and PJ26581
IEQCE2 Changed No
APAR PJ26600
CZ1SE Changed No
IEQCE3 Changed No

Structured Programming Macros (SPMs)

There are no changes.

System Initialization Program (SIP) Skeleton and Internal Macros (Inner Macros)

Table 730 summarizes the system initialization program (SIP) skeleton and internal macro changes. This information is presented in alphabetic order by the name of the SIP skeleton and internal macro. If the SIP skeleton and internal macro (inner macro) is changed, you must reassemble the SIP Stage I deck and run the appropriate job control language (JCL) jobs from the SIP Stage II deck.

Table 730. Changes to SIP Skeleton and Internal Macros for TPF Support for VisualAge Client

SIP Skeleton and Internal Macro New, Changed, or No Longer Supported?
APARs PJ26600, PJ26581, and PJ26666
SPPGML Changed

System Initialization Program (SIP) Stage I Macros and Statements

There are no changes.

System Initialization Program (SIP) Stage II Macros

Table 731 summarizes system initialization program (SIP) Stage II macro changes. This information is presented in alphabetic order by the name of the SIP Stage II macro. If IBMPAL is changed, you must run the system allocator (SALO) and load the new program allocation table (PAT) to the TPF 4.1 system.

Table 731. Changes to SIP Stage II Macros for TPF Support for VisualAge Client

SIP Stage II Macro New, Changed, or No Longer Supported?
APARs PJ26600 and PJ26581
IBMPAL Changed

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

There are no changes.

System Macros (IBM Use Only)

There are no changes.

Segments

Table 732 summarizes segment changes. This information is presented in alphabetic order by the name of the segment.

Table 732. Changes to Segments for TPF Support for VisualAge Client

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
APAR PJ26600
CPSA Real-Time Assembler Not Applicable Changed Updated to turn off the trace entry for a child ECB.
CPSZ Real-Time Assembler Not Applicable New Created for debug on system error.

System Equates

The following section summarizes system equate changes.

SYSEQ Tags

There are no changes.

User Exits

There are no changes.

Functional and Operational Changes

The following section summarizes functional and operational changes. This information is presented in alphabetic order by the functional or operational change.

See Appendix A, "PUT 2-15 Interface Changes by Authorized Program Analysis Report (APAR)" for a summary of functional and operational changes by APAR.

Commands

Table 733 summarizes command changes. This information is presented in alphabetic order by the name of the command. See TPF Operations for a complete description of all commands.

Attention: Changes to commands can impact any automation programs you are using in your complex.

Table 733. Changes to Commands for TPF Support for VisualAge Client

Command New, Changed, or No Longer Supported? Description of Change
APAR PJ26666
ZDBUG Changed Added additional parameters.

Messages and System Errors

Table 734 summarizes message (offline and online messages) and system error changes.

The message IDs or system error numbers are listed in numeric order preceded by their alphabetic prefix. Some offline and online messages do not have a standard message ID. For these, the messages are presented in alphabetic order based on the initial message text; or for those messages that begin with variable information, the initial message text that follows that variable information. See Messages (System Error and Offline) and Messages (Online) for a complete description of all messages and system errors.

Attention: Changes to offline messages, online messages, and system errors may impact any automation programs you are using in your complex.

Table 734. Changes to Messages and System Errors for TPF Support for VisualAge Client

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
APAR PJ26581
CUDZ0001E Online New
CUDZ0002E Online New
CUDZ0003E Online New
CUDZ0099E Online New
APAR PJ26666
CDBS0008E Online New
CDBS0011I Online New
CDBS0012I Online New
CDBS0013I Online New
CDBS0014I Online New
CDBS0015I Online New
CDBS0016I Online New
CDBS0017I Online New
CDBS0018W Online New
CDBS0019I Online New

Performance or Tuning Changes

APAR PJ26468 improves the performance of the TPF C Debugger for VisualAge Client.

Storage Considerations and Changes

There are no changes.

System Initialization Program (SIP) and System Generation Changes

There are no changes.

Loading Process Changes

There are no changes.

Online System Load Changes

There are no changes.

Publication Changes

Table 735 summarizes changes to the publications in the TPF library. This information is presented in alphabetic order by the publication title. See the TPF Library Guide for more information about the TPF library.

Table 735. Changes to TPF Publications for TPF Support for VisualAge Client

Publication Title Softcopy File Name Description of Change
TPF Library Guide GTPDOC0B Updated with definitions for new terminology in the master glossary.
Messages (System Error and Offline) and Messages (Online) Not Applicable Updated with information about messages and system errors that were added, changed, and no longer supported for TPF Support for VisualAge Client.
TPF Migration Guide: Program Update Tapes GTPMG201 Updated with migration considerations for TPF Support for VisualAge Client.
TPF Operations GTPOPR0B Updated with information about the commands that were changed for TPF Support for VisualAge Client.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

There are no changes.

Database Changes

There are no changes.

Feature Changes

There are no changes.

Installation Validation

There are no changes.

Migration Scenarios

Use the following procedure to install TPF Support for VisualAge Client on your TPF 4.1 system.

  1. Update the library system with the contents of program update tape (PUT) 11.
  2. Install the current version of VisualAge TPF for Windows NT.
  3. Install the UDD client code from the following Web site:

    http://www.ibm.com/software/ad/vatpf

  4. Compile your applications. If you are changing load modules (DLLS, DLMs, or LLMs), you must compile your applications with the IBM OS/390 C/C++ Version 2 Release 6 compiler.