gtpm2m1iMigration Guide: Program Update Tapes

Virtual File Access (VFA) Synchronization (APAR PJ25094)

The following section discusses the migration considerations for virtual file access (VFA) synchronization. Transaction Processing Facility (TPF) transaction services is also part of APAR PJ25094. See TPF Transaction Services (APAR PJ25094) for more information about TPF transaction services.

Prerequisite APARs

See the APEDIT for APAR PJ25094 for information about prerequisite APARs.

Functional Overview

Virtual file access (VFA) is a storage management facility that dynamically allocates frequently referenced records to real main storage, and provides an intermediate staging area between the application program data and the direct access file database so you can avoid maintaining file completion information in an entry control block (ECB). When an application program issues a file, the TPF 4.1 system copies the data record into VFA whether the record is a VFA synchronization candidate or not. The record, which can be a fixed file record or a pool record, is then written from VFA by the control program. The VFA candidacy of the record determines whether it is retained in VFA after the write has been completed. Records are identified as VFA synchronization candidate in the record ID attribute table (RIAT).

You can use VFA to effectively manage the real main storage that cannot be efficiently used by TPF working storage and main storage resident application programs. Because the VFA area is in real main storage, you can obtain much higher access rates. In addition, input/output (I/O) channel load is reduced because VFA permits multiple updates to be applied to a record resident in VFA without the updates affecting the database copy until necessary.

Before VFA synchronization:

With VFA synchronization:

Architecture

There are no changes.

Operating Environment Requirements and Planning Information

To ensure your TPF 4.1 system performs correctly with VFA synchronization you must establish the required operating environment. The following section describes the hardware and software requirements specific to VFA synchronization.

Operating Environment Requirements and Planning Information provides information about the minimum system configuration requirements that are necessary to operate the TPF 4.1 system. You may find it helpful to review that chapter along with the following information.

Hardware

The following section contains information about hardware requirements.

Storage Devices

The following section discusses storage devices such as tape units and direct access storage device (DASD).

Direct Access Storage Device (DASD) and DASD Control Units

VFA synchronization uses the contention notification function of the IBM 3990 Model 3 or later models with the multi-path lock facility (MPLF) installed. Verify that the control units in your complex are running with the current levels of MPLF microcode.

Software (Programming Requirements)

There are no software requirements.

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

There are no changes.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

Table 356 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 356. Changes to General Use C/C++ Language Header Files for VFA Synchronization

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$cinfc.h Changed No
c$pi1dt.h Changed No
c$syseq.h Changed No
c$systc.h Changed No

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

There are no changes.

Library Interface Scripts

There are no changes.

Library Members (Object Files)

There are no changes.

Link-Edited Modules

There are no changes.

Members (Object Files)

There are no changes.

Object Code Only (OCO) Stubs

There are no changes.

Configuration Constant (CONKC) Tags

There are no changes.

Control Program Interface (CINFC) Tags

Table 357 summarizes the control program interface (CINFC) tag changes. The information in this table is ordered numerically by the equate value.

Table 357. Changes to CINFC Tags for VFA Synchronization

CINFC Tag Equate Value New, Changed, or No Longer Supported?
CMMLTT 361 New

Copy Members

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

Table 358. Changes to Copy Members for VFA Synchronization

Copy Member Type CSECT Where Copy Member Is Located New, Changed, or No Longer Supported? Description of Change
CICR Control Program CCNUCL Changed Updated for VFA synchronization.
CIDP Control Program CCCPSE Changed Updated for VFA synchronization.
CJIC Control Program CCSONS Changed Updated for VFA synchronization.
CJIE Control Program CCSONS Changed Updated for VFA synchronization.
CJIF Control Program CCSONS Changed Updated for VFA synchronization.
CJII Control Program CCSONS Changed Updated for VFA synchronization.
CJIM Control Program CCSONS Changed Updated for VFA synchronization.
CJIO Control Program CCSONS Changed Updated for VFA synchronization.
CJIQ Control Program CCSONS Changed Updated for VFA synchronization.
CJIT Control Program Changed CCSONS Updated for VFA synchronization.
CJIU Control Program CCRCSC Changed Updated for VFA synchronization.
CJIV Control Program CCRCSC Changed Updated for VFA synchronization.
CJIX Control Program CCSONS Changed Updated for VFA synchronization.
CJIY Control Program CCSONS Changed Updated for VFA synchronization.
CT05 Control Program CCCTIN Changed Updated for VFA synchronization.
CT41 Control Program CCCTIN Changed Updated for VFA synchronization.
CVF3 Control Program CCVFAC Changed Updated for VFA synchronization.

Fixed File Records

Table 359 summarizes fixed file record changes. This information is presented in alphabetic order by the name of the fixed file record.

Table 359. Changes to Fixed File Records for VFA Synchronization

Fixed File Record New, Changed, or No Longer Supported? Description of Change
#IBMM4 Changed Updated for VFA synchronization to include ordinal record 149 for the control record of the ZRTDM commands.

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 360 summarizes the data macro changes. This information is presented in alphabetic order by the name of the data macro.

Table 360. Changes to Data Macros for VFA Synchronization

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs That Use This Data Macro?
DC0DC Changed Yes
DCTMFS Changed Yes
DCTMIO Changed Yes
DCTRDF Changed No
DCTRIT Changed No
DCTSOI Changed No
DLTEC Changed No
IDSCFW Changed Yes
IDSCS2 Changed No
IDSFLV Changed No
IDSSST Changed No
MRLNQ Changed No
PI1DT Changed No
RITEQ Changed No
SYSTG Changed Yes
VF0AC Changed Yes

General Macros

There are no changes.

Selected Equate Macros

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

Table 361. Changes to Selected Equate Macros for VFA Synchronization

Selected Equate Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
CZ1SE Changed Yes
SYSEQ Changed Yes
TPFGLB Changed Yes

Structured Programming Macros (SPMs)

There are no changes.

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

Table 362 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. See TPF System Generation for a complete description of the SIP skeleton and internal macros. If the SIP skeleton and internal (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 362. Changes to SIP Skeleton and Internal Macros for VFA Synchronization

SIP Skeleton and Internal Macro New, Changed, or No Longer Supported?
SPPGML Changed

System Initialization Program (SIP) Stage I Macros and Statements

There are no changes.

System Initialization Program (SIP) Stage II Macros

Table 363 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. See TPF System Generation for a complete description of the SIP Stage II macros. 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 363. Changes to SIP Stage II Macros for VFA Synchronization

SIP Stage II Macro New, Changed, or No Longer Supported?
IBMPAL Changed
RIATA Changed

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

Table 364 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 364. Changes to System Macros for VFA Synchronization

System Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
FCTLC Changed Yes
IDATB Changed Yes
$LCKRC New Yes
$ULKRC New Yes

System Macros (IBM Use Only)

There are no changes.

Segments

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

Note:
The CZ1SE segment was updated with system error equates for VFA synchronization but you do not need to reassemble programs that call this segment.

Table 365. Changes to Segments for VFA Synchronization

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
ACPL Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
AMX2 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
ARD3 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
BDBM Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
BXAT Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
BXCL Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
BXET Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CACA Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CACR Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CAC1 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that call this segment.
CAC2 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CAC4 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CAC5 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CAC6 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CAC8 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CAC9 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CFDS Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CLMA Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CLMB Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CLMC Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CLMD Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CLME Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CLMF Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CLMG Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CLMH Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CLMI Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CLMM Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CLMN Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CLMP Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CLM1 Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CLM2 Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CLM3 Real-Time Assembler Not Applicable Changed This segment was not updated but changes were made to DSECTs that this segment calls.
CNPR Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CPAA Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CPAB Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CPAC Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CPAD Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CPAE Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CPAF Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CPAG Real-Time Assembler Not Applicable Not Applicable Updated for VFA synchronization.
CPAH Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CPAI Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CPSI Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CSS1 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CSS2 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CSS3 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CSS5 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CSS6 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CSS7 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CSY0 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CSY1 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CSY2 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CTKR Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CTKT Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVAX Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVFS Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CVFX Real-Time Assembler Not Applicable New Created for VFA synchronization as a user exit for VFA restart part 2.
CVF2 Real-Time Assembler Not Applicable Changed Updated for VFA synchronization for VFA restart part 2 and to allow for a user exit for file down of the DFIL candidate when the TPF 4.1 system is cycled to 1052 state.
CVF4 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVF7 Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CVF8 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVF9 Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
CVGD Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVGE Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVGG Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVPP Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVPR Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVQB Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVRM Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVUE Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVUF Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVX0 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CVX6 Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYEA Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYEB Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYED Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYEM Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYEN Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYEP Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYGN Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYMA Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYPB Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYPC Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYPD Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYPE Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYPH Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYPI Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYPL Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYPM Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYPR Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYPS Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYPU Real-Time Assembler Not Applicable Not applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYSA Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYSM Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
CYYI Real-Time Assembler Not Applicable Not Applicable This segment was not updated but changes were made to DSECTs that this segment calls.
DRD0 Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
DRD1 Real-Time Assembler Not Applicable Changed Updated because of modifications to the record ID attribute table (RIAT).
DRD2 Real-Time Assembler Not Applicable Changed Updated because of modifications to the record ID attribute table (RIAT).
DRD3 Real-Time Assembler Not Applicable Changed Updated because of modifications to the record ID attribute table (RIAT).
DRD5 Real-Time Assembler Not Applicable Changed Updated for VFA synchronization.
DRD6 Real-Time Assembler Not Applicable New Created for VFA synchronization.
DRD7 Real-Time Assembler Not Applicable New Created for VFA synchronization.
JCD0 Real-Time Assembler Not Applicable Changed Updated for VFA synchronization with changes made to DSECTs that call this segment and for data collection reports.
JCD1 Real-Time Assembler Not Applicable Changed Updated for VFA synchronization with changes made to DSECTs that call this segment and for data collection reports.
JCD2 Real-Time Assembler Not Applicable Changed Updated for VFA synchronization with changes made to DSECTs that call this segment and for data collection reports.
JCD3 Real-Time Assembler Not Applicable Changed Updated for VFA synchronization with changes made to DSECTs that call this segment and for data collection reports.
JCD4 Real-Time Assembler Not Applicable Changed Updated for VFA synchronization with changes made to DSECTs that call this segment and for data collection reports.
JCD6 Real-Time Assembler Not Applicable Changed Updated for VFA synchronization with changes made to DSECTs that call this segment and for data collection reports.
JRA2 Offline PL/I Not Applicable Changed Updated for VFA synchronization with changes made to DSECTS that call this segment and for data collection reports.
IB04 Offline Assembler IPLB Changed Updated for VFA synchronization.

System Equates

There are no changes.

User Exits

Control Program (CP) User Exits and ECB User Exits summarize the control program (CP) and ECB user exit changes. See TPF System Installation Support Reference for a complete description of all user exits.

Control Program (CP) User Exits

There are no changes.

ECB User Exits

This information is presented in alphabetic order by the name of the function.

Table 366. Changes to ECB User Exits for VFA Synchronization

Function User Exit Activated In User Exit Program New, Changed, or No Longer Supported? Description of Change
VFA Restart Part 2 CVF2 CVFX New Allows you to decide whether a specific VFA buffer that is marked as delayed file should be filed when the TPF 4.1 system cannot determine if locks are still held in the external lock facility for a specific processor.

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 367 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 367. Changes to Commands for VFA Synchronization

Command New, Changed, or No Longer Supported? Description of Change
ZRHLD DELETE Changed Added the VSYNC parameter, which allows you to delete the VFA synchronization locks.
ZRHLD DISPLAY Changed Added the VSYNC option, which allows you to display information about all the VFA synchronization locks.
ZRTDM DISPLAY Changed Added information about the VFA synchronization locks as well as the new CTLVAL parameter.
ZRTDM MODIFY Changed Added the SDELay and SIMMed parameters, which allow you to modify the VFA synchronization fixed record candidacy attribute and the pool record candidacy attribute in the record ID attribute table (RIAT).
ZRTDM RESET New Use this command to reset the record ID attribute table (RIAT) control value in the RIAT control record.
ZSYSG ALTER Changed Added the LTRCE parameter for DASD lock tracing.
ZVFAC DISPLAY Changed Added information about VFA-S lock buffers, VFA-X lock buffers, and cached record hold table (RHT) locks.
ZVFAC INDICATE Changed Added information about VFA-S hits, VFA-X hits, VFA lock misses, VFA contentions, record hold table (RHT) contentions, cached RHT hits, and VFA lock ageouts.

Messages and System Errors

Table 368 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 368. Changes to Messages and System Errors for VFA Synchronization

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
000038 System Error Changed
006000 System Error New
006001 System Error New
006002 System Error New
006003 System Error New
006005 System Error New
006006 System Error New
006007 System Error New
006008 System Error New
006009 System Error New
00600A System Error New
00600B System Error New
00600C System Error New
00600D System Error New
00600E System Error New
00600F System Error New
006010 System Error New
006012 System Error New
006013 System Error New
CPAA0012E Online New
RCSC0001W Online New
RHLD0002I Online New
RHLD0020E Online No Longer Supported
RHLD0027E Online No Longer Supported
RHLD0030E Online New
RHLD0037E Online New
RHLD0098I Online No Longer Supported
RHLD0110I Online New
RTDM0001I Online No Longer Supported
RTDM0005I Online New
RTDM0006I Online New
RTDM0007I Online New
RTDM0010I Online New
RTDM0032E Online New
RTDM0033E Online New
RTDM0071E Online New
RTDM0072E Online New
RTDM0082E Online New
RTDM0083E Online New
RTDM0084E Online New
RTDM0089E Online New
VFAC0007I Online No Longer Supported
VFAC0014I Online No Longer Supported
VFAC0024I Online New
VFAC0086I Online New
VFAC0110W Online New

Performance or Tuning Changes

There are no changes.

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 369 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 369. Changes to TPF Publications for VFA Synchronization

Publication Title Softcopy File Name Description of Change
TPF Concepts and Structures GTPCON05 Updated to include information about VFA synchronization.
TPF Database Reference GTPDBR05 Updated to include information about VFA synchronization.
TPF Library Guide GTPDOC07 Updated with definitions for new terminology in the master glossary.
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 VFA synchronization. See Messages and System Errors for more information about these messages and system errors.
TPF Migration Guide: Program Update Tapes GTPMIG07 Updated with migration considerations for VFA synchronization.
TPF Operations GTPOPR07 Updated with information about the commands that were added and changed for VFA synchronization. See Commands for more information about these commands.
TPF Program Development Support Reference GTPPDR06 Updated with a new dump label for VFA synchronization.
TPF System Generation GTPSYG07 Updated to add SDELay and SIMMed to the VFAF and VFAP parameters on the RIATA START call.
TPF System Installation Support Reference GTPINR07 Updated information about RIAT processing to include restrictions when using this user exit with VFA synchronization.

Add information about the CVFX user exit for VFA restart.

TPF System Performance and Measurement Reference GTPSPR07 Updated collector information modified by VFA synchronization, the details of file reduction, the content of the VFA summary report, and the content of the random file access summary report.
TPF System Macros GTPSYS07 Updated to include the new $LCKRC and $ULKRC macros. In addition, information for the existing FCTLC, FLSPC, FNSPC macros was updated. See System Macros for more information about these system macros.

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 VFA synchronization.

  1. Migrate to the appropriate model of the IBM 3990 DASD control unit with the multi-path lock facility (MPLF) installed. See Hardware for more information about hardware requirements and this DASD control unit.
  2. Install program update tape (PUT) 7, which contains VFA synchronization, to your TPF 4.1 system.

    Notes:

    1. VFA synchronization must be installed on all processors in your complex before you can enter the ZRTDM MODIFY command.

    2. A TPF 4.1 system with VFA synchronization installed can coexist in the same loosely coupled complex with a TPF 4.1 system without VFA synchronization installed as long as no VFA synchronization candidates are defined.
  3. Define VFA synchronization candidates by entering
    ZRTDM MODIFY RECID=xx VFAF-SIMM, VFAP-SIMM

    where xx is the ID of the fixed file record or pool record you are defining as a VFA synchronization candidate.

    Note:
    Ensure all processors in your complex refer to the same record ID attribute table (RIAT) before entering the ZRTDM MODIFY command. For example, different images may refer to different copies of the RIAT.
  4. Update the RIAT that is used for the general file loader loads to reflect selection of the VFA synchronization candidate.
    Note:
    If different processors refer to different RIATs such that some have RIAT IDs defined as VFA synchronization candidates while others have the same RIAT IDs defined as something other than a VFA synchronization candidate, there is a data integrity exposure if records with conflicting RIAT IDs are referenced.

Additional Information:

Fallback Scenarios

There are no fallback considerations until you have VFA synchronization candidates defined, and all loosely coupled processors in your complex must have PUT 7 installed before you can define those candidates.

If necessary, you can fall back to PUT 6 as long as there are no VFA synchronization candidates defined already. If you have already defined VFA synchronization candidates, you must remove them from the RIAT before you can fall back to PUT 6.