CMSTPF What's New on the Host 01.04.01

What’s New in CMSTPF; SOURCE VIEW & CTFS in Host 01.02.01

-------------------------------------------------------
-------------------------------------------------------
-------------------------------------------------------
-------------------------------------------------------

CMSTPF Administrator Notes

---------------------------------------------
---------------------------------------------
---------------------------------------------

Files on Web Site

GI-Version 2.6

This is the README file associated with TPF/GI, CMSTPF, SOURCE VIEW, CTFS and the APM Server.

The Version information for CMSTPF, SOURCE VIEW and CTFS is Host Version 01.02.01

The TPF/GI Version for the PC executable is PC Version 02.06.01

The Application Program Manager (APM Server) Version is APM Server V3.5

All three products are included as part of this release.

APM Server V3.5 was previously used in TPFGI Version 2.5, and as such does not have to be re-installed.

TPF Software recommends that the products be implemented (first) in test mode, and then moved to production. The Host software should always be implemented first, and then the PC software.

Host Problems resolved with Host 01.02.01

Refer to the TPF Software Knowledge Base for Host problems resolved with this Host Version. The Host products are CMSTPF, SOURCE VIEW and CTFS. Host Version 01.02.01 includes all enhancements/fixes implemented in all earlier versions (Host 01.01.04; Host 01.01.03; and Host 01.01.02).

PC Problems resolved with TPFGI V2.6

Refer to the TPF Software Knowledge Base for PC problems resolved with this PC Version. The PC products are TPFGI and APPMAN. TPFGI Version 2.6 includes all enhancements/fixes implemented in TPFGI 2.5 and all earlier versions.

GINotes.doc

Notes on TPF/GI (including notes on APM Server, FTP/XFR procedures, and TPF/GI Installation). The FTP/XFR procedure should be followed to unzip the Host files. http://www.tpfsoftware.com/support/download.php?filename=gi-notes.doc.gz&foldername=services

TPFGIV26.zip for TPFGI 02.06.01

This file contains all the information (disks) for installing the TPFGI on the PC. Download this file, unzip the contents into a (temporary) INSTALLGI directory, and run SETUP.EXE.

Refer to http://www.tpfsoftware.com/support/adminhelpfiles.phtml for additional information on installing and customizing TPFGI Version 2.6.

Note:

In order to run TPFGI 02.06.01 you MUST have CMSTPF 01.02.01 installed on the Host. However, you can run the new Host (CMSTPF 01.02.01) with the old TPFGI 02.05.01 to allow programmers to migrate to the new TPFGI 02.06.01.

The new Host – CMSTPF 01.02.01 is downward compatible with the old PC version – TPFGI V2.5.1, as such, installers should always implement the Host products first.

The new PC – TPFGI V2.6 is NOT COMPATIBLE with the OLD Host CMSTPF 01.01.02 or CMSTPF 01.01.03, or CMSTPF 01.01.04.

If you are running CTFS, you must install CMSTPF 01.02.01 and CTFS 01.02.01 at the same time.

Disk_C_010201.ZIP for Host Version 01.02.01

This zip file contains the entire C-Drive host files (CMSTPF and SOURCE VIEW)

Disk_D_010201.ZIP for Host Version 01.02.01

This zip file contains the entire D-Drive host files (CMSTPF and SOURCE VIEW)

Disk_F_010201.ZIP for Host Version 01.02.01

This zip file contains the entire F-Drive host files (CTFS).

CTFS 01.02.01 is only compatible with CMSTPF 01.02.01. The Installer should make sure that the TPF Control Program Exits (CPTE and EXI); and the E-type programs that make up CTFS are implemented at the same time as the CMSTPF Control Program, and SYSCON generation.

The latest CTFS documentation is on the TPF Software web site, and can be accessed, using: http://www.tpfsoftware.com/support/download.php?filename=ctfs_010201.doc.gz&foldername=services

Disk_I_V35.ZIP for APM Server V3.5

This zip file contains the entire APM Server (APMSERV) host files.

Host CTFS Changes

New Version/Release of CTFS

CTFS 01.02.01 is a new version of CTFS.

CTFS has been re-written to take into account the upcoming new product TTFS. Because of this, major parts of CTFS have been re-written, including the TPF Control Program User Exits. Several of the names of the CTFS programs have changed, and new E-type programs need to be allocated for CTFS.

The CTFS Installation & Support Manual has been updated, refer to the CTFS Installation procedure. The CTFS documentation is on our web site and is called CTFS_010201.ZIP.

All earlier versions of CTFS (especially old E-type programs) will not work with CMSTPF 01.02.01

CTFS 01.02.01 is only compatible with CMSTPF 01.02.01

The new CTFS E-type programs and the new CTFS TPF CP changes are only compatible with the new CMSTPF 01.02.01.

The Administrator must re-compile the CTFS User Exit Routines (C3SX, C4SX, C5SX and $USREXT). Most of the installation User Exits (C3SX, C4SX, and $USREXT) code should work as is, but should be tested by the CMSTPF Administrator.

CTFS 01.02.01 still has 2 TPF CP Exits, one for IUCV and one for the EXITC macro

Code for the IUCV exit is in TSOFCPTE ASSEMBLE

Code for the EXITC macro is in TSOFEXI ASSEMBLE

Both these CP Exits must be implemented in CCUEXT. The code shipped with this new version is different from the code shipped in earlier versions of CTFS. The customer should implement these new TPF CP User Exits.

Program T0S0 now restarts CTFS automatically, and the operator does not have to issue the ZCTFS START and the ZCTFS ENABLE commands. Program T0S0 should be called from the IBM User Exit Restart Program (USR2). A sample copy is provided on the CTFS disk.

When an IUCV interrupt is received, the TPF CP User Exit (TSOFCPTE) now invokes the program T0S2 (TPF Software IUCV interrupt handler), instead of directly invoking (only) the CTFS IUCV interrupt handler. This should be transparent to the installer, as long as they use the new TPF CP Exits (TSOFCPTE and TSOFEXI). These changes are to make it easier for the future implementation of TTFS.

Additional notes on CTFS is defined in the CTFS NOTES A file on the CTFS disk (F-disk).

Unpack the CTFS disk (F-disk)

Customize the TSSYSU MACRO

Copy macros to MVS

Copy source to MVS (only 41 versions)

Include TSOFCPTE in CCUEXT

Include TSOFEXI in CCUEXT

Update CHSZ/CCNUCL to initialize CE1TSOFA/CE1TSOFW

Assemble CCUEXT

Generate a new TPF Control Program with this new CCUEXT

Customize or re-assemble C3SX/C4SX/C5SX

Update the restart scheduler (USR2) to invoke T0S0, when cycling to NORM

Allocate all the programs defined for CTFS (refer to CTFS LOADDECK)

Assemble all E-type programs on MVS (C0S*, C1S*, C2S*, C3S*, C4S*, etc.)

IPL VPARS with new CTFS Control Program (CCUEXT & CCNUCL changes)

Load and Accept all CTFS E-type programs (refer to CTFS LOADDECK)

Re-IPL TPF, to invoke T0S0 on cycle up

Host CMSTPF Changes

TEST Id installation

Install on the Test Id, and follow the normal installation procedure. Load the C-disk, D-disk and F-disk (if CTFS installed). To load the disks (refer to the FTP-XFR procedure in the GI-Notes.doc file), then, re-save the CMSTPF CP and re-save the systems. (Test versions, first).

$QHOST TABLE

TPF/GI Version 02.06.01 requires Host CMSTPF Version 01.02.01.

Update the $QHOST TABLE, based on the version received. This implies a change to the $QHOST TABLE. Refer to the $QHOST TABLE on the C-disk.

$RHOST TABLE

TPF/GI Version 02.06.01 requires Host CMSTPF Version 01.02.01.

Update the $RHOST TABLE, based on the version received. This implies a change to the $RHOST TABLE. Refer to the $RHOST TABLE on the C-disk.

Includes all changes made to earlier versions of CMSTPF, CTFS, Source View and TPF/GI.

Customers that did not implement or install any earlier versions of CMSTPF, Source View, CTFS or TPF/GI, should read the earlier GI-Versxx.doc documents, to refer to changes that were implemented with earlier versions.

Put 13 and Put 14 Support

CMSTPF 01.02.01 provides support for TPF Put Level 13 and TPF Put Level 14.

DECB Support

CMSTPF 01.02.01 provides support for the new DECB support implemented with TPF Put Level 13. With the DECB support, an ECB can define a DECB and can find, file records using a DECB. Also, core blocks can be obtained and released using DECBs.

Host APPMAN Server Changes

The I-Drive consists of all the files that make up the new APPMAN Server (Version 3.5 of APPMAN).

The APPMAN changes are primarily fixes to known problems.

PC Changes (TPF/GI)

The What’s New section of the Help menu bar, defines the new features implemented with TPF/GI Version 2.6.

The major enhancements to this new version of TPFGI, is the user interface for the DECB support and the Watch Variable support for C and C++ programs.

For installers that have never created their own User Extension Tool, they should refer to the TPFGI_ADMIN Help file. This Help file describes the procedure for downloading, customizing and installing TPFGI.

Installing New Version

First perform all the Host changes (CMSTPF, SOURCE VIEW, APPMAN and CTFS)

The PC executable is shipped as a single file called INSTALLnn.ZIP. Download the zip file from TPF Software’s web site. Create a temporary directory (INSTALLGI), and unzip all the files from INSTALLnn.ZIP into this temporary directory.

View the TPFGI_Admin.chm Help file to determine the options available for installing TPFGI on the PC. The recommended approach is to use the Administrator assisted install. With this type of install, the number of questions the end user is asked is limited, and the Administrator can set up all the installation default values. A sample SETUP.IN_ file can be modified and called SETUP.INI. The new SETUP.INI determines the questions to be asked to the end-user during the end-user installation process. The Administrator should check the TPFGI_ADMIN.CHM Help file for more information on setting up the SETUP.INI file.

The Administrator should update the TPFGISYS.INI file to define the names of the systems that can be activated at the installation. This initial TPFGISYS.INI file must be defined by the Administrator, and is used on the very first activation by the programmer to allow them to select a system name for database initialization or activation. This TPFGISYS.INI file should match with the TPFGISYS.INI file on the host system.

If any installation specific customization needs to be done at the end of the Client/Programmer Install Process, the Administrator should set up the USRSETUP.EXE module or USRSETUP.BAT file. This module/file allows for an Installation Specific Batch file (BAT file) to be invoked when the Client/Programmer runs the SETUP procedure to install TPFGI on their PC. If a USRSETUP.EXE module exists, the executable is invoked. If not, the installer should customize the Installation Specific Batch file (USRSETUP.BAT).

Once these functions are performed, the Administrator should move the entire contents of the INSTALLGI folder to a network drive. End Users/Clients/Programmers will access this network drive, and install TPFGI from this network drive.

Client/Programmer Installation of TPF/GI

Link to the Network drive (where the INSTALLGI directory is defined)

Run SETUP follow the installation instructions

Will request the user to define their Primary VM User Id

The Password for the VM User Id, will be requested during the 1st activation of TPFGI, and thereafter, based on the Password Expiry information, defined by the Administrator.

Activation of TPF/GI

Ping the VM system

Activate GI - Names should be as requested

Select system to be activated

TPFGI should come up

=======================================================================
=======================================================================
=======================================================================

TPF Software Knowledge Base

---------------------------------------
---------------------------------------

All problems are now saved in the Knowledge Base on the TPF Software web site. Refer to the Knowledge Base at the TPF Software web site for open and closed problems.

=======================================================================
=======================================================================
=======================================================================