|
|
| (27 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| This page contains 3 major sections — the instructions are provided for each operating system:
| | See the installation page for the version of Model 204 you are installing, and the operating system you use. The list of supported operating systems for each version of Model 204 is [[Model 204 operating system support|shown on its own page]]. |
| <ul>
| |
| <li>[[#CMS installation|CMS installation]]
| |
| <li>[[#VSE installation|VSE installation]]
| |
| <li>[[#z/OS installation|z/OS installation]]
| |
| </ul>
| |
| The first sub-sections for each operating system are titled "Important instructions for version <i>m.n</i>", for each of the currently supported versions of <var class="product">Model 204</var>. | |
|
| |
|
| In addition to those version-specific considerations, the following items must be performed for every version of <var class="product">Model 204</var>:
| | ==Version 7.5 and later (z/OS)== |
| <ul>
| | [[Model 204 installation on IBM z/OS]] |
| <li>Linking the ONLINE (and, if you use them, IFAM1 and IFAM4) load modules
| |
| <li>Linking the <var class="product">Model 204</var> utility load modules — some of these must always be utilized together with the new version
| |
| <li>Assembling FUNU, if you have user-written $functions
| |
| </ul>
| |
|
| |
| <p> </p>
| |
|
| |
|
| <div class="toclimit-3">__TOC__</div> | | <div id="7.5"></div> |
|
| |
|
| ==Components for installation== | | ==Version 7.5 and later (VSE)== |
| When you visit the [https://model204.rocketsoftware.com/maint/objlist Model 204 object file download page] <b>(need [[under construction| better download page]]) which has object library, source/macro/copy library, and [[under construction| (need better term) "collection"]] of Model 204 dump files)</b>, you will be able to download the following items for a given version of <var class="product">Model 204</var>:
| | <!--Caution: <div> above--> |
| <ul> | | [[Model 204 installation on IBM z/VSE]] |
| <li>the <var class="product">Model 204</var> object library - used to link ONLINE and various other load modules
| |
| <li>the <var class="product">Model 204</var> source/macro/copy library - used <b>if</b> your installation requires assembing of any z/OS ASSEMBLE files
| |
| <li>the collection <b>([[under construction|need a better word]] - depends on how we package them)</b> of <var class="product">Model 204</var> procedure files with SOUL programs
| |
| </ul>
| |
|
| |
|
| ==z/OS installation== | | ==Version 7.4== |
| | The version 7.4 installation guides provide useful reference information: |
|
| |
|
| blah blah [[under construction]] need some narrative here
| | <ul><var class="book"> |
| | <li>[[Media:M204_InstallzOS_V74.pdf|Rocket Model 204 Installation Guide for IBM z/OS, version 7.4]]</li> |
|
| |
|
| Be sure to read the sub-section below titled "Important instructions for version <i>m.n</i>", for the version of <var class="product">Model 204</var> you are installing.
| | <li>[[Media:M204_InstallzVM_V74.pdf|Rocket Model 204 Installation Guide for IBM z/VM, version 7.4]] </li> |
|
| |
|
| In addition to those version-specific considerations, the following items must be performed for every version of <var class="product">Model 204</var>:
| | <li>[[Media:M204_InstallzVSE_V74.pdf|Rocket Model 204 Installation Guide for IBM z/VSE, version 7.4]] </li> |
| <ul>
| | </var></ul> |
| <li>Linking the [[#zos_link_onln|ONLINE]] (and, if you use them, [[#zos_link_ifam1|IFAM1]] and [[#zos_link_ifam4|IFAM4]]) load modules | |
| <li>Linking the <var class="product">Model 204</var> [[#zos_utils|utility load modules]] | |
| <li>[[#zos_FUNU|Assembling FUNU]], if you have user-written $functions
| |
| </ul> | |
|
| |
|
| ===Important instructions for version 7.5===
| |
|
| |
|
| In addition to the steps performed [[#zos always|for every version]], installation of version 7.5 requires that you:
| | [[Category:Installation]] |
| <ul>
| |
| | |
| <li>after [[#linking the utility load modules]], be sure to use your version 7.5 load library for the OI15OS and OI35OS load modules used in the deferred index sort exits for FLOD
| |
| | |
| <li>if you use XDM CRAM, either:
| |
| <ul><li>have installed the version V7R4 XDM load modules</li></ul>
| |
| or
| |
| <ul><li>link the [[#zos_link_XDM|XDM load modules]] from the downloaded object library</li></ul>
| |
| | |
| <li>if you have your own user $functions (FUNU),
| |
| <ul><li>modify [[#zos_FUNU_7.5|FUNU]] for 64-bit addressing considerations</li></ul>
| |
| | |
| </ul>
| |
| | |
| ===Downloading the object library in z/OS===
| |
| | |
| This section is [[under construction]]. It will be cribbed from the instructions on the download page. A key thing mentioned is our use of ROKOB204 in the documentation to refer to the downloaded object library.
| |
| | |
| <div id="FUNU"></div>
| |
| ===FUNU===
| |
| <!--Warning: <div> above-->
| |
| | |
| This section lists installation considerations if you have your own user-written $functions module (FUNU).
| |
| | |
| The following items are required for installation of every version of <var class="product">Model 204</var>:
| |
| <ol>
| |
| <li>After making any changes required for the version of <var class="product">Model 204</var> you are installing, run the job to [[#Assembling FUNU|assemble FUNU]] into your local object library.
| |
| <li>Be sure that you have modified the [[#JZLONLN|JCL to link ONLINE]] to reference your local object library (the ROKOB204 DD statement will be the concatenation of your local object library and the downloaded object library).
| |
| <li>You do <b>not</b> need to insert an INCLUDE statement for FUNU; there is already one in the INCLUDE member (LKSQLONL or LKNOSONL) provided in the downloaded object library.
| |
| </ol>
| |
| | |
| In addition, see additional FUNU considerations as described in the following sections:
| |
| | |
| <div id="zos_FUNU_7.5"></div>
| |
| ====Versions 7.5 and later====
| |
| <!--Warning: <div> above-->
| |
| | |
| Starting with version 7.5 of <var class="product">Model 204</var>, all $functions are entered in AMODE 64. This requires you to modify the ENTER macro for each $function, and may require you to modify the code for proper addressing in AMODE 64.
| |
| <ul>
| |
| <li>The default ENTER macro (that is, without the ZMODE= operand) will not function in AMODE 64 - it will issue a BUG message (<i>label</i> <code>Bad AMODE, expect 31</code>) and produce a snap.
| |
| <li>In order to exploit QTBL above the 2G bar, any $functions which has arguments must be in AMODE 64. The ENTER macro should use ZMODE=GQ (the AMODE will remain as 64) and the code must be changed for proper addressing.
| |
| <li>If the $function does not have any arguments or if you will not exploit QTBL above the bar, and if your $function does not access any other data structures which may be above the bar, you can use the ZMODE=31 operand on the ENTER macro. This will cause your $function to switch to AMODE 31 at entry (and restore the AMODE upon exit).
| |
| <li>In any case, the AMODE issues need to be accounted for in any routines which your $function routine does a CCALL to.
| |
| </ul>
| |
| | |
| <div id="zos_link_onln"></div>
| |
| ===Linking the Model 204 ONLINE load module===
| |
| <!--Warning: <div> above-->
| |
| | |
| After [[#Downloading the object library in z/OS|downloading the object library]], one of the members of ROKOB204 is
| |
| named [[#JZLONLN|JZLONLN - the basic ONLINE link JCL]]. You can use this to link-edit the <var class="product">Model 204</var> online. It contains a number of choices which you can make to modify this basic JCL; each choice is indicated in the JCL by a line which ends with <code><<</code>.
| |
| | |
| <p>Most of the choices are "optional", in the sense that a working ONLINE does not require the indicated modification, although, for many customers' environments, a modification will be needed, for example, to select an external authorizer.
| |
| </p>
| |
| | |
| <table class="thJustBold">
| |
| <tr><th>1</th><td>Only one modification is <b>always required</b>, based on whether the ONLINE is to use RSQL (for Connect*) or not:
| |
| <ul>
| |
| <li>To link an ONLINE which <b>does</b> use RSQL, you must un-comment the INCLUDE ROKOB204(<b>LKSQLONL</b>) statement.
| |
| <li>To link an ONLINE which <b>does not</b> use RSQL, you must un-comment the INCLUDE ROKOB204(<b>LKNOSONL</b>) statement.
| |
| </ul>
| |
| </td></tr>
| |
| | |
| <tr><th>2</th><td>The other modification frequently needed is to use an external authorizer such as RACF or ACF2. If you do, you must:
| |
| <ul>
| |
| <li>Prepare the appropriate xxxPARM object file (e.g., RACFPARM orACF2PARM), adding that to a *different* object library (with the same
| |
| DCB attributes as ROKOB204). We refer to this as your local object libary (it will also be used for other assemble output, such as your FUNU).
| |
| <li>In the SYSLIN DD *, un-comment the appropriate INCLUDE statement(s) for your external authorizer. <p class="note"><b>Note:</b> If you use ACF2, there are two INCLUDE statements to be un-commented; one refers to your system ACF2 library. You must un-comment the ACF2 DD as well, and fill in the DSN for that library.</p>
| |
| </ul>
| |
| </td></tr>
| |
| | |
| <tr><th>3</th><td>If you have other programs which you assemble for your Model 204 ONLINE module, for example, FUNU, they should be assembled into your local object library (creating one - with the same DCB attributes as ROKOB204 - if you have not already created one for the external authorizer xxxxPARM object file). You do *not* need to add additional INCLUDE statements for FUNU or other locally assembled object files - they are already present in the include streams from ROKOB204.
| |
| </td></tr>
| |
| | |
| <tr><th>4</th><td>Hence, there are two choices for the ROKOB204 DD statement:
| |
| <ul>
| |
| <li>If you have a local object library, fill that in for the first concatenation, and fill in the ROKOB204 DSN for the second concatenation.
| |
| <li>If you do not have a local object library, there is only one dataset for the ROKOB204 DD - your ROKOB204 library.
| |
| </ul>
| |
| </td></tr>
| |
| | |
| <tr><th>5</th><td>Finally, change the DSN of the SYSLMOD DD to the load module library you have allocated for it.
| |
| </td></tr>
| |
| | |
| </table>
| |
| | |
| The modified JCL is now ready to run.
| |
| | |
| <blockquote class="note"><b>Notes:</b>
| |
| <ul>
| |
| <li>There is not a separate link step for BATCH204. It is not
| |
| maintained as a separate module; the same module as ONLINE is used,
| |
| with a BATCH204 alias.
| |
| <li>The object library has the authorization zap pre-applied, so you *do
| |
| not* need to get a new one from the web site.
| |
| <li>It also has the maintenance zaps (as of the time the stream was
| |
| prepared) pre-applied, so you *do not* need to apply any maintenance.
| |
| </ul>
| |
| </blockquote>
| |
| | |
| <div id="JZLONLN"></div>
| |
| | |
| ====Basic JCL to link ONLINE====
| |
| <!--Warning: <div> above-->
| |
| | |
| {{Template:JZLONLN}}
| |
| | |
| <div id="zos_utils"></div>
| |
| ===Linking the Model 204 utility load modules===
| |
| <!--Warning: <div> above-->
| |
| | |
| blah blah
| |
| | |
| Many of the utility load modules are compatible across versions of <var class="product">Model 204</var> — any version of the utility may be used with any version of <var class="product">Model 204</var>. The following utilities, however, must always be used with the same version of <var class="product">Model 204</var>:
| |
| | |
| <!--Sigh, it'd be "nice" for this list to be a template: -->
| |
| <p class="code">AUDIT204: Extract from journal, and report stats and analysis
| |
| MERGEJ: Merge concurrent journal streams
| |
| OI15OS: SORT E15 exit for variable length deferred updates
| |
| OI35OS: SORT E35 exit for variable length deferred updates
| |
| UTILC: Information from checkpoint stream
| |
| UTILJ: Information from journal stream; add EOF markers
| |
| </p>
| |
| | |
| In addition to the above utility load modules, some may be listed in the sub-section titled "Important instructions for version m.n", for the version of <var class="product">Model 204</var> you are installing.
| |
| | |
| The JCL PROC necessary to link the <var class="product">Model 204</var> utility load modules is provided as member <code>JZLALLUT</code> in the downloaded object library. The exact contents of <code>JZLALLUT</code> in the object library will depend on the version of <var class="product">Model 204</var> being installed — you do <b>not</b> need to modify it. A prototype copy of it is shown here; the lines at the end are correctly provided as part of the download process:
| |
| | |
| {{Template:JZLALLUT}}
| |