gtpm2m0c | Migration Guide: Program Update Tapes |
Within the migration considerations for each new function or SPE a series
of tables is used to present the migration considerations to you. The
information in each table is order sequentially or alphabetically depending on
the type of information presented. To help you better understand the
content of each table, a description of the various column headings follows in
Table 2.
Table 2. How to Read the Tables
Column Heading | Description |
---|---|
APPC Macro | Indicates the name of the Advanced Program-to-Program Communications (APPC) macro. AnAPPC macro is an assembler macro in an application or program that uses the APPC communications protocol. |
Build Script | Indicates the name of the build script. A build script is a file that defines the module type and specifies the components of a dynamic link library (DLL), dynamic load module (DLM), or library load module (LLM), and is used by the CBLD program to create the finished DLL, DLM, or LLM. |
C/C++ Language Header File | Indicates the name of the general use C/C++ language header file. A general use C/C++ language header file is a header file that is available for general use and includes function prototypes and related definitions that may be used by any application program. |
C/C++ Language Header File (IBM Use Only) | Indicates the name of the implementation-specific C/C++ language header file (IBM use only). An implementation-specific C/C++ language header file is a header file that is used by the TPF system only. These headers files are internal to the implementation of certain functions. |
CINFC Tag | Indicates the name of the CINFC tag. The CINFC tag is the symbolic name of a main storage resident system table. |
Communication Macro or Statement | Indicates the name of the communication macro or statement. A communication macro or statement is a macro or statement used in applications or programs that use any of the various aspects of TPF communications support. |
CONKC Tag | Indicates the name of the CONKC tag. The CONKC tag is the symbolic name of a system configuration variable. |
Control Program (CP) User Exit Activated In | Indicates the name of the CP from which the user exit is activated. |
Copy Member | Indicates the name of the copy member. A copy member is a file that is copied into a control section (CSECT). For example, CICR40 is a ocpy member of CCNUCL. |
CSECT Where Copy Member Is Located | Indicates the CSECT where the copy member is located. The CSECT must be assembled. |
Data Macro | Indicates the name of the data macro. A data macro is a declarative macro that generates DSECTs defining records that may be called by any TPF source program by using the data macro name. |
Description of Change | Provides a description of the entity or the changes made to it by the new function or SPE. |
DLM/DLL/LLM Name | Indicates the name of the dynamic load module (DLM), the dynamic link library (DLL), or the library load module (LLM) in which the member is a part. A DLM is a type of load module. A DLL is a collection of one or more functions or variables gathered in a load module and executable or accessible from a separate DLL application load module. |
DLM, DLL, LLM, or Control Program | Indicates whether the link-edited module is a DLM, DLL, LLM, or control program. |
DLM Stub | Indicates the name of the DLM stub. A DLM stub is a small object-code file that allows a DLM to call another real-time program. DLM stubs are created by the DLM stub generator tool (STUB). |
DLM Where CSECT Is Located | Indicates the DLM where the CSECT is located. The DLM must be link-edited. If there is no DLM associated with the CSECT, Not Applicable is printed. |
Do You Need to Reassemble Programs? | Indicates whether you must reassemble programs because of the macro change (Yes, No, or Not Applicable). |
Do You Need to Reassemble Programs Using This Data Macro? | Indicates whether you must reassemble programs using the data macro (Yes, No, or Not Applicable). |
Do You Need to Recompile Segments? | Indicates whether you must recompile segments (Yes, No, or Not Applicable). |
Equate Value | Indicates the equate value. |
Fixed File Record | Indicates the name of the fixed file record. A fixed file record is a data record that is permanently assigned to a specific function (record type) and is accessed through the FACE/FACS programs, which use the FACE table. |
Function | Indicates the name of the function. |
Command | Indicates the name of the command. A command is an operator message, accepted only from CRAS terminals, that is used to communicate with the control program to request services or modify system parameters. Commands are sometimes called Z-messages because the first character of the command is always z. |
General Macro | Indicates the name of the general macro.General macros provide system services (such as performing alphabetic scans, using tape drives, or handling input and output), control application programming processing (such as entry creation), and control events for resource sharing (such as posting and waiting, queuing and dequeuing). |
ISO-C | An X in this column indicates that the C/C++ language header file is for ISO-C support. A blank in this column indicates that the header file is for offline programs. |
Library Interface Script | Indicates the name of the library interface script. A library interface script is a file that lists functions contained in a library and provides an index number for that function. The file is used by the library interface tool (LIBI) to create library stubs. |
Link-Edited Module | Indicates the name of the link-edited module. A link-edited module is a file of load module code produced by the linkage editor. |
Link-Edited Module (Where Offline Segment Is Linked) | Indicates the name of the module where the offline segment is linked. If the segment is not an offline segment, Not Applicable is printed. Link-edited modules are files of load module code produced by the linkage editor. |
Member | Indicates the name of the member. Members are files of object code that are components of dynamic load modules (DLMs), dynamic link libraries (DLLs), or library load modules (LLMs). |
Member Type | Indicates whether a member is assembler language, C Language, C++ Language, or Object Code Only. |
Message ID or System Error Number | Indicates the message ID for the offline or online message, or the system error number for the system error. Messages are transactions or entries received by a TPF 4.1 system for immediate action. TPF system messages (system errors) such as dump messages, and offline and offline messages, are intended for operators and system programmers responsible for operating and maintaining the TPF 4.1 system. |
Message Type | Indicates whether the message is an offline message, online message, or system error. |
Name of Link-Edited Module | Indicates the name of the link-edited module that contains the copy member. |
New, Changed, or No Longer Supported | Indicates whether an entity is new, changed, or no longer supported because of the new function or SPE. |
Object Code Only (OCO) Stubs | Indicates the name of the object code only (OCO) stub, which are stubs that resolve to external references generated by the C and C++ compilers. |
Programs to Reassemble | Indicates the programs that you must reassemble. If non-IBM (customer only) programs must be reassembled, that is noted. This information is new for program update tape (PUT) 14 and beyond, and Appendix A, PUT 2-15 Interface Changes by Authorized Program Analysis Report (APAR). This information is not provided for PUT 2 to PUT 13 (Program Update Tape 2 (PUT 2) to Program Update Tape 13 (PUT 13)). |
Publication Title | Indicates the name of the publication from the TPF 4.1 library. |
SCK Macro | Indicates the name of the system communication (SCK) general macro. |
Segment | Indicates the name of the segment. A segment is real-time code or offline code that is not part of the control program (CP). |
Segments to Recompile | Indicates the segments that you must recompile. If non-IBM (customer only) segments must be recompiled, that is noted. This information is new for program update tape (PUT) 14 and beyond, and Appendix A, PUT 2-15 Interface Changes by Authorized Program Analysis Report (APAR). This information is not provided for PUT 2 to PUT 13 (Program Update Tape 2 (PUT 2) to Program Update Tape 13 (PUT 13)). |
Segment Where Copy Member is Included | Indicates the name of the segment where the copy member is located. |
Selected Equate Macro | Indicates the name of the selected equate macro. A selected equate macrois an assembler macro, such as REGEQU, that provides equate support. |
SIP Skeleton and Internal Macro | Indicates the name of the SIP skeleton and internal macro. A SIP skeleton and internal macro is a macro or skeleton (such as SPPBLD or SPCOMP) that is used by the system initialization program (SIP). |
SIP Stage I Macro | Indicates the name of the SIP Stage I macro. |
SIP Stage II Macro | Indicates the name of the SIP Stage II macro. |
Softcopy File Name | Indicates the softcopy file name for the publication. |
Structured Programming Macro (SPM) | Indicates the name of the SPM. A structured programming macro (SPM) is a macro used to add structured programming verbs to existing assembler language. |
SYSEQ Tag | Indicates the name of the SYSEQ tag. A SYSEQ tag is a system equate that provides a symbolic name for a system parameter or commonly used constant. |
System Macro | Indicates the name of the system macro. A system macro is a macro that is restricted to system use. There are three types of system macros: those that require authorization, those that do not require authorization, and those that are restricted to the control program (CP). |
System Macro (IBM Use Only) | Indicates the name of the system macro (IBM use only). |
TARGET (TPF) | An X in this column indicates that the C/C++ language header file is for TARGET(TPF). |
Type | Indicates whether the build script is a dynamic load module (DLM) or a
dynamic link library (DLL) in the Build Scripts table.
Indicates whether the member is a DLM, DLL, or LLM in the Members table. Indicates the type of copy member, for example a control program (CP) or real-time assembler in the Copy Members table. Indicates the type of segment in the Segments table. |
User Exit Activated In | Indicates the name of the segment in which the user exit is activated. |
User Exit Program | Indicates the name of the user exit program. |
User Routine Label | Indicates the name of the user routine label. |