gtpm2m1jMigration Guide: Program Update Tapes

TPF Collection Support (APAR PJ25098)

The following section discusses the migration considerations for TPF collection support (TPFCS).

Prerequisite APARs

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

Functional Overview

TPF collection support (TPFCS) is a database manager service that enables application programs running on TPF to create, modify, and access collections. Collections are abstract representations of data. TPFCS provides three collection lifetimes:

Collections are said to be persistent if they maintain their state beyond the life of the entry control block (ECB) that creates them. Those which are temporary maintain their state and are accessible only for the life of the ECB that creates them.

TPFCS transparently integrates database functionality with the application program and eliminates the need for data translation routines.

It is extremely important to be able to use a single, client-level application programming interface (API) for saving and managing data regardless of how that data is physically stored on the database. Most companies store their critical data in several different types of databases. Programs that store and access this data need to be aware of the format that the data is in, which potentially limits code reuse and restricts the data format from changing. With a TPFCS database, application programs can essentially access and manage the data without the TPF 4.1 system having any knowledge of the contents of the data stored. Furthermore, the TPFCS APIs can be called directly from C and C++ programs.

The TPFCS database consists of user-defined components known as data stores. Each data store can contain multiple collections with several different abstract collection types available in the TPFCS collection library. Each collection consists of zero or more related elements that are the same type. Each element may be a primitive data type, a structure with subfields, a reference to a TPF file, or a reference to another collection.

To increase the productivity of application programmers, TPFCS provides:

The collection library enables you to choose the appropriate abstract collection type for a given condition by providing collections that are complete, systematic, and have a consistent combination of basic properties. These properties help you to select abstract collection types that are at the appropriate level of abstraction. For example, in a particular application program you may have the choice between using a bag or a key bag collection. A bag is an unordered collection of zero or more elements with no key. A key bag is an unordered collection of zero or more elements that have a key. The properties of these two collections will help you decide which one is more appropriate. See TPF Application Programming for more information about properties.

Special and Lowercase Characters

The TPF 4.1 system no longer translates special and lowercase characters in output messages into periods (.) for the following commands:

If you have workstations that do not support special or lowercase characters, translate the output into characters that your workstations do support by using the UCCWTOP user exit. This is very important because sending output to a workstation in a format that the workstation does not support can cause results that cannot be predicted.

See TPF System Installation Support Reference for more information about the UCCWTOP user exit. See TPF Programming Standards for more information about special characters.

Supervisor Call (SVC) User Exit Information

The following information is included for those who have SVC user exits active.

TPF collection support uses a modified form of the FIND and FILE macros. Instead of passing information in the data levels of the entry control block (ECB), TPF collection support passes the corresponding information in a control block called a DECB (IDSDEC). When the FIND or FILE SVC is issued, the data level value is set to X'FF' and register 14 contains the address of the DECB control block. The information for the request is then retrieved from the passed DECB control block.

TPF collection support uses the following modified FIND and FILE macros:

See TPF General Macros for more information about the FIND and FILE macros.

The control program support for these modified macros is found in the CEFL copy segment in CCFADC.

The DECB fields contain the same format as a core block reference word (CBRW), file address reference word (FARW), and extended file address reference word (FAXW). The DECB fields are used as follows:

 IDECUCRW 
Corresponds to an ECB core block level.

 IDECUDAD 
Contains the address of the core block to be used or 0.

 IDECUCT0 
Contains the core block type indicator or X'0001' to signify there is no core block attached.

 IDECUDLH 
Contains the data length.

 IDECUFRW 
Corresponds to an ECB file address reference word.

 IDECURID 
Contains the record ID for the request.

 IDECURCC 
Contains the record code check (RCC) value for the request.

 IDECUFA 
Contains the file address for the request.

 IDECUFX0 
Contains the extended file address reference word information.

 IDECUSUD 
When completed, this field will be set to the SUD error value or zero if there is no error.

Because the data level value is set to X'FF', the data level in the macro trace in a dump is printed as an asterisk (*).

In addition, because TPF collection support must be able to easily switch subsystems, the DECB control block also contains the database ID (DBI) and subsystem user (SSU) values to use for the request. The IDECUDBI field contains the DBI value and the IDECUSSU field contains the SSU value. If IDECUDBI is zero, the DBI of the ECB and SSU values are used.

Architecture

There are no changes.

Operating Environment Requirements and Planning Information

There are none.

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 370 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 370. Changes to Build Scripts for TPF Collection Support

Build Script Type New, Changed, or No Longer Supported? Description of Change
CJ00BS DLM New Added build script for the TPFCS central routines.
CJ01BS DLM New Added build script for the ZOODB command.
CJ03BS DLM New Added build script for the TPFCS internal task dispatcher.
CJ04BS DLM New Added build script for the TPFCS restart scheduler.
CJ10BS DLM New Added build script for the ZBROW commnd.
CJ13BS DLM New Added build script for TPFCS recoup persistent identifier (PID) chase build script.
CJ17BS DLM New Added build script for TPFCS recoup build script.
CORMBS DLM New Added build script for external device support.
CTALBS DLM Changed Updated for external device support.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

Table 371 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 371. Changes to General Use C/C++ Language Header Files for TPF Collection Support

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$syseq.h Changed No
c$to2.h New No
c$tpxd.h New No
plfapi.h Changed No
reusable.h Changed No
tpftape.h Changed No
types.h Changed No

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

Table 372 summarizes the general use C/C++ language header file changes that are for IBM use only. This information is presented in alphabetic order by the name of the general use C/C++ language header file.

Table 372. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for TPF Collection Support

C/C++ Language Header File (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$ccw1.h New No
c$tdat.h New No
c$tgdt.h New No
c$to2m.h New No

Library Interface Scripts

Table 373 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 373. Changes to Library Interface Scripts for TPF Collection Support

Library Interface Script New, Changed, or No Longer Supported? Description of Change
CJ00XV New Added library interface script for TPFCS.
CTALXV Changed Added external device support APIs.

Library Members (Object Files)

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

Table 374. Changes to Library Members (Object Files) for TPF Collection Support

Library Member (Object File) Library Module Name New, Changed, or No Longer Supported? Type Description of Change
CJ000 CJ00 New Assembler Added for TPFCS control, collection, and cursor classes.
CJ003 CJ00 New Assembler Added for TPFCS API routines.
CJ004 CJ00 New Assembler Added TPFCS structure classes.
CJ005 CJ00 New Assembler Added TPFCS C language interface routines.

Link-Edited Modules

There are no changes.

Members (Object Files)

Table 375 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 375. Changes to Members (Object Files) for TPF Collection Support

DLM Member (Object File) DLM/DLL New, Changed, or No Longer Supported? Type Description of Change
CEXTDV CTAL New C Language Created for TPFCS.
CJ01 CJ01 New Assembler Added the ZOODB command parser.
CJ02 CJ01 New Assembler Added the ZOODB command parser.
CJ03 CJ03 New Assembler Added the TPFCS internal task dispatcher.
CJ04 CJ04 New Assembler Added the TPFCS restart handler.
CJ13 CJ13 New Assembler Added the TPFCS recoup PID chasing processing.
CJ17 CJ17 New Assembler Added the TPFCS recoup processing.
CJ016 CJ00 New C Language Added TPFCS C language interface routines.
CJ100 CJ10 New Assember Added the ZBROW command routines.
CJ105 CJ10 New C Language Added the ZBROW DOCUMENT command support routines.
CJ106 CJ10 New C Language Added the ZBROW NAME command support routines.
CJ107 CJ10 New C Language Added the ZBROW PROPERTY command support routines.
CJ109 CJ10 New C Language Added the ZBROW report command display routines.
C190 CORM Changed Assembler Added external device support.
CORM CORM New C Language Added external device support.
CORMAS CORM New Assembler Added for external device support.

Object Code Only (OCO) Stubs

There are no changes.

Configuration Constant (CONKC) Tags

There are no changes.

Control Program Interface (CINFC) Tags

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

Table 376. Changes to CINFC Tags for TPF Collection Support

CINFC Tag Equate Value New, Changed, or No Longer Supported?
CMMDXVT 371 New

Copy Members

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

Table 377. Changes to Copy Members for TPF Collection Support

Copy Member Type CSECT Where Copy Member Is Located New, Changed, or No Longer Supported? Description of Change
CEFE Control Program CCTAPE Changed Updated to support the tdspc_v C function.
CICR Control Program CCFADC Changed Updated for macro service routines (1).
CJ001 Real-Time Assembler CJ003 New Created for TPFCS library C function support routines.
CJ002 Real-Time Assembler CJ000, CJ003, CJ004, CJ005 New Created for TPFCS common macro definitions.
CJ015 Real-Time Assembler CJ005 New Created for TPFCS system services class.
CJ020 Real-Time Assembler CJ000 New Created for TPFCS directory entry support.
CJ021 Real-Time Assembler CJ006 New Created for TPFCS directory entry support.
CJ022 Real-Time Assembler CJ005 New Created for TPFCS database support objects.
CJ025 Real-Time Assembler CJ006 New Created for TPFCS collection class definitions.
CJ026 Real-Time Assembler CJ006 New Created for TPFCS cursor class definitions.
CJ030 Real-Time Assembler CJ004 New Created for TPFCS structure class definitions.
CJ036 Real-Time Assembler CJ004 New Created for TPFCS index structure support.
CJ037 Real-Time Assembler CJ004 New Created for TPFCS flat structure support.
CJ038 Real-Time Assembler CJ004 New Created for TPFCS hash structure support.
CJ039 Real-Time Assembler CJ004 New Created for TPFCS.
CJ101 Real-Time Assembler CJ100 New Created for the ZBROW command.
CJ102 Real-Time Assembler CJ100 New Created for the ZBROW command.
CJ103 Real-Time Assembler CJ100 New Created for the ZBROW command.
CJ104 Real-Time Assembler CJ100 New Created for the ZBROW command.
CPSL Control Program CCCPSE Changed Write system error dump.
CRTT Control Program CCUTIL Changed Updated for TPFCS support.
CTSF Control Program CCUTIL Changed Updated for TPFCS support.
CT01 Control Program CCCTIN Changed Updated to carve storage for the archive control table and put the address of each subsystem (SS) unique table in the appropriate CINFC tag.
MPTV Control Program CCUTIL New Updated for TPFCS support.

Fixed File Records

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

Table 378. Changes to Fixed File Records for TPF Collection Support

Fixed File Record New, Changed, or No Longer Supported? Description of Change
#IBMM4 Changed Updated for TPFCS to include the #TO2CTL (ordinal 121) and #TO2SHW (ordinal number 148).

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

Table 379. Changes to Data Macros for TPF Collection Support

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs That Use This Data Macro?
ITO2 New No
ITSTB Changed No

General Macros

Table 380 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 380. Changes to General Macros for TPF Collection Support

General Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
GLOBZ Changed No - Code updates only; there are no updates to TPF General Macros.
SYSEQ Changed No - Code updates only; there are no updates to TPF General Macros.
TDSPC Changed No - Code updates only; there are no pub updates to TPF General Macros.

Selected Equate Macros

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

Table 381. Changes to Selected Equate Macros for TPF Collection Support

Selected Equate Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
BRPEQ Changed No
GL0BQ Changed No
TAPEQ Changed No

Structured Programming Macros (SPMs)

There are no changes.

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

Table 382 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 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 382. Changes to SIP Skeleton and Internal Macros for TPF Collection Support

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

System Initialization Program (SIP) Stage I Macros and Statements

Table 383 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 383. Changes to SIP Stage I Macros and Statements for TPF Collection Support

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

System Initialization Program (SIP) Stage II Macros

Table 384 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 384. Changes to SIP Stage II Macros for TPF Collection 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 385 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 385. Changes to System Macros for TPF Collection Support

System Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
BBWRT Changed No - Code updates only; there are no updates to TPF System Macros.
FTSTC Changed No - Code updates only; there are no updates to TPF System Macros.
IBMSVC Changed Yes
INDEX Changed No
RITID Changed No - Code updates only; there are no pub updates to TPF System Macros.
TDTAC Changed No

System Macros (IBM Use Only)

There are no changes.

Segments

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

Table 386. Changes to Segments for TPF Collection Support

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
BCC1 Real-Time Assembler Not Applicable Changed Updated for recoup chain chase type F.
BCC2 Real-Time Assembler Not Applicable Changed Updated for recoup chain chase type V.
BKA0 Real-Time Assembler Not Applicable Changed Updated for selective recoup.
BKB0 Real-Time Assembler Not Applicable Changed Updated for selective recoup.
BKDIND Offline Assembler BKDI Changed Updated for a recoup descriptor summary.
BKP0 Real-Time Assembler Not Applicable Changed Updated for a recoup loosely coupled message preprocessor.
Note:
This update was made for the High Performance Option (HPO) feature only.
BRCP Real-Time Assembler Not Applicable Changed Updated for recoup input message analyzer, part 1.
BRPC Real-Time Assembler Not Applicable Changed Updated for recoup descriptor scheduler (non-MDBF).
BRPE Real-Time Assembler Not Applicable Changed Updated for recoup abort routine.
BRPI Real-Time Assembler Not Applicable Changed Updated for recoup start message processor.
BRPT Real-Time Assembler Not Applicable Changed Updated for recoup status message processor.
BSSC Real-Time Assembler Not Applicable Changed Updated for recoup MDBF descriptor scheduler.
Note:
This update was made for the High Performance Option (HPO) feature only.
CJ05 Real-Time Assembler Not Applicable New Created for TPFCS.
CJ12 Real-Time Assembler Not Applicable New Created for TPFCS recoup message handler.
CJ16 Real-Time Assembler Not Applicable New Created for TPFCS recoup interface.
COSB Real-Time Assembler Not Applicable Changed Updated for TPFCS.
COSD Real-Time Assembler Not Applicable Changed Updated to allow all ARx (ARA-ARZ, and AR0-AR9) tapes to use the ARC TPLD/TLMR record. ARC is a 3-character name used to identify a tape drive used for the TPFxd_ functions.
COSE Real-Time Assembler Not Applicable Changed Updated to allow all ARx (ARA-ARZ, and AR0-AR9) tapes to use the ARC TPLD/TLMR record. ARC is a 3-character name used to identify a tape drive used for the TPFxd_ functions.
COSF Real-Time Assembler Not Applicable Changed Updated to allow all ARx (ARA-ARZ, and AR0-AR9) tapes to use the ARC TPLD/TLMR record. ARC is a 3-character name used to identify a tape drive used for the TPFxd_ functions.
COTL Real-Time Assembler Not Applicable Changed Updated to allow all ARx (ARA-ARZ, and AR0-AR9) tapes to use the ARC TPLD/TLMR record. ARC is a 3-character name used to identify a tape drive used for the TPFxd_ functions.
CTAPAC Real-Time C Language Not Applicable New Created for TPFCS.
CTDSPV Real-Time Assembler Not Applicable New Created for TPFCS.
CTDTAC Real-Time Assembler Not Applicable New Created for TPFCS.
CTKS Real-Time Assembler Not Applicable New Created for TPFCS.
CTTPCN Real-Time Assembler Not Applicable New Created for TPFCS.
CVAB Real-Time Assembler Not Applicable Changed Updated for TPFCS.
CVBN Real-Time Assembler Not Applicable Changed Updated to allow lowercase and special character displays on several TPF commands.

System Equates

The following section summarizes system equate changes.

SYSEQ Tags

Table 387 summarizes changes to equates that are not configuration dependent (in SYSEQ). This information is presented in alphabetic order by the name of the SYSEQ tag.

Table 387. Changes to SYSEQ Tags for TPF Collection Support

SYSEQ Tag Equate Value New, Changed, or No Longer Supported?
#TO2CTL 121 New
#TO2SHW 148 New

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 388 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 388. Changes to Commands for TPF Collection Support

Command New, Changed, or No Longer Supported? Description of Change
ZBROW CLASS New Displays information about a class.
ZBROW COLLECTION New Displays information about, and performs maintenance on, the specified collection.
ZBROW NAME New Defines, displays, or removes a symbolic name for a persistent identifier (PID) of a collection.
ZBROW PROPERTY New Alters or displays a property for a specified collection.
ZBROW QUALIFY New Specifies which data store ZBROW command requests apply to.
ZOODB CHANGE New Changes the attributes of a current data definition for a specific data store.
ZOODB DEFINE New Defines a unique data store to TPFCS, or defines the attributes of a new data definition for a specific data store.
ZOODB DELETE New Deletes a data definition for a specific data store.
ZOODB DISPLAY New Displays the attributes of a data definition or data store, the names of all the defined data definitions for a specific data store, and a list of all data stores.
ZOODB INIT New Initializes TPFCS for the first time.
ZOODB SET New Sets on or sets off the method trace table or start of a dump on a TO2_getErrorText call.
ZRECP RECALL Changed Added the PID parameter for recoup processing of TPFCS.
ZRECP SEL Changed Added the PID parameter for recoup processing of TPFCS.
ZRECP TO2 New Modifies and displays values for TPF collection support recoup support.

Messages and System Errors

Table 389 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 389. Changes to Messages and System Errors for TPF Collection Support

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
020000 System Error New
0200C8 System Error New
0200D2 System Error New
0200DC System Error New
0200E6 System Error New
0200F0 System Error New
0200FA System Error New
020402 System Error New
020403 System Error New
020404 System Error New
020405 System Error New
020406 System Error New
041113 System Error New
BROW0051E Online New
BROW0099E Online New
BROW0201I Online New
BROW0202I Online New
BROW0203I Online New
BROW0204I Online New
BROW0205I Online New
BROW0206I Online New
BROW0210I Online New
BROW0251E Online New
BROW0252E Online New
BROW0253E Online New
BROW0254E Online New
BROW0255E Online New
BROW0256E Online New
BROW0257E Online New
BROW0258E Online New
BROW0259E Online New
BROW0301I Online New
BROW0303I Online New
BROW0304I Online New
BROW0310I Online New
BROW0351E Online New
BROW0352E Online New
BROW0353E Online New
BROW0354E Online New
BROW0355E Online New
BROW0356E Online New
BROW0357E Online New
BROW0358E Online New
BROW0359E Online New
BROW0360E Online New
BROW0399E Online New
BROW0402I Online New
BROW0403I Online New
BROW0404I Online New
BROW0405I Online New
BROW0406I Online New
BROW0407I Online New
BROW0408I Online New
BROW0410I Online New
BROW0411I Online New
BROW0412I Online New
BROW0413I Online New
BROW0415I Online New
BROW0416I Online New
BROW0417I Online New
BROW0418I Online New
BROW0419I Online New
BROW0420I Online New
BROW0421I Online New
BROW0422I Online New
BROW0423I Online New
BROW0424I Online New
BROW0451E Online New
BROW0452E Online New
BROW0453E Online New
BROW0454E Online New
BROW0455E Online New
BROW0456E Online New
BROW0457E Online New
BROW0458E Online New
BROW0459E Online New
BROW0460E Online New
BROW0461E Online New
BROW0462E Online New
BROW0463E Online New
BROW0464E Online New
BROW0465E Online New
BROW0466E Online New
BROW0467E Online New
BROW0468E Online New
BROW0469E Online New
BROW0470E Online New
BROW0471E Online New
BROW0472E Online New
BROW0501I Online New
BROW0502I Online New
BROW0503I Online New
BROW0510I Online New
BROW0551E Online New
BROW0552E Online New
BROW0553E Online New
BROW0554E Online New
BROW0555E Online New
BROW0556E Online New
BROW0557E Online New
BROW0558E Online New
BROW0559E Online New
BROW0599E Online New
BROW0601I Online New
BROW0602I Online New
BROW0650W Online New
BROW0651E Online New
BROW0652E Online New
BROW0653E Online New
CJ040001I Online New
CJ040002I Online New
CJ040051E Online New
CJ040099E Online New
CJ160001E Online New
OODB0001I Online New
OODB0002I Online New
OODB0006I Online New
OODB0007I Online New
OODB0011I Online New
OODB0012I Online New
OODB0021I Online New
OODB0022I Online New
OODB0025I Online New
OODB0026I Online New
OODB0027I Online New
OODB0031I Online New
OODB0032I Online New
OODB0039E Online New
OODB0041I Online New
OODB0042I Online New
OODB0051I Online New
OODB0099E Online New
OODB0101E Online New
OODB0105E Online New
OODB0106E Online New
OODB0121E Online New
OODB0122E Online New
OODB0131E Online New
OODB0132E Online New
OODB0133E Online New
OODB0134E Online New
OODB0135E Online New
OODB0136E Online New
OODB0141E Online New
OODB0142E Online New
OODB0143E Online New
OODB0144E Online New
OODB0145E Online New
OODB0151E Online New
OODB0152E Online New
OODB0153E Online New
OODB0154E Online New
OODB0155E Online New
OODB0156E Online New
OODB0164E Online New
OODB0171E Online New
OODB0191E Online New
OODB0192E Online New
OODB0201E Online New
OODB0202E Online New
OODB0203E Online New
OODB0204E Online New
OODB0205E Online New
RECP0201I Online New
RECP0202I Online New
RECP0203I Online New
RECP0204I Online New
RECP0205I Online New
RECP0206I Online New
RECP0207I Online New
RECP0208I Online New
RECP0209I Online New
RECP0210I Online New
RECP0211I Online New
RECP0213I Online New
RECP0214I Online New
RECP0250W Online New
RECP0251E Online New
RECP0252E Online New
RECP0253E Online New
RECP0254E Online New
RECP0255E Online New
RECP0256E Online New
RECP0257E Online New
RECP0258E Online New
RECP0259E Online New
RECP0260E Online New
RECP0261E Online New
RECP0262E Online New
RECP0263E Online New
RECP0264I Online New
RECP0271E Online New
RECP0272E Online New
RECP0273E Online New
RECP0274E Online New
RECP0275E Online New
RECP0276E Online New
RECP0277E Online New
RECP0278E Online New
RECP0279E Online New
RECP0281E Online New
RECP0282E Online New
RECP0293E Online New
RECP0294E Online New
RECP0295E Online New
RECP0296E Online New
RECP0297E Online New
RECP0298E Online New
RECP0299E Online New
TPXD0001A Online New
TPXD0002I 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

The following are the TPFCS default record IDs that are used by data definitions to assign attributes to collections:

Loading Process Changes

There are no changes.

Online System Load Changes

There are no changes.

Publication Changes

Table 390 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 390. Changes to TPF Publications for TPF Collection Support

Publication Title Softcopy File Name Description of Change
TPF Application Programming GTPAPP07 Added information about collections for TPFCS.
TPF C/C++ Language Support User's Guide GTPCLU07 Added new C functions for TPFCS.
TPF Concepts and Structures GTPCON05 Updated with information about TPFCS.
TPF Database Reference GTPDBR05 Updated with information about TPFCS and recoup information.
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 messages and system errors that were added, changed, and no longer supported for TPFCS.
TPF Migration Guide: Program Update Tapes GTPMIG07 Updated with migration considerations for TPFCS.
TPF Operations GTPOPR07 Updated with information about the commands that were added and changed for TPFCS.
TPF System Macros GTPSYS07 Updated the TDTAC macro with information for TPFCS.
TPF System Generation GTPSYG07 Updated with information about record ID information for TPFCS.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

The new tape_access C function:

Note:
ARx (ARA-ARZ and AR0-AR9) tape names are reserved for TPFCS capture and restore and must not be used by applications even if TPFCS is not being added to your existing TPF 4.1 system.

Database Changes

There are no changes.

Feature Changes

There are no changes.

Installation Validation

There are no changes.

Migration Scenarios

Adding TPF collection support will have virtually no impact on your existing TPF 4.1 system or on the application programs running on an existing TPF 4.1 system. The only impact will be the inclusion of lowercase characters and special characters in various displays. See Special and Lowercase Characters for more information about special characters. See TPF System Installation Support Reference for more information about the UCCWTOP user exit and TPF Programming Standards for information about how to disable this support if your workstations are unable to handle such displays.

To add TPFCS to your existing TPF 4.1 system, do the following:

  1. Install PUT 7 and ensure TPF transaction services is installed in your 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 SAL table. SeeTable 386 for more information about segments.
  4. Ensure that the #IBMM4.79 and #IBMM4.94 ordinals are defined.
  5. Ensure that record IDs FC10-FC19 are correctly defined in the record ID attribute table (RIAT).
  6. Ensure that you have made any required changes to the UCCWTOP user exit for lowercase and special character support See TPF System Installation Support Reference and TPF Programming Standards for more information about special character support.
  7. Run the LIBI offline program for all library interface scripts listed in Table 373.
  8. Run CBLD for build scripts listed in Table 370.
  9. Reassemble or recompile the following:
  10. Link-edit the build scripts (DLMs) listed in Table 370 and Table 375.
  11. Load the updated object code to your TPF 4.1 system.
  12. Perform an IPL.
  13. Cycle the TPF 4.1 system to NORM state.
  14. Enter the ZOODB INIT command to initialize your TPFCS database.
  15. Ensure the TPF 4.1 system is in NORM state before running any application programs.
  16. Continue setting up your TPFCS database as described in TPF Application Programming.