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

From m204wiki
Jump to navigation Jump to search
Line 59: Line 59:
<li>If you use [[SoftSpy]], upgrade it for 7.5.</li>
<li>If you use [[SoftSpy]], upgrade it for 7.5.</li>
</ol>
</ol>
==Installing terminal access methods and communications features==
This section presents basic steps for installing these terminal access methods
and communications features:
<ul>
<li>Model 204 Virtual Telecommunications Access Method (VTAM) Interface.</li>
<li>Horizon intersystem communication feature, which is required for Connect* support. This feature is provided in a limited edition without encryption. See “Installation considerations.”</li>
<li>Parallel Query Option/204, which enables distributed file processing.</li>
</ul>
===General VTAM installation steps===
The basic steps for installing these features with Model 204 are:
<ol>
<li>Link edit Model 204 with the appropriate object modules after commenting out the INCLUDEs for any features (PQO, Horizon, VTAM) not used at your site.
<p class="note"><b>Note:</b> The installation task list for each feature includes this step; however, you need to link edit Model 204 only once, after you apply the CPU ID zap and apply all available Early Warnings.</p></li>
<li>Complete the Model 204 installation.</li>
</ol>
==Installing the VTAM Interface==
Installing Model 204 with VTAM requires defining Model 204 as a VTAM application program. Model 204 provides 3270 support, as well as VTAM support for full-screen terminals that are not 3270-compatible, by providing a mechanism for writing exit routines to convert data outside of the VTAM 3270 interface.


Rules governing data conversion exit routine coding are described in [[System management]].
To install the VTAM Interface, perform these steps:
<table>
<th>Step</th> <th>Task</th> <th>Job</th>
<tr><td>1.</td> <td>Make sure that the link job contains INCLUDE LKVTAM.</td> <td>LINKONLN</td></tr>
<tr><td>2.</td> <td>Define Model 204 as a VTAM application node using an
APPL statement in VTMAPPL.B.</td> <td /> </tr>
<tr><td>3.</td> <td>Apply all early warnings and then link edit the Model 204 ONLINE phase.</td> <td>LINKONLN</td></tr>
</table>
===Specifying a VTAMNAME===
The network name of the Model 204 run is specified for VTAM in the Model 204 system parameter VTAMNAME. The VTAMNAME parameter in CCAIN is the same as the APPL statement name field.
The value of VTAMNAME is a string composed of 1-8 characters. The default is M204. VTAMNAME can be specified by the system manager on the User 0 parameter line.
For more information on VTAM parameters, see [[System management]] and [[Commands]].
==Installing the Horizon Interface==
The Horizon intersystem communication feature is required for Connect* and TCP/IP support.
To install the Horizon Interface, perform these steps:
<table>
<th>Step</th> <th>Task</th> <th>Job</th>
<tr><td>1.</td> <td>Make sure that the link job contains INCLUDE LKHRZN.</td> <td>LINKONLN</td></tr>
<tr><td>2.</td> <td>Apply all early warnings and then link edit the Model 204 ONLINE phase.</td> <td>LINKONLN</td> </tr>
</table>
For more information about Horizon, see the <var class="book">Rocket Model 204 Horizon: Intersystem Processing Guide</var>.


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

Revision as of 17:36, 18 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.

Installing terminal access methods and communications features

This section presents basic steps for installing these terminal access methods and communications features:

  • Model 204 Virtual Telecommunications Access Method (VTAM) Interface.
  • Horizon intersystem communication feature, which is required for Connect* support. This feature is provided in a limited edition without encryption. See “Installation considerations.”
  • Parallel Query Option/204, which enables distributed file processing.

General VTAM installation steps

The basic steps for installing these features with Model 204 are:

  1. Link edit Model 204 with the appropriate object modules after commenting out the INCLUDEs for any features (PQO, Horizon, VTAM) not used at your site.

    Note: The installation task list for each feature includes this step; however, you need to link edit Model 204 only once, after you apply the CPU ID zap and apply all available Early Warnings.

  2. Complete the Model 204 installation.

Installing the VTAM Interface

Installing Model 204 with VTAM requires defining Model 204 as a VTAM application program. Model 204 provides 3270 support, as well as VTAM support for full-screen terminals that are not 3270-compatible, by providing a mechanism for writing exit routines to convert data outside of the VTAM 3270 interface.

Rules governing data conversion exit routine coding are described in System management. To install the VTAM Interface, perform these steps:

Step Task Job
1. Make sure that the link job contains INCLUDE LKVTAM. LINKONLN
2. Define Model 204 as a VTAM application node using an APPL statement in VTMAPPL.B.
3. Apply all early warnings and then link edit the Model 204 ONLINE phase. LINKONLN

Specifying a VTAMNAME

The network name of the Model 204 run is specified for VTAM in the Model 204 system parameter VTAMNAME. The VTAMNAME parameter in CCAIN is the same as the APPL statement name field.

The value of VTAMNAME is a string composed of 1-8 characters. The default is M204. VTAMNAME can be specified by the system manager on the User 0 parameter line.

For more information on VTAM parameters, see System management and Commands.

Installing the Horizon Interface

The Horizon intersystem communication feature is required for Connect* and TCP/IP support.

To install the Horizon Interface, perform these steps:

Step Task Job
1. Make sure that the link job contains INCLUDE LKHRZN. LINKONLN
2. Apply all early warnings and then link edit the Model 204 ONLINE phase. LINKONLN

For more information about Horizon, see the Rocket Model 204 Horizon: Intersystem Processing Guide.