Skip to: Abstract | Comments | Solution | Related Segments | Migration | Download
APAR NUMBER: PJ28809 PRODUCT: TPF4 FUNCTIONAL AREA: VISUALAGE ASSEMBLER DEBUGGER SHIPPED IN PUT: 17 ABSTRACT: TPF Debugger Command view allows TPF commands to be entered. APAR CONTENTS: FEATURE TYPE STATUS NAME Base CHeader Changed include/c$idsicd.h Base CPPHeader Changed include/iudbg.h Base CPPHeader Changed include/iudcls.hpp Base CPPHeader New include/iudcv.hpp Base CPPHeader Changed include/iuddef.h Base CPPHeader Changed include/iudenu.h Base CPPHeader Changed include/iudstr.h Base DataMacro Changed macro/idsicd.mac Base DataMacro Changed macro/iudbg.mac Base Macro Changed macro/sip/sppgml.mac Base Object Changed obj/oco/cud2bp40.o Base Object Changed obj/oco/cud2cp40.o Base Object New obj/oco/cud2cv40.o Base Object Changed obj/oco/cud2er40.o Base Object Changed obj/oco/cud2go40.o Base Object Changed obj/oco/cud2in40.o Base Object Changed obj/oco/cud2rg40.o Base Object Changed obj/oco/cud2sh40.o Base Object Changed obj/oco/cud2sk40.o Base Object Changed obj/oco/cud2st40.o Base Object Changed obj/oco/cud2vw40.o Base Object Changed obj/oco/cud2xp40.o Base Object Changed obj/oco/cudacd40.o Base Object Changed obj/oco/cudalx40.o Base Object Changed obj/oco/cudask40.o Base Object Changed obj/oco/cudayc40.o Base Copy Changed salin/ibmpal.cpy Base Copy Changed source/cp/base/cis040.cpy Base C Changed source/rt/base/cdbi.c Base BldScript Changed source/rt/base/cdbibs.bsc Base C Changed source/rt/base/cdbs.c Base BldScript Changed source/rt/base/cdbsbs.bsc Base C Changed source/rt/base/cdbtbt.c Base CPP New source/rt/base/cdbv.cpp Base BldScript New source/rt/base/cdbvbs.bsc Base CPP New source/rt/base/cdbw.cpp Base BldScript New source/rt/base/cdbwbs.bsc Base CPP Changed source/rt/base/cud1ev.cpp Base BldScript Changed source/rt/base/cud2bs.bsc Base BldScript Changed source/rt/base/cudabs.bsc Base CPP New source/rt/base/cudacv.cpp Base CPP Changed source/rt/base/cudasc.cpp PREREQUISITE APARS: To be applied in order listed. Base CHeader Changed include/c$idsicd.h PJ25425(09) PJ25632(09) PJ26666(11) Base CPPHeader Changed include/iudbg.h PJ28649(17) Base CPPHeader Changed include/iudcls.hpp PJ28649(17) Base CPPHeader Changed include/iuddef.h PJ28649(17) Base CPPHeader Changed include/iudenu.h PJ28649(17) PJ28848(17) Base CPPHeader Changed include/iudstr.h PJ28649(17) Base DataMacro Changed macro/idsicd.mac PJ25425(09) PJ25632(09) PJ26666(11) PJ27108(13) Base DataMacro Changed macro/iudbg.mac PJ25981(10) PJ26008(10) PJ26600(11) PJ27383(13) PJ27905(15) PJ28649(17) Base Macro Changed macro/sip/sppgml.mac PJ25199(09) PJ25425(09) PJ25632(09) PJ25614(09) PJ25589(09) PJ25703(09) PJ25720(09) PJ25332(09) PJ25760(09) PJ25763(09) PJ25781(09) PJ25780(09) PJ25817(09) PJ25982(10) PJ25983(10) PJ25981(10) PJ26125(10) PJ25880(10) PJ26150(10) PJ26187(10) PJ26008(10) PJ26156(10) PJ26161(10) PJ26188(10) PJ26174(10) PJ26270(10) PJ26337(10) PJ26374(10) PJ26366(11) PJ26283(11) PJ25761(11) PJ26515(11) PJ26575(11) PJ26577(11) PJ26534(11) PJ26683(11) PJ26522(11) PJ26713(11) PJ26600(11) PJ26581(11) PJ26666(11) PJ26693(11) PJ26686(11) PJ26809(11) PJ26707(11) PJ26864(12) PJ26892(12) PJ26746(12) PJ26793(12) PJ26841(12) PJ26887(12) PJ26967(12) PJ27023(12) PJ27028(12) PJ21337(12) PJ26904(12) PJ26890(12) PJ27079(12) PJ26895(12) PJ27156(12) PJ27095(12) PJ27197(13) PJ27246(13) PJ27305(13) PJ27345(13) PJ27231(13) PJ27277(13) PJ27351(13) PJ27387(13) PJ27328(13) PJ27383(13) PJ27083(13) PJ27299(13) PJ27302(13) PJ27268(13) PJ27333(13) PJ27214(13) PJ27393(13) PJ27422(13) PJ27180(13) PJ27469(13) PJ27094(14) PJ27430(14) PJ27636(14) PJ27380(14) PJ27491(14) PJ27647(14) PJ27714(14) PJ27484(14) PJ27530(14) PJ27627(14) PJ27650(14) PJ27617(14) PJ27686(14) PJ27634(14) PJ27804(14) PJ27746(14) PJ27784(14) PJ27865(14) PJ27894(14) PJ27786(15) PJ27847(15) PJ27951(15) PJ27863(15) PJ27905(15) PJ27954(15) PJ27848(15) PJ27932(15) PJ27728(15) PJ27925(15) PJ28029(15) PJ28021(15) PJ28108(15) PJ28097(15) PJ27785(15) PJ28136(15) PJ28118(15) PJ27966(15) PJ28229(16) PJ28286(16) PJ28266(16) PJ28140(16) PJ28168(16) PJ28195(16) PJ28020(16) PJ28213(16) PJ28396(16) PJ28386(16) PJ28435(16) PJ28503(16) PJ28499(17) PJ28621(17) PJ28586(17) PJ28623(17) PJ28493(17) PJ28649(17) PJ28766(17) PJ28757(17) PJ28759(17) PJ28758(17) PJ28765(17) PJ28785(17) PJ28810(17) Base Object Changed obj/oco/cud2bp40.o PJ28649(17) Base Object Changed obj/oco/cud2cp40.o PJ28649(17) PJ28785(17) Base Object Changed obj/oco/cud2er40.o PJ28649(17) Base Object Changed obj/oco/cud2go40.o PJ28649(17) Base Object Changed obj/oco/cud2in40.o PJ28649(17) Base Object Changed obj/oco/cud2rg40.o PJ28649(17) Base Object Changed obj/oco/cud2sh40.o PJ28649(17) Base Object Changed obj/oco/cud2sk40.o PJ28649(17) Base Object Changed obj/oco/cud2st40.o PJ28649(17) Base Object Changed obj/oco/cud2vw40.o PJ28649(17) Base Object Changed obj/oco/cud2xp40.o PJ28649(17) PJ28848(17) Base Object Changed obj/oco/cudacd40.o PJ28649(17) PJ28766(17) PJ28785(17) Base Object Changed obj/oco/cudask40.o PJ28649(17) PJ28917(17) Base Copy Changed salin/ibmpal.cpy PJ25442(09) PJ25425(09) PJ25632(09) PJ25444(09) PJ25589(09) PJ25703(09) PJ25720(09) PJ25684(09) PJ25332(09) PJ25760(09) PJ25781(09) PJ25780(09) PJ25953(10) PJ25982(10) PJ25983(10) PJ25981(10) PJ26125(10) PJ25880(10) PJ26150(10) PJ26187(10) PJ26161(10) PJ26188(10) PJ26174(10) PJ26350(10) PJ26365(11) PJ26366(11) PJ26283(11) PJ26384(11) PJ26516(11) PJ26468(11) PJ26575(11) PJ26577(11) PJ26534(11) PJ26685(11) PJ26683(11) PJ26713(11) PJ26600(11) PJ26581(11) PJ26693(11) PJ26686(11) PJ26707(11) PJ26782(12) PJ26781(12) PJ26864(12) PJ26892(12) PJ27023(12) PJ27028(12) PJ21337(12) PJ26904(12) PJ26890(12) PJ27079(12) PJ27095(12) PJ27073(13) PJ27197(13) PJ27246(13) PJ27305(13) PJ27231(13) PJ27277(13) PJ27387(13) PJ27383(13) PJ27083(13) PJ27268(13) PJ27333(13) PJ27214(13) PJ27393(13) PJ27422(13) PJ27469(13) PJ27430(14) PJ27636(14) PJ27491(14) PJ27647(14) PJ27484(14) PJ27530(14) PJ27627(14) PJ27650(14) PJ27617(14) PJ27686(14) PJ27634(14) PJ27804(14) PJ27784(14) PJ27786(15) PJ27847(15) PJ27951(15) PJ27863(15) PJ27905(15) PJ27848(15) PJ27932(15) PJ27728(15) PJ28119(15) PJ28097(15) PJ27785(15) PJ28118(15) PJ27966(15) PJ28169(16) PJ28266(16) PJ28140(16) PJ28369(16) PJ28195(16) PJ28213(16) PJ28396(16) PJ28435(16) PJ28499(17) PJ28631(17) PJ28649(17) PJ28757(17) PJ28759(17) PJ28758(17) PJ28810(17) Base Copy Changed source/cp/base/cis040.cpy PJ25425(09) PJ25632(09) PJ27108(13) Base C Changed source/rt/base/cdbi.c PJ28649(17) Base BldScript Changed source/rt/base/cdbibs.bsc PJ28649(17) Base C Changed source/rt/base/cdbs.c PJ25632(09) PJ25983(10) PJ25981(10) PJ26600(11) PJ26666(11) PJ27160(13) PJ27224(13) PJ27383(13) PJ28193(16) PJ28649(17) Base BldScript Changed source/rt/base/cdbsbs.bsc PJ25632(09) PJ25981(10) PJ26666(11) Base C Changed source/rt/base/cdbtbt.c PJ25632(09) PJ25696(10) PJ25983(10) PJ26008(10) PJ26407(11) PJ26793(12) PJ27445(14) PJ28649(17) Base CPP Changed source/rt/base/cud1ev.cpp PJ28649(17) Base BldScript Changed source/rt/base/cud2bs.bsc PJ25981(10) PJ27905(15) PJ28649(17) Base BldScript Changed source/rt/base/cudabs.bsc PJ25981(10) PJ27383(13) PJ27905(15) PJ28649(17) PJ28784(17) Base CPP Changed source/rt/base/cudasc.cpp PJ28649(17) COMMENTS: The TPF Debugger Command view allows TPF Debugger users to enter TPF commands through the TPF Debugger Java Single User Interface (JSUI) front end and to receive the output of the TPF commands on the TPF Debugger JSUI. The JSUI provides the Command view pane with two components: a text entry box and a viewing window. The text entry box is where TPF commands are entered. The viewing window is where the commands and the results of the commands are displayed. The TPF Debugger Command view provides the following commands to be entered only through the TPF Debugger Command view: more, help, and free. If more output from a command is expected, use "more" to retrieve it. Information about how to use the TPF Debugger Command view is available by entering "help". Each TPF Debugger that uses the TPF Debugger Command view requires a dedicated LNIATA. This LNIATA can be released voluntarily by entering "free". Otherwise, the LNIATA is released when the TPF Debugger is closed or when the TPF Debugger Command view goes unused for more than 10 minutes. SOLUTION: The TPF Debugger Command view requires that file /etc/lniata.dbg exists on the TPF file system. The /etc/lniata.dbg file contains the dedicated LNIATA available for the TPF Debugger Command view. See Migration Considerations for more information. The TPF Debugger Command view uses the program command routing service (PCRS) to route the TPF commands to the System Message Processor (SMP). PCRS then intercepts the output of the commands and routes it back to the TPF Debugger Command view. DEPENDENCIES SEGMENTS TO BE ASSEMBLED OR COMPILED: ccisoc.asm ccvage.asm cuda.cpp cudadd.cpp cudalb.cpp cudapo.cpp cudasm.cpp cudaab.cpp cudadi.cpp cudall.cpp cudapt.cpp cudatr.c cudabp.cpp cudafb.cpp cudarb.cpp cudavw.cpp cudb.asm cudacv.cpp cudago.cpp cudamb.cpp cudasb.cpp cudaxn.cpp cudacx.cpp cudagp.asm cudaob.cpp cudasc.cpp cudaxp.cpp cudm.asm cgstab.cpp cgstdc.c cgstfn.cpp cgstrt.c cudxdb.asm cud1.cpp cud1ev.cpp cudagp.asm cdbtbt.c cdbuxt.c cdbi.c cudxda.asm cudxdb.asm cdbs.c cdbv.cpp cdbw.cpp SEGMENTS TO BE LINK EDITED: cdb040.exe (Shipped in Tar File) cdbi40.exe (Shipped in Tar File) cdbs40.exe (Shipped in Tar File) cdbv40.exe (Shipped in Tar File) cdbw40.exe (Shipped in Tar File) cps040.exe cud140.exe (Shipped in Tar File) cud240.exe (Shipped in Tar File) cuda40.exe (Shipped in Tar File) COREQS: PJ28810, PJ28927 MIGRATION CONSIDERATIONS: - If you use the TPF Database Facility (TPFDF), you must also apply APAR PQ66435. - The TPF debugger Command view pane is not intended to be used as a terminal device. Unpredictable results can occur if the TPF commands that were entered generate unsolicited messages or periodically generate entry control blocks (ECBs) that generate output. If this happens, output might be discarded and dumps can occur. - The TPF debugger Command view is subject to the limitations of the program command routing service (PCRS). - TPF debugger Command view installation must be done by a system administrator, and the TPF debugger Command view LNIATAs must be dedicated for TPF debugger Command view use. - If an LNIATA is being used by a device and that LNIATA is registered for use by the TPF debugger Command view, all output for that LNIATA will be routed to the TPF debugger Command view pane. - The ZDDBG command has been enhanced to display information about the TPF Debugger Command view dedicated LNIATAs. See the TPF Operations manual for more information. - Workstations must have, at a minimum, JSUI 9.2 installed. To install TPF debugger Command view, do the following: 1. Apply APAR PJ28809 for the TPF debugger. 2. Assemble or compile the segments listed in the "Segments to be Assembled and Compiled" section. 3. Link-edit CPS0. 4. Run the system allocator (SALO) using IBMPAL and SPPGML additions for newly created segments to create an updated program allocation table (PAT) and SAL table. 5. The TPF Debugger Command view requires dedicated LNIATAs defined as terminal type X'80'. Allocate enough LNIATAs in the terminal address table (WGTA) to satisfy the expected usage of the TPF Debugger Command view. The designated LNIATAs must be registered in the computer room agent table (CRAT) in order for you to enter some TPF commands. The dedicated LNIATAs must be specified in a file on the TPF file system (see step 10). The following LNIATAs cannot be specified: - LNIATAs with a line number of 00 - LNIATAs with a line number of 01 - LNIATAs of a local line. 6. Link-edit the following Executables: CUD1 CUD2 CUDA CDB0 CDBI CDBS CDBV CDBW 7. Load the updated object code to your TPF 4.1 system. 8. Cycle the TPF 4.1 system to NORM state before running any application programs. 9. Create a text file containing all the LNIATAs dedicated to TPF debugger Command view use, one LNIATA per line. For example: D00102 D00202 D00302 D00402 10. FTP the file in text mode to the TPF file system as /etc/lniata.dbg. 11. Enter the ZINET STOP SERVER-DBUG command to stop the TPF debug server. 12. Enter the ZINET START command to start the TPF debug server. When the daemon starts, the /etc/lniata.dbg file is read into memory so that the TPF debugger knows which LNIATAs are available for use. 13. Register for debugging using the TPF Debug Registration window and proceed to use the TPF debugger. 14. Start the TPF debugger by entering a registered entry. 15. Enter TPF commands through the TPF debugger Command view. DOWNLOAD INSTRUCTIONS: http://www.ibm.com/software/htp/tpf/pages/maint.htm -- END APAR PJ28809
Download file(s): Login once to access server, leave window open, then click on link(s) below. Source Listing Binary