gtpm2m0m | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for shared PR/SM.
See the APEDIT for APAR PJ17778 for information about prerequisite APARs.
After applying shared PR/SM support and all prerequisite APARs in the data collection and reduction areas, the link-edited data reduction program will not successfully process data collection tapes created on a TPF 4.1 system at the PUT 2 level. If your complex has a requirement to continue running data reduction for such tapes, you must maintain a separate data reduction program.
Shared PR/SM support allows tightly coupled TPF systems to run in shared PR/SM partitions. This support offers the following advantages:
Shared PR/SM support is implemented by allowing logical CPUs in a shared PR/SM partition to load enabled wait-state PSWs when no work is available for the associated I-stream. When another I-stream places work on the cross list of the waiting I-stream, a SIGP instruction is executed, causing an external-call external interrupt condition to be generated for the CPU associated with the waiting I-stream. This external interrupt causes PR/SM to dispatch the logical CPU as soon as a physical CPU is available, thereby eliminating excessive wait times. Similar processing is performed when a CPU loads an enabled wait-state PSW during DEFRC or DLAYC macro processing.
Calculation of CPU utilization is enhanced by obtaining CPU utilization statistics directly from the shared PR/SM facility rather than using TPF-based logic that is unaware of the higher-level dispatching activity controlled by the shared PR/SM facility.
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 C/C++ language.
There are no changes.
There are no changes.
Table 42 summarizes the general use C language header file changes. This information is presented in alphabetic order by the name of the general use C language header file.
General use means these header files are available for your
use.
Table 42. Changes to General Use C Language Header Files for Shared PR/SM
General Use C Language Header File | New, Changed, or No Longer Supported? | Do You Need to Recompile Segments? |
---|---|---|
c$dctist.h | Changed | No |
c$systc.h | Changed | No |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes
There are no changes.
There are no changes.
There are no changes.
Table 43 summarizes copy member changes. This information is
presented in alphabetic order by the name of the copy member.
Table 43. Changes to Copy Members for Shared PR/SM
Copy Member | Type | CSECT Where Copy Member Is Located | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|---|---|
CCE7 | Control Program | CCIISC | Changed | Modified the CPU utilization calculation for CPUs in a PR/SM environment. |
CICR | Control Program | CCNUCL | Changed | Modified the conditions under which DEFRC and DLAYC macro service routines cause an enabled wait-state PSW to be loaded. |
CLHL | Control Program | CCCLHR | Changed | Modified the $CRISC service routine to execute a $CPUC macro if the target I-stream is waiting; modified the conditions under which both the main and application CPU loops cause an enabled wait-state PSW to be loaded. |
CPSE | Control Program | CCCPSE | Changed | Modified the Perch routines to set up the ECRC before issuing a $CPUC macro. |
CTME | Control Program | CCNUCL | Changed | Modified the external interrupt handler to identify the reason for an external-call external interrupt and pass control to the appropriate routine. |
CT38 | Control Program | CCCTIN | Changed | Allocate storage for information returned by the DIAG X'204' instruction. |
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 44 summarizes the data macro changes. This information
is presented in alphabetic order by the name of the data macro.
Table 44. Changes to Data Macros for Shared PR/SM
Data Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs Using This Data Macro? |
---|---|---|
DCTIST | Changed | No |
IB0CT | Changed | No |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
Table 45 summarizes system macro changes. This information is
presented in alphabetic order by the name of the system macro. See TPF System Macros for a complete description of all
system macros.
Table 45. Changes to System Macros for Shared PR/SM
System Macro | New, Changed, or No Longer Supported? | Do You Need to Reassemble Programs? |
---|---|---|
$LOCKC | Changed | No |
There are no changes.
Table 46 summarizes segment changes. This information is
presented in alphabetic order by the name of the segment.
Table 46. Changes to Segments for Shared PR/SM
Segment | Type | New, Changed, or No Longer Supported? | Description of Change |
---|---|---|---|
JCD4 | Real-Time Assembler | Changed | Modified to collect information about the operating environment. |
JRA1 | Offline PL/I | Changed | Include the operating environment in the Environment Summary report. |
JRA3 | Offline PL/I | Changed | Redefine the data created by data collection to include operating environment information. |
There are no changes.
There are no changes.
There are no changes.
The following performance and tuning recommendations are made for TPF systems running in shared PR/SM partitions.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
Table 47 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 47. Changes to TPF Publications for Shared PR/SM
Publication Title | Softcopy File Name | Description of Change |
---|---|---|
Messages (System Error and Offline) and Messages (Online) | Not Applicable | Updated with information about the messages and system errors that were added, changed, and no longer supported for shared PR/SM. |
TPF Migration Guide: Program Update Tapes | GTPMIG02 | Updated with migration considerations for shared PR/SM. |
TPF System Performance and Measurement Reference | GTPSPR02 | Updated by shared PR/SM. |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.