gtpm2m28 | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for TPF support for VisualAge client.
See the APEDIT for APARs PJ26600, PJ26581, and PJ26666 for information about prerequisite APARs.
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.
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:
Neither of the debuggers is activated when the following conditions occur:
The UDD is a client/server application that consists of two components:
ZINET ADD S-VAUDD PGM-CUDZ PORT-8008 P-TCP MODEL-NOWAIT
This command instructs the Internet daemon (INETD) to listen on port 8008 for a start request from the workstation component. The Internet daemon starts a new instance of the universal data display server (UDDS). The UDDS searches for all of the ECBs that are being debugged from the workstation that started the client. The ECBs are then sent to the client to be displayed. The UDDS listens to C signals (from the debuggers), which indicate whether an ECB was changed or ended. The client is notified of these events and the display is updated accordingly.
There are none.
The following section summarizes interface changes.
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.
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. |
There are no changes.
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 |
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.
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 |
There are no changes.
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. |
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. |
Table 725 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).
Notes:
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. |
There are no changes.
There are no changes.
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. |
There are no changes.
The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.
There are no changes.
There are no changes.
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 |
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 |
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 |
There are no changes.
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 |
There are no changes.
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 |
There are no changes.
There are no changes.
There are no changes.
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. |
The following section summarizes system equate changes.
There are no changes.
There are no 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.
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. |
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 |
APAR PJ26468 improves the performance of the TPF C Debugger for VisualAge Client.
There are no changes.
There are no changes.
There are no changes.
There are no 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. |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
Use the following procedure to install TPF Support for VisualAge Client on your TPF 4.1 system.