gtpm2m24Migration Guide: Program Update Tapes

Coupling Facility (CF) Record Lock Support (APAR PJ26707)

The following section discusses the migration considerations for coupling facility record lock support (referred to as CF record lock support throughout this section).

Prerequisite APARs

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

Functional Overview

The limited lock facility (LLF) and the concurrency filter lock facility (CFLF), which are two external lock facilities (XLFs) supported by the TPF 4.1 system, were required to control access to data shared by two or more processors in a loosely coupled complex. CF record lock support now provides the option of using one or more CFs as XLFs. A CF is an IBM processor (sometimes referred to as a central processing complex (CPC)) used to centralize storage for all attached processors in a processor configuration by providing shared storage and shared storage management functions.

CF record lock support offers significant flexibility in using CFs as XLFs in your locking configuration. Your locking configuration may be dynamically modified by adding or deleting CFs. When a CF is added to or deleted from the locking configuration, the TPF 4.1 system automatically redistributes any locks to balance the locking workload across all available CFs. You can add up to 32 CFs to your locking configuration for a high degree of availability. The CFs in your locking configuration can be used in addition to or instead of LLF and CFLF. In addition, the CFs in your locking configuration can simultaneously be used for nonlocking workloads. Using CFs in a locking configuration can eliminate the need for LLF or CFLF, giving you greater flexibility when selecting and implementing new module control units (CUs).

All online modules in a loosely coupled complex must use an XLF for locking to control access to shared data. You may specify which online modules will use CFs for locking even if a specified module is connected to a CU with an LLF or CFLF. Modules may be migrated to use CFs for locking in one of the following manners:

Note that the lock residency of any duplicate module is configured automatically to be identical to that of the corresponding prime module.

Architecture

CF record lock support uses the CF support provided on program update tape (PUT) 9 to implement an XLF. See Coupling Facility (CF) Support (APAR PJ25781) for more information about the CF support provided on PUT 9.

In a loosely coupled complex, locks are used to control access to data shared by two or more processors. With CF record lock support, these locks can now be represented as entries in a CF list structure. A CF list structure is a named piece of storage on a CF that enables users to share information organized as entries on a set of lists or queues.

Operating Environment Requirements and Planning Information

See the S/390 Processor Resource/Systems Manager Planning Guide for information about CF planning and operating environment 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

Table 653 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 653. Changes to Build Scripts for CF Record Lock Support

Build Script Type New, Changed, or No Longer Supported? Description of Change
CFLABS DLM New Created by CF record lock support.
CFLBBS DLM New Created by CF record lock support.
CFLCBS DLM Changed Updated by CF record lock support.
CFLEBS DLM New Created by CF record lock support.
CFLGBS DLM New Created by CF record lock support.
CFLKBS DLM New Created by CF record lock support.
CFLNBS DLM Changed Updated by CF record lock support for the ZMCFT CLEAR service routine.
CFL5BS DLM New Created by CF record lock support.
CFL6BS DLM New Created by CF record lock support.
CLM8BS DLM New Created by CF record lock support.
CTALBS DLM Changed Updated by CF record lock support for the ISO-C TPF application programming interface (API).

Dynamic Load Module (DLM) Stubs

Table 654 summarizes changes to the dynamic load module (DLM) stubs. This information is presented in alphabetic order by the name of the DLM stub. See TPF Application Programming for more information about the DLM stubs.

Table 654. Changes to Dynamic Load Module (DLM) Stubs for CF Record Lock Support

DLM Stub New, Changed, or No Longer Supported?
CFL5 New
CFL6 New
CFMA New

General Use C/C++ Language Header Files

Table 655 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 655. Changes to General Use C/C++ Language Header Files for CF Record Lock Support

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$cfaa.h Changed No
c$cfct.h Changed No
c$cfdl.h New No
c$cfeq.h Changed No
c$cflp.h New No
c$cflr.h New No
c$cflt.h New No
c$cflv.h New No
c$cfst.h Changed No
c$cf2e.h New No
c$cinfc.h Changed No
c$cj6kp.h Changed No
c$copy.h New No
c$fapi.h Changed No
c$fva0.h Changed No
c$ic0ck.h Changed No
c$ipli.h New No
c$mfst.h Changed No
c$miob.h Changed Yes
c$pi1dt.h Changed No
c$syseq.h Changed No
c$sonf.h Changed No
reusable.h Changed No
sysapi.h Changed No
tpfapi.h Changed No

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

There are no changes.

Library Interface Scripts

Table 656 summarizes changes to the library interface scripts used by the library interface tool and the build tool. This information is presented in alphabetic order by the name of the library interface script.

Table 656. Changes to Library Interface Scripts for CF Record Lock Support

Library Interface Script New, Changed, or No Longer Supported? Description of Change
CTALXV Changed Updated by CF record lock support for the ISO-C TPF application programming interface (API) library.

Library Members (Object Files)

Table 657 summarizes the library member (object file) changes. This information is presented in alphabetic order by the name of the library member (object file).

Table 657. Changes to Library Members (Object Files) for CF Record Lock Support

Library Member (Object File) Library Module Name New, Changed, or No Longer Supported? Type Description of Change
CLEMIC CTAL New Assembler Created by CF record lock support for the tpf_lemic function.
CSERRC CTAL Changed Assembler Updated by CF record lock support to add a SERRC macro catastrophic option.
CDLCKC CTAL New Assembler Created by CF record lock support for the tpf_dlckc function.
CESFAC CTAL Changed Assembler Updated by CF record lock support to enhance the tpf_esfac function.

Link-Edited Modules

Table 658 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 658. Changes to Link-Edited Modules for CF Record Lock Support

Link-Edited Module New, Changed, or No Longer Supported? Description of Change
CPS0 Changed Updated by CF record lock support to add the CCCFLC CSECT.

Members (Object Files)

Table 659 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).

Notes:

  1. You must recompile or reassemble a member (object file) if it has changed.

  2. You must prelink and link a dynamic load module (DLM) if it has changed.

Table 659. Changes to Members (Object Files) for CF Record Lock Support

Member (Object File) DLM/DLL New, Changed, or No Longer Supported? Type Description of Change
CFCNC CFLZ Changed C Language Updated by CF record lock support to provide additional validation on CF locking structures.
CFDSC CFLY Changed C Language Updated by CF record lock support.
CFFIND CFLC Changed C Language Updated by CF record lock support to provide support for CF locking fixed file records.
CFLA CFLA New C Language Created by CF record lock support.
CFLB CFLB New C Language Created by CF record lock support.
CFLD CFLK New Assembler Created by CF record lock support.
CFLDEL CFLK New C Language Created by CF record lock support.
CFLE CFLE New C Language Created by CF record lock support.
CFLIPA CFLG New C Language Created by CF record lock support.
CFLIPD CFLG New C Language Created by CF record lock support.
CFLIPM CFLG New C Language Created by CF record lock support.
CFLIP0 CFLG New C Language Created by CF record lock support.
CFLK CFLK New C Language Created by CF record lock support.
CFLL CFLK, CFLG New C Language Created by CF record lock support.
CFLO CFLK New C Language Created by CF record lock support.
CFLW CFLK New Assembler Created by CF record lock support.
CFMADD CFLN Changed C Language Updated by CF record lock support
CFMCLE CFLN New C Language Created by CF record lock support.
CFMDEL CFLN Changed C Language Updated by CF record lock support to provide retry buffer support.
CFMENA CFLN Changed C Language Updated by CF record lock support to provide retry buffer support.
CFMFRE CFLN Changed C Language Updated by CF record lock support.
CFMPAR CFLM Changed C Language Updated by CF record lock support for the ZMCFT parser.
CFMRES CFLN Changed C Language Updated by CF record lock support for ZMCFT RESETLOCK processing.
CFMSGS CFLU Changed C Language Updated by CF record lock support to add the messages for the ZMCFT CLEAR command.
CFRST1 CFLR Changed C Language Updated by CF record lock support.
CFRST2 CFLS Changed C Language Updated by CF record lock support to save the number #CFREC records in the CFCC copy member.
CFSBFD CFLZ Changed C Language Updated by CF record lock support to provide connections to CF locking structures in CF locking restart.
CFSBFL CFLY, CFLZ Changed C Language Updated by CF record lock support to provide connections to CF locking structures in CF locking restart.
CFSTBE CFLP Changed C Language Updated by CF record lock support to provide retry buffer support.
CFSTRF CFLQ Changed C Language Updated by CF record lock support to refresh the main storage copy of the CFST.

Object Code Only (OCO) Stubs

There are no changes.

Configuration Constant (CONKC) Tags

There are no changes.

Control Program Interface (CINFC) Tags

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

Table 660. Changes to CINFC Tags for CF Record Lock Support

CINFC Tag Equate Value New, Changed, or No Longer Supported?
CMMCFL 370 New

Copy Members

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

Table 661. Changes to Copy Members for CF Record Lock Support

Copy Member Type CSECT Where Copy Member Is Located DLM Where CSECT Is Located New, Changed, or No Longer Supported? Description of Change
CAAA Control Program CCNUCL Not Applicable Changed Updated by CF record lock support for the control program (CP) table of contents.
CAPT Control Program CCNUCL Not Applicable Changed Updated by CF record lock support to save the complex ID and complex name.
CCEB Control Program CCENBK Not Applicable Changed Updated by CF record lock support.
CDC1 Control Program CCDCOL Not Applicable Changed Updated by CF record lock support for data collection.
CEDT Control Program CCCPSE Not Applicable Changed Updated by CF record lock support.
CEFA Control Program CCTAPE Not Applicable Changed Updated by CF record lock support.
CEFB Control Program CCTAPE Not Applicable Changed Updated by CF record lock support.
CEFE Control Program CCTAPE Not Applicable Changed Updated by CF record lock support.
CEFH Control Program CCSONA Not Applicable Changed Updated by CF record lock support to allow the ZECBL command to work correctly when CF record lock support is being used in the CF locking configuration.
CEFI Control Program CCFADC Not Applicable Changed Updated by CF record lock support.
CEFJ Control Program CCFADC Not Applicable Changed Updated by CF record lock support.
CEFL Control Program CCFADC Not Applicable Changed Updated by CF record lock support.
CEFM Control Program CCTAPE Not Applicable Changed Updated by CF record lock support.
CEFR Control Program CCTAPE Not Applicable Changed Updated by CF record lock support.
CEFS Control Program CCTAPE Not Applicable Changed Updated by CF record lock support.
CEFT Control Program CCTAPE Not Applicable Changed Updated by CF record lock support.
CFCC Control Program CCCFCC Not Applicable Changed Updated by CF record lock support.
CFCE Control Program CCCFCC Not Applicable Changed Updated by CF record lock support to add CF retry buffer support.
CFCM Control Program CCCFCC Not Applicable Changed Updated by CF record lock support to add CF retry buffer support.
CFCP Control Program CCCFCC Not Applicable Changed Updated by CF record lock support.
CFCR Control Program CCCFCC Not Applicable Changed Updated by CF record lock support to add new CF routines.
CFCS Control Program CCCFCC Not Applicable Changed Updated by CF record lock support to add new utility routines.
CFL1 Control Program CCCFLC Not Applicable New Created by CF record lock support.
CFL2 Control Program CCCFLC Not Applicable New Created by CF record lock support.
CFL3 Control Program CCCFLC Not Applicable New Created by CF record lock support.
CICR Control Program CCNUCL Not Applicable Changed Updated by CF record lock support to add the new CMMCFL CINFC tag.
CIDP Control Program CCCPSE Not Applicable Changed Updated by CF record lock support to include IBM dump overrides.
CJIC Control Program CCSONS Not Applicable Changed Updated by CF record lock support.
CJIE Control Program CCSONS Not Applicable Changed Updated by CF record lock support.
CJIF Control Program CCSONS Not Applicable Changed Updated by CF record lock support.
CJII Control Program CCSONS Not Applicable Changed Updated by CF record lock support to set on the SSST and MFST flags for the concurrency filter lock facility (CFLF) devices that are using CF record lock support.
CJIL Control Program CCSONS Not Applicable Changed Updated to follow locking paths for modules using CF record lock support.
CJIM Control Program CCSONS Not Applicable Changed Updated to follow locking paths for modules using CF record lock support.
CJIR Control Program CCSONS Not Applicable Changed Updated for CF record lock support.
CJIT Control Program CCSONS Not Applicable Changed Updated for CF record lock support.
CJIU Control Program CCSONS Not Applicable Changed Updated by CF record lock support to direct locking requests to a CF when required.
CJIV Control Program CCRCSC Not Applicable Changed Updated by CF record lock support.
CJIX Control Program CCSONS Not Applicable Changed Error routines were updated by CF record lock support to determine if locking is on the CF before taking action.
CJIY Control Program CCSONS Not Applicable Changed Error routines were updated by CF record lock support to determine if locking is on the CF before taking action.
CLHL Control Program CCCLHR Not Applicable Changed Updated by CF record lock support.
CL10 Control Program CCTLOG Not Applicable Changed Updated by CF record lock support.
CPSE Control Program CCCPSE Not Applicable Changed Updated by CF record lock support to update the emergency unlock routine.
CPSF Control Program CCCPSF Not Applicable Changed Updated by CF record lock support.
CPSL Control Program CCCPSE Not Applicable Changed Updated by CF record lock support to dump new control blocks.
CSYN Control Program CCNUCL Not Applicable Changed Updated by CF record lock support.
CTIN Control Program CCCTIN Not Applicable Changed Updated by CF record lock support.
CT00 Control Program CCCTIN Not Applicable Changed Updated by CF record lock support.
CT01 Control Program CCCTIN Not Applicable Changed Updated by CF record lock support.
CT20 Control Program CCCTIN Not Applicable Changed Updated by CF record lock support.
CT38 Control Program CCCTIN Not Applicable Changed Updated by CF record lock support to allocate the CF locking table (CFLT).
CT40 Control Program CCCTIN Not Applicable Changed Updated by CF record lock support.
CT41 Control Program CCCTIN Not Applicable Changed Updated by CF record lock support to a routine for data collection.
CT50 Control Program CCCTIN Not Applicable Changed Updated by CF record lock support.
CT85 Control Program CCCTIN Not Applicable Changed Updated by CF record lock support.
CT99 Control Program CCCTIN Not Applicable Changed Updated by CF record lock support.
CVF3 Control Program CCVFAC Not Applicable Changed Updated by CF record lock support to provide lock table full support.
DBAC Control Program CCDBAF Not Applicable Changed Updated by CF record lock support.
DBAD Control Program CCDBAF Not Applicable Changed Updated by CF record lock support.
IBF2 Control Program IPLB Not Applicable Changed Updated by CF record lock support to allow the TPF 4.1 system to IPL as a loosely coupled processor if CF record lock support is in use for modules whose CUs do not have locking enabled.
IB03 Control Program IPLB Not Applicable Changed Updated by CF record lock support to allow the TPF 4.1 system to IPL as a loosely coupled processor if CF record lock support is in use for modules whose CUs do not have locking enabled.
IB06 Control Program IPLB Not Applicable Changed Updated by CF record lock support to allow the TPF 4.1 system to IPL as a loosely coupled processor if CF record lock support is in use for modules whose CUs do not have locking enabled.

Fixed File Records

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

Table 662. Changes to Fixed File Records for CF Record Lock Support

Fixed File Record New, Changed, or No Longer Supported? Description of Change
#CF2LR New Created by CF record lock support.

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

Table 663. Changes to Data Macros for CF Record Lock Support

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs That Use This Data Macro?
CJ6KP Changed Yes
DCTMFS Changed No
DCTMIO Changed No
DC0DC Changed Yes
DLTEC Changed Yes
ICFAA Changed No
ICFBB New No
ICFCT Changed No
ICFDL New No
ICFEQ Changed No
ICFLP New No
ICFLR New Yes
ICFLS New Yes
ICFLT New Yes
ICFLV New Yes
ICFMB New Yes
ICFRB Changed No
ICFSB Changed No
ICFST Changed No
ICFTT Changed No
IC0CK Changed Yes
IDSCFW Changed No
IDSSST Changed No
IFAPI Changed No
IIPLI New No
IMCPT New No
IMDDB Changed No
MRLNQ Changed Yes
MV0LKC New Yes
PI1DT Changed No
VF0AC Changed No

General Macros

Table 664 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 664. Changes to General Macros for CF Record Lock Support

General Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
CINFC Changed No

Selected Equate Macros

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

Table 665. Changes to Selected Equate Macros for PROJECT

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

Structured Programming Macros (SPMs)

There are no changes.

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

Table 666 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 666. Changes to SIP Skeleton and Internal Macros for CF Record Lock Support

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

System Initialization Program (SIP) Stage I Macros and Statements

Table 667 summarizes system initialization program (SIP) Stage I macro and statement changes. This information is presented in alphabetic order by the name of the SIP Stage I macro. See TPF System Generation for a complete description of the SIP Stage I macros. If the SIP Stage I macro is changed, you must run the appropriate job control language (JCL) jobs from the SIP Stage II deck.

See System Initialization Program (SIP) and System Generation Changes for a description of other system generation changes you must make.

Table 667. Changes to SIP Stage I Macros and Statements for CF Record Lock Support

SIP Stage I Macro New, Changed, or No Longer Supported?
GENSIP Changed
SKCTK6 Changed

System Initialization Program (SIP) Stage II Macros

Table 668 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 668. Changes to SIP Stage II Macros for CF Record Lock Support

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

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

Table 669 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 669. Changes to System Macros for CF Record Lock Support

System Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
CFDISC Changed Yes
FCTLC Changed Yes
IBMSVC Changed Yes
IDATB Changed Yes
LEMIC New No
SLNKC Changed No
$GIOBC Changed Yes
$ULKRC Changed Yes

System Macros (IBM Use Only)

Table 670 summarizes system macro changes that are for IBM use only. This information is presented in alphabetic order by the name of the system macro.

Table 670. Changes to System Macros (IBM Use Only) for CF Record Lock Support

System Macro (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
CFRQC Changed Yes
$GCFBC Changed No

Segments

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

Table 671. Changes to Segments for CF Record Lock Support

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
CCCFCC CSECT Not Applicable Changed Updated by CF record lock support.
CCCFLC CSECT Not Applicable New Created by CF record lock support.
CCRCSC CSECT Not Applicable Changed Updated by CF record lock support.
CCSONS CSECT Not Applicable Changed Updated by CF record lock support.
CCVFAC CSECT Not Applicable Changed Updated by CF record lock support.
CFL7 C Language Not Applicable New Created by CF record lock support.
CFL8 Real-Time Assembler Not Applicable New Created by CF record lock support.
CFL9 Real-Time Assembler Not Applicable New Created by CF record lock support.
CFMA Real-Time Assembler Not Applicable New Created by CF record lock support.
CLMA Real-Time Assembler Not Applicable Changed Updated by CF record lock support to call the CLM6 segment to disconnect from CF locking structures if, during deactivation, CF record lock support is active in the CF locking configuration.
CLMB Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CLMC Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CLMD Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CLME Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CLMI Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CLMK Real-Time Assembler Not Applicable New Created by CF record lock support.
CLML Real-Time Assembler Not Applicable New Created by CF record lock support.
CLMM Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CLMN Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CLMR Real-Time Assembler Not Applicable New Created by CF record lock support.
CLMZ Real-Time Assembler Not Applicable New Created by CF record lock support.
CLM0 Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CLM1 Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CLM2 Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CLM6 Real-Time Assembler Not Applicable New Created by CF record lock support.
CLM7 Real-Time Assembler Not Applicable New Created by CF record lock support.
CLM8 Real-Time Assembler Not Applicable New Created by CF record lock support.
CLM9 Real-Time Assembler Not Applicable New Created by CF record lock support.
CNPY Real-Time Assembler Not Applicable Changed Updated by CF record lock support for the processor ID table (PIDT) and keypoint I (CTKI) initialization; to validate the processor status in a loosely coupled complex; to perform MPLF restart and CF locking restart; to handle CTKI manipulations for an IPL destruct.
CPAA Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CPAB Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CPAD Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CPLKMP CSECT Not Applicable Changed Updated by CF record lock support for the copy cards for the CP link map.
CTKS Real-Time Assembler Not Applicable Changed Updated by CF record lock support to add CF locking restart.
CVAB Real-Time Assembler Not Applicable Changed Updated by CF record lock support for new commands.
CYED Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CYGN Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CYMA Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CYPF Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CYPG Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CYPH Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CYPI Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CYPL Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CYPM Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CYPN Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
CYPU Real-Time Assembler Not Applicable Changed Updated by CF record lock support.
FTVA03 Offline C Language FCTBG Changed Updated by CF record lock support.
IB02 Offline Assembler IPLB Changed Updated by CF record lock support.
IB03 Offline Assembler IPLB Changed Updated by CF record lock support.
IB06 Offline Assembler IPLB Changed Updated by CF record lock support.
JCD1 Real-Time Assembler Not Applicable Changed Updated by CF record lock support to add data collection support.
JCD2 Real-Time Assembler Not Applicable Changed Updated by CF record lock support to add data collection support.
JCD4 Real-Time Assembler Not Applicable Changed Updated by CF record lock support to add data collection support.
JCD6 Real-Time Assembler Not Applicable Changed Updated by CF record lock support to add data collection support.
JCS0 Real-Time Assembler Not Applicable Changed Updated by CF record lock support to add data collection support.
JRA1 Real-Time Assembler Not Applicable Changed Updated by CF record lock support to add data reduction support.
JRA2 Real-Time Assembler Not Applicable Changed Updated by CF record lock support to add data reduction support.
JRA3 Real-Time Assembler Not Applicable Changed Updated by CF record lock support to add data reduction support.
JRS3 Real-Time Assembler Not Applicable Changed Updated by CF record lock support to add data reduction support.

System Equates

There are no changes.

User Exits

There are no changes.

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 672 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 672. Changes to Commands for CF Record Lock Support

Command New, Changed, or No Longer Supported? Description of Change
ZCFLK ADD New Created by CF record lock support to add a CF to the locking configuration for use as an external locking facility (XLF).
ZCFLK DELETE New Created by CF record lock support to remove a CF from the CF locking configuration.
ZCFLK DISPLAY New Created by CF record lock support to display information about the CF locking configuration.
ZCFLK INITIALIZE New Created by CF record lock support to initialize the CF locking configuration.
ZCFLK MIGRATE New Created by CF record lock support to change the lock residency of a module from a CFLF locking CU to a CF, or from a CF to a CFLF locking CU.
ZDLCK DISPLAY New Created by CF record lock support to display locks in a CF.
ZDMFS Changed Updated by CF record lock support to add CF locking as a type for lock status.
ZMCFT ADD Changed Updated by CF record lock support to add retry buffer support.
ZMCFT CLEAR New Created by CF record lock support to remove from a CF the CF structures that are not known to this processor configuration.
ZMCFT DELETE Changed Updated by CF record lock support to add retry buffer support.
ZMCFT ENABLE Changed Updated by CF record lock support to synchronize records in the CF structure block (CFSB) with CF contents.

Messages and System Errors

Table 673 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 673. Changes to Messages and System Errors for CF Record Lock Support

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
000038 System Error Changed
0000DA System Error New
0006AE System Error No Longer Supported
004600 System Error New
004601 System Error New
004602 System Error New
004603 System Error New
004604 System Error New
004605 System Error New
004606 System Error New
004607 System Error New
004608 System Error New
004609 System Error New
00460A System Error New
00460B System Error New
00460C System Error New
004610 System Error New
004611 System Error New
004612 System Error New
004613 System Error New
004614 System Error New
004615 System Error New
004616 System Error New
004617 System Error New
00461E System Error New
00461F System Error New
004620 System Error New
004621 System Error New
004622 System Error New
004623 System Error New
004624 System Error New
004626 System Error New
004627 System Error New
004628 System Error New
004629 System Error New
00462A System Error New
00462B System Error New
00462C System Error New
00462D System Error New
00462E System Error New
00462F System Error New
004630 System Error New
004632 System Error New
004633 System Error New
004634 System Error New
004635 System Error New
004637 System Error New
004638 System Error New
004640 System Error New
004641 System Error New
004642 System Error New
004643 System Error New
004644 System Error New
004645 System Error New
004646 System Error New
004647 System Error New
004648 System Error New
004649 System Error New
00464A System Error New
00464B System Error New
00464C System Error New
00464D System Error New
00464E System Error New
00464F System Error New
004650 System Error New
00500A System Error Changed
CFCC0020E Online Changed
CFCC0021E Online Changed
CFCC0022E Online Changed
CFCE0006E Online New
CFCE0007E Online New
CFLK0001I Online New
CFLK0002I Online New
CFLK0003I Online New
CFLK0004I Online New
CFLK0005E Online New
CFLK0006E Online New
CFLK0007I Online New
CFLK0009I Online New
CFLK0011I Online New
CFLK0012E Online New
CFLK0013E Online New
CFLK0014I Online New
CFLK0015I Online New
CFLK0016I Online New
CFLK0018E Online New
CFLK0019E Online New
CFLK0020E Online New
CFLK0021I Online New
CFLK0022E Online New
CFLK0023E Online New
CFLK0024E Online New
CFLK0025E Online New
CFLK0026E Online New
CFLK0027E Online New
CFLK0028I Online New
CFLK0029T Online New
CFLK0030E Online New
CFLK0031E Online New
CFLK0032E Online New
CFLK0033E Online New
CFLK0034E Online New
CFLK0035E Online New
CFLK0036E Online New
CFLK0037E Online New
CFLK0038E Online New
CFLK0039E Online New
CFLK0040E Online New
CFLK0041T Online New
CFLK0042T Online New
CFLK0043E Online New
CFLK0045E Online New
CFLK0200I Online New
CFLK0201E Online New
CFLK0202E Online New
CFLK0204I Online New
CFLK0205E Online New
CFLK0206E Online New
CFLK0207E Online New
CFLK0208E Online New
CFLK0209W Online New
CFLK0211E Online New
CFLK0212E Online New
CFL00001W Online New
CFL00002W Online New
CFL00003W Online New
CFL20001W Online New
CLM00001E Online No Longer Supported
CLM00002E Online New
CLM60001W Online New
CLM60002W Online New
CLM60003W Online New
CLM60004W Online New
CLM60005W Online New
CLM80001E Online New
CLM80002E Online New
CLM80004E Online New
CLM80005E Online New
CLM80006E Online New
CLM80007E Online New
CLM80008E Online New
CLM80009I Online New
CPAA0013E Online New
CPSF0028W Online New
MCFT0005T Online Changed
MCFT0027E Online Changed
MCFT0035I Online New
MCFT0036E Online New
MCFT0038E Online New
MCFT0039E Online New
MCFT0040E Online New
MCPY0225E Online New
RHLD0025E Online New

Performance or Tuning Changes

There are no changes.

Storage Considerations and Changes

Review the information about system work blocks (SWBs) in Storage Considerations and Changes.

System Initialization Program (SIP) and System Generation Changes

The FC2F record ID attribute table (RIAT) ID was added for CF record lock support. Be sure to rebuild a RIAT table with this new record ID. You must also code the #CF2LR record type in the SIP Stage I deck and run the file address to produce a new file address compute program (FACE) table.

See TPF System Generation for more information about RIAT IDs, the FCTBG, and SIP.

Loading Process Changes

There are no changes.

Online System Load Changes

There are no changes.

Publication Changes

Table 674 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 674. Changes to TPF Publications for CF Record Lock Support

Publication Title Softcopy File Name Description of Change
TPF C/C++ Language Support User's Guide GTPCLU0B Updated to add the tpf_lemic function. Modifications were also made to the tpf_cfconc, serrc_op, serrc_op_ext, and serrc_op_slt functions.
TPF Concepts and Structures GTPCON08 Updated to include information about CF record lock support.
TPF Database Reference GTPDBR09 Updated to include information about CF record lock support.
Messages (System Error and Offline) and Messages (Online) Not Applicable Updated with information about messages and system errors that were added and changed for CF record lock support.
TPF Migration Guide: Program Update Tapes GTPMG201 Updated with migration considerations for CF record lock support.
TPF Operations GTPOPR0B Updated with information about the commands that were added and changed for CF record lock support.
TPF Program Development Support Reference GTPPDR0B Updated with new dump labels that were added for CF record lock support.
TPF System Generation GTPSYG0B Updated to include system generation information for CF record lock support.
TPF System Macros GTPSYS0B Updated with information about the new LEMIC macro. Updates were also made to the existing CFCONC and FCTLC macros.
TPF System Performance and Measurement Reference GTPSPR0A Updated with changes for data collection and reduction reports.

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

Keep in mind the following before installing CF record lock support in your TPF 4.1 system:

Use the following procedure to install CF record lock support on your TPF 4.1 system.

  1. Install program update tape (PUT) 11, which contains APAR PJ26707 for CF record lock support, on the TPF 4.1 system.
  2. Install the following:
  3. Run the system allocator (SALO) using IBMPAL and SPPGML additions for newly created segments to create an updated program allocation table (PAT) and system allocator (SAL) table. See Table 671 for more information about segments.
  4. Update the record ID attribute table (RIAT) with the new FC2F record ID, as appropriate. See TPF System Generation for more information about the RIAT.
  5. Update the SIP RAMFIL macro input statements to the FACE table generator (FCTBG) by specifying the #CF2LR fixed file record type with 32 ordinals defined. The #CF2LR fixed file record type has a RIAT ID of FC2F. See TPF System Generation for more information about the RAMFIL macro.
  6. Run the FCTBG to create a new FACE table.
  7. Assemble the SIP stage I deck to create a SIP stage II deck.
  8. Run SIP stage II.
  9. Run stubs and module build from VisualAge TPF for Windows NT for all library interface scripts listed in Table 656.
  10. Reassemble or recompile the following:
  11. Reassemble or recompile the following segments. These segments were not modified by CF record lock support but must be reassembled or recompiled because there were CF record lock support modifications made to macros used by these segments.

     CLMF 
    CLMG

     CLMH 
    CLM3

     CPAA 
    CPAD

     CSS2 
    CTKR

     CVFS 
    CVF2

     CVF4 
    CVF7

     CVF9 
    CVFX

     CYEM 
    CYEN

     CYEP 
    CYPI

     CYSA 
    CYSM

     JCD0 
    JCD3

     JCF0 
    JCM0

     JCP0 
     
  12. Link-edit the build scripts (DLMs) listed in Table 653.
  13. Link-edit the control program (CP).
  14. Define a load deck for the auxiliary loader (TLDR) that includes the following:
    • Updated programs
    • Updated CP
    • Updated IPLB program
    • Updated IPAT
    • Updated FACE table.
  15. Run TLDR.
  16. Perform an initial program load (IPL) of the TPF 4.1 system.
  17. Enter the ZCFLK INITIALIZE command to initialize the CF locking configuration.
  18. Re-IPL all processors in the processor configuration. CF record lock support is now installed on your TPF 4.1 system.