XPFC V3R3 Installation/Update Notes

Introduction
XPFC Version 3 Release 3 provides a number of additional facilities and features which are fully documented in the XPFC Version 3 Release 3 Upgrade Guide - there's also pages on this site that summarise and illustrate the new features.

Apart from the new format **CONTROL Licence Key, there is no need to implement ANY of the new features unless you want to use them.

The XPS resident resources already in place are not impacted in any way with this new release.

Upgrade from Version 3 Release 2
The Installation Libraries supplied on the tape/cartridge for XPFC Version 3 Release 3 are a complete replacement for Version 3 Release 2. The only item to be carried over is the user's own "Live" Configurator File which can be re-used with a single change - to include the new **CONTROL license key.

It is recommended to perform the upgrade in the following steps;

	Download the Installation Libraries as described in the relevant "Installing XPFC" Section in Chapter 3 of the XPFC Version 3 Release 3 User Reference Guide. There will be a pair of Object and Load Libraries for each MVS/JES2 Version and Release from OS/390 Release 1.2 to Release 2.8. - you can also refer to the summary at the end of this page for a list of the library names and the relevant OS/390 levels.
	To make the new release libraries unique, name then in an obvious manner - for example, if the current XPFC Installation Libraries are named; SYSP.XPFC.JCL, SYSP.XPFC.LOAD & SYSP.XPFC.OBJ respectively, then consider creating a set of XPFC Installation Libraries as follows; SYSP.XPFC33.JCL, SYSP.XPFC33.LOAD & SYSP.XPFC33.OBJ
	Copy the current "Live" Configurator File in the XPFC Installation JCL Library for Version 3 Release 2 to the Version 3 Release 3 Installation JCL Library
	Edit this Configurator File to specify the new format **CONTROL Licence Key - This will be supplied along with all the other regular V3R3 issue material from Xerox.
	For ONLINE, edit the "Configurate" Job supplied in member RUNCONF to ensure that;   The Library names in the "DD" statements refer to the XPFC Version 3 Release 3 Libraries.   The Jobcard and DD cards are consistent with site standards and Jobcard naming conventions.
	Then submit the updated "Configurate" Job to create the XPFC33A Load Module in the chosen Linklist Library. It is strongly recommended that the new release is tested out initially under a Secondary JES2 system or Test MVS Partition to allow testing during normal working hours without disrupting the normal Production service.
	For OFFLINE, edit the "Configurate" Job supplied in member RUNCONF to ensure that;   The Library names in the "DD" statements refer to the XPFC Version 3 Release 3 Libraries.   The Jobcard and DD cards are consistent with site standards and Jobcard naming conventions.   Refer to the Section entitled "OFFLINE XPFC Installation: Version 3 Release 3 onwards" with regard to customisation actions for OFFLINE XPFC Version 3 Release 3.
	Then submit the updated "Configurate" Job to create the OFFLINE Load Modules in the chosen authorized Step Library. It is strongly recommended that the new release is initially tested out using a separate External Writer Task and authorized Step Library from the current "Live" one to allow ease of testing during normal working hours without disrupting the normal Production service.

OFFLINE XPFC Installation - V3R3 onwards
Installation and the subsequent introduction of Configurator File changes for OFFLINE XPFC has an additional Assembly step in the "Configurate" Job for Version 3 Release 3 onwards. This is required so that an additional object module containing a table of offsets into a JES2 Control Block may be Assembled for reference by the runtime XPFC code.

To facilitate correct Assembly under the MVS/JES2 Version and Release at the user site, an additional Assembler module is supplied as member "PTRTAB" within the installation supplied JCL Library.

There are two lines within this Assembler source that require modification by the user to reflect the MVS/JES2 Version and Release under which this module is to be Assembled, before the "Configurate" Job can be run.

These are as follows;

The Line "&J2LEVEL SETC 'OS 1.1.0'" This should be modified to reflect the Version and Release of the OS/390 MVS/JES2 environment ........for OS/390 Release 2, set this line to "&J2LEVEL SETC 'OS 1.1.0'" ...... this is because the JES2 component of OS/390 Release did not change from OS/390 Release 1 ...... for OS/390 Release 3, set this line to "&J2LEVEL SETC 'OS 1.3.0'".

The Line "&J2VRSN2 SETC '110'" This should be modified to reflect the Version and Release of the OS/390 MVS/JES2 environment ....... for OS/390 Release 2, set this line to "&J2VRSN2 SETC '110'" ....... this is because the JES2 component of OS/390 Release did not change from OS/390 Release 1 ...... for OS/390 Release 3, set this line to "&J2LEVEL SETC 'OS 130'". The updated sample "Configurate" Job for OFFLINE XPFC in the Supplied Installation JCL Library, member RUNCONF is updated to Assemble this module and LinkEdit into the run-time XPFC Load Modules. This additional step is only required for initial Installation and can be bypassed for subsequent "Configurate" runs but must be re-instated should there be any significant application of JES2 Maintenance applied to the MVS/JES2 system under which the XPFC External Writer Task is to be executed. The SYSLIB DD card must reference the correct JES2 Distribution Source Library and any necessary SMP/E maintenance Macro libraries that reflect the MVS/JES2 system under which the XPFC OFFLINE External Writer is to execute. Should you have upgraded to a new Version and/or Release of MVS/JES2, you should perform a complete re-installation of OFFLINE XPFC.

Summary of XPFC V3R3 Libraries
Version 3 Release 3 of XPFC is supplied in a set of Libraries generated using the IEBCOPY Unload PDS utility.

The tape/cartridge contents are as follows;

XPFC33.JCL(Pos 1)

XPFC Installation JCL Libraries - contains QuickStart Configurator Files, IVP Jobs and ONLINE/OFFLINE "Configurate" JCL skeletons

 

XPFC11.OBJ(Pos 2)

XPFC Online and Offline Object modules for OS/390 release 1.1

 

XPFC11.LOAD(Pos 3)

XPFC Online and Offline Load modules for OS/390 release 1.1

 

XPFC12.OBJ(Pos 4)

XPFC Online and Offline Object modules for OS/390 release 1.2

 

XPFC12.LOAD(Pos 5)

XPFC Online and Offline Load modules for OS/390 release 1.2

 

XPFC13.OBJ(Pos 6)

XPFC Online and Offline Object modules for OS/390 release 1.3

 

XPFC13.LOAD(Pos 7)

XPFC Online and Offline Load modules for OS/390 release 1.3

 

XPFC24.OBJ(Pos 8)

XPFC Online and Offline Object modules for OS/390 release 2.4

 

XPFC24.LOAD(Pos 9)

XPFC Online and Offline Load modules for OS/390 release 2.4

 

XPFC25.OBJ(Pos 10)

XPFC Online and Offline Object modules for OS/390 Release 2.5

 

XPFC25.LOAD(Pos 11)

XPFC Online and Offline Load modules for OS/390 Release 2.5

 

XPFC26.OBJ(Pos 12)

XPFC Online and Offline Object modules for OS/390 Release 2.6

 

XPFC26.LOAD(Pos 13)

XPFC Online and Offline Load modules for OS/390 Release 2.6

 

XPFC27.OBJ(Pos 14)

XPFC Online and Offline Object modules for OS/390 Release 2.7

 

XPFC27.LOAD(Pos 15)

XPFC Online and Offline Load modules for OS/390 Release 2.7

 

XPFC28.OBJ(Pos 16)

XPFC Online and Offline Object modules for OS/390 Release 2.8

 

XPFC28.LOAD(Pos 17)

XPFC Online and Offline Load modules for OS/390 Release 2.8

The sample JCL shown in Appendix L of the XPFC for MVS/JES2 User Reference Guide can be used to offload the required libraries with reference to the above table of contents.