Model 204 installation on IBM z/VSE: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 3: Line 3:
This page describes the steps required to upgrade from Rocket Model 204 version 7.4 to version 7.5, on the IBM z/VSE operating system.
This page describes the steps required to upgrade from Rocket Model 204 version 7.4 to version 7.5, on the IBM z/VSE operating system.


==Allocating data sets==
<table><tr><td><p>In order to upgrade to Model 204 version 7.5, <b>you must have version 7.4</b> and the <b>latest Autofix set of Early Warnings</b> installed on your system.</p> </td></tr></table>
There are three data sets used during Model 204 installation:
 
To upgrade to version 7.5 simply download, upload, and link the 7.5 object modules available from the downloads page to install the 7.5 components.
 
==Before you begin==
<ul>
<ul>
<li>data set for the Model 204 load modules
<li>In order to upgrade to version 7.5, you must have version 7.4 and Autofix release EW3044 installed on your system.
<li>data set for the local source library
<p>Autofix release EW3044 includes:
<li>data set for the local object library
<ul>
<li>Early Warnings for Model 204 through 740EW172</li>
<li>Early Warnings for Dictionary/204 through 740DI016</li>
</ul>
</ul>
The data set for the load modules will contain, after linking, the modules for the Model 204 product, including: ONLINE, IFAM1, and IFAM4. The local source library is used to store the customized source for modules such as FUNU, MSGU, and ACF2PARM/RACFPARM/TOPSPARM.
For information on Early Warnings, log in to the [http://www.rocketsoftware.com/support Rocket Customer Portal].</p></li>
When the source is assembled, it is stored in the local object library.
<li>For system requirements for version 7.5, see the [[Release notes for Model 204 version 7.5#Operating system requirements|7.5 Release notes]].</li>
<li>You must have either a [[Rocket M204 user ID]] or a Sirius user ID to download the installation files.</li>
<li>The sublibrary containing the object has the authorization zap (covering your licensed processors) preapplied, so you do not need to get a new authorization zap from the website. <br />(The preapplied zap will authorize Model 204 itself and any separately purchased products such as MQ/204 and SirScan.)</li>
<li>The object files also have the maintenance zaps (as of the time the stream was
prepared) preapplied, so you do not need to apply any maintenance as part of this installation. (You will only need to apply any new maintenance when it becomes available for this release.)</li>
</ul>
<div id="steps"></div>
 
==Overview of upgrading steps==
   
   
You will need to edit and submit the [[VSE M204CATP job stream|M204CATP]] job stream to allocate data sets for the installation.
Review the following high-level summary of steps before you begin downloading the <var class="product">Model 204</var> version 7.5 files.
   
   
Edit the job streams as follows:
For an example, see [[#Example_workflow_for_7.5:_download_through_installation|Example workflow for 7.5: download through installation]].
   
   
<ol>
<ol>
<li>Replace the first line with a JOB card.
<li><p>Use your [[Rocket M204 user ID]] to [[#downloading|download]] the Model 204 object source and JCL, including M204CATP.</p></li>
<li>Edit the lines, near the top of the job stream, marked with numbers followed by <code>&lt;&lt;</code>. The numbers correspond to numbered steps in the comments following these lines.
 
<li>Submit the <code></code> job to allocate the data set.
<li>[[#uploading|Upload]] (FTP) the downloaded components to the z/VSE system on the IBM mainframe.</li>
<li>Submit the [[M204CATP]] job to allocate VSAM managed space for the Model 204 library, define the sublibraries, and catalog the procedures. </li>
<li>If you have your own user $functions (FUNU), you must do the following steps:
<ol style="list-style-type:lower-alpha;">
<li>[[#FUNU_7.5|modify FUNU for 64-bit addressing]] considerations and store the modified source in your V750 sublibrary.</li>
<li>If you have any user-defined messages (MSGU), store them in your V750 sublibrary.</li>
<li>[[#asmFUNU|Assemble]] FUNU (and MSGU, if applicable), with the output object file stored in your V750 sublibrary.</li>
</ol>
</li>
<li>If you use an external authorizer (such as RACF) for <var class="product">Model 204</var>, [[#secparm|assemble the <i>xxxx</i>PARM security module]] (such as RACFPARM). The object file is then stored in your local object library.</li>
 
<li>If you use other customized modules, such as CDTB, modify them as needed and [[#asm|assemble]] them.</li>
<li>Link the [[#lkonln|ONLINE]] phase.</li>
 
<li>If you use the [[#link_ifam1|IFAM1]] phase, link it.</li>
<li>Link the <var class="product">Model 204</var> [[#lkutils|utility programs]].</li>
<li>If you use the [[#cics|CICS interface]], customize it, and then assemble and link the CICS modules.</li>
 
<li>If you use [[#softspy|SoftSpy]], upgrade it for 7.5.</li>
</ol>
</ol>


[[Category:Installation]]
[[Category:Installation]]

Revision as of 20:15, 17 December 2014

Note: This page is currently under construction.

This page describes the steps required to upgrade from Rocket Model 204 version 7.4 to version 7.5, on the IBM z/VSE operating system.

In order to upgrade to Model 204 version 7.5, you must have version 7.4 and the latest Autofix set of Early Warnings installed on your system.

To upgrade to version 7.5 simply download, upload, and link the 7.5 object modules available from the downloads page to install the 7.5 components.

Before you begin

  • In order to upgrade to version 7.5, you must have version 7.4 and Autofix release EW3044 installed on your system.

    Autofix release EW3044 includes:

    • Early Warnings for Model 204 through 740EW172
    • Early Warnings for Dictionary/204 through 740DI016
    For information on Early Warnings, log in to the Rocket Customer Portal.

  • For system requirements for version 7.5, see the 7.5 Release notes.
  • You must have either a Rocket M204 user ID or a Sirius user ID to download the installation files.
  • The sublibrary containing the object has the authorization zap (covering your licensed processors) preapplied, so you do not need to get a new authorization zap from the website.
    (The preapplied zap will authorize Model 204 itself and any separately purchased products such as MQ/204 and SirScan.)
  • The object files also have the maintenance zaps (as of the time the stream was prepared) preapplied, so you do not need to apply any maintenance as part of this installation. (You will only need to apply any new maintenance when it becomes available for this release.)

Overview of upgrading steps

Review the following high-level summary of steps before you begin downloading the Model 204 version 7.5 files.

For an example, see Example workflow for 7.5: download through installation.

  1. Use your Rocket M204 user ID to download the Model 204 object source and JCL, including M204CATP.

  2. Upload (FTP) the downloaded components to the z/VSE system on the IBM mainframe.
  3. Submit the M204CATP job to allocate VSAM managed space for the Model 204 library, define the sublibraries, and catalog the procedures.
  4. If you have your own user $functions (FUNU), you must do the following steps:
    1. modify FUNU for 64-bit addressing considerations and store the modified source in your V750 sublibrary.
    2. If you have any user-defined messages (MSGU), store them in your V750 sublibrary.
    3. Assemble FUNU (and MSGU, if applicable), with the output object file stored in your V750 sublibrary.
  5. If you use an external authorizer (such as RACF) for Model 204, assemble the xxxxPARM security module (such as RACFPARM). The object file is then stored in your local object library.
  6. If you use other customized modules, such as CDTB, modify them as needed and assemble them.
  7. Link the ONLINE phase.
  8. If you use the IFAM1 phase, link it.
  9. Link the Model 204 utility programs.
  10. If you use the CICS interface, customize it, and then assemble and link the CICS modules.
  11. If you use SoftSpy, upgrade it for 7.5.