This document describes a simplified installation method for EntireX under z/OS. It is an alternative to the installation method described in subsequent sections. This document covers the following topics:
The simplified installation requires the following steps:
Set the installation keyword parameters in a parameter member.
Execute a REXX script that updates the delivered installation jobs with the values of that parameter member.
Auto-submit the updated jobs if requested in the parameter file, or make them ready for a manual submission.
The delivered members in the original EXX109.JOBS data set are:
#IPARMSThe installation parameters.
#RX#CMDThe REXX update script.
#RX#JOBA job to execute
#RX#CMDin batch.
#INSTALLGenerated on first submission: Documents the installation jobs required as a result of the components selected.
Note:
Only the #INSTALL job will be copied to the target
.JOBS data set. The first three members remain in the
original EXX109.JOBS data set.
This member keeps all parameters relevant for installation and is
located and maintained in the delivered data set
EXX109.JOBS only, which was copied directly from the
installation medium. To avoid a complete setup, you can select an already maintained #IPARMS. See #RX#JOB- A REXX Batch Job.
The parameter member contains the following sections:
global installation parameters
job card related parameters
installable unit subproduct selection parameters
installable unit installation parameters
data set names / high-level qualifiers
VSAM file characteristics
A parameter member line has the following layout:
* ----------------------------------------------------------------- * * JOBCARD * ----------------------------------------------------------------- * keyword = value * comment
| where | keyword |
is a placeholder for a keyword |
| = | is the value separator | |
value |
is the keyword value | |
| * | introduces a comment. A line that begins with an asterisk in column 0 is treated as a comment line. |
This script copies all the necessary jobs from the original EXX109.JOBS data set of the delivered installation medium to a selected installation target.JOBS data set. All placeholders in the original jobs will be replaced with the values set in the parameter member. An existing target.JOBS data set of a previous generation will be saved in a GDG data set first.
A #INSTALL member will be created for documentation and to
distinguish between the jobs required as a result of the selected components
and the optional installation jobs. All required installation jobs can be
submitted directly with this member.
Calls the #RX#CMD REXX script from batch.
The #RX#CMD script expects six KEYWORD parameters that need to be maintained and set to suitable values in the #RX#JOB first. There are two groups of keyword parameters: mandatory and optional.
ORIG - The name of the EXX109.JOBS data set copied from the installation medium
INST - The name of the target.JOBS data set that will contain the generated installation jobs
PARM - The name of a data set containing an already maintained #IPARMS member. If a #IPARMS member is found here it will be selected for the installation jobs generation process.
MSGS - Switch IEBCOPY sysout messages on or off. Possible values are:
Y - Show IEBCOPY sysout (default)
N - Hide IEBCOPY sysout
INST_SMS - Switch SMS control on or off for the target.JOBS data set named with the mandatory INST keyword parameter. Possible
values:
Y - Switch ON the SMS controlled allocation of the installation jobs data set
N - Switch OFF the SMS controlled allocation of the installation jobs data set
INST_VOL - Contains the SMS class name or the VOLSER name depending on the value of keyword parameter INST_SMS
INST_SMS=Y - The SMS class name
INST_SMS=N - The DASD VOLSER name
Important:
It is mandatory to edit this job manually before
submission to define at least the mandatory keywords naming the input (EXX109.JOBS) and output
(target.JOBS) data sets.
This member will be generated in both, the EXX109.JOBS and the target.JOBS data sets. It has two functions:
Documentation of the Installation Jobs Required as a Result of
the Selected Installable Units
Each required installation job is represented here with a separate
line headed by its member name in the EXX109.JOBS.
Submission of the Required Installation Jobs
As this member is a job itself, it can be submitted to submit all
the required installation jobs. You can also select a subset of jobs for
submission by (un)commenting their execution lines.
This section lists the parameters available with the simplified installation procedure:
Use these parameters to determine the scope of the installation.
| Installable Unit | Description |
|---|---|
| InstBroker | Subproduct installation: Select the Broker (Y/N). |
| InstRpcBatch | Subproduct installation: Select the RPC Server for Batch (Y/N). |
| InstRpcCics | Subproduct installation: Select the RPC Server for CICS (Y/N). |
| InstRpcIms | Subproduct installation: Select the RPC Server for IMS (Y/N). |
| InstSSL | Subproduct installation: Select the SSL libraries (Y/N). |
Notes:
All existing jobs remain unchanged in the original
EXX109.JOBS data set. Only the jobs necessary for the installation
of the selected installable units will be
copied to and updated within the designated
target.JOBS data set by the
#RX#CMD REXX script.
Note:
This update process is not mandatory. All jobs can still be manually
adapted as before. But to be able to successfully execute the installation
script afterwards, the original EXX109.JOBS data set
should be kept unchanged.
This section covers the following topics:
After a successful generation, the following data sets are in the system:
EXX109.JOBS
The delivered product data set. The members of this data set will
remain unchanged with the exception of the #IPARMS parameters and
possibly the #RX#JOB.
target.JOBS
The target data set which will contain the selected and updated jobs
from the EXX109.JOBS data set.
target.JOBS.BAK
A VSAM GDG base catalog entry for the GDG data sets.
target.JOBS.GnnnnVnn
With any subsequent generation, all jobs of the previous generation
in the target.JOBS data set are kept here until
the maximum value set in the MAXBACKUPS
parameter (to be found in #IPARMS) is reached.
To prepare and install the installation jobs
Update the EXX109.JOBS
(#IPARMS) parameter member.
Submit the job EXX109.JOBS(#RX#JOB) to execute the REXX script #RX#CMD.
Every keyword parameter has a well defined default value. This default
will be replaced only if requested by the parameter member, that is, if a
KEYWORD=VALUE entry is successfully identified. When a keyword is
deleted from the parameter member (or commented out), this default will always
be in place.
To submit the installation jobs
In the #IPARMS member select the switch
SUBMIT.
If set to "Y":
Any job is submitted with a TYPRUN=HOLD job card
parameter.
Note:
This allows a final check to ensure a correct generation. Any
job can then be released manually one after the other in the numbered order or
can be cancelled if an error was encountered.
If you cannot issue the JES release command for security reasons, you can submit using the generated #INSTALL job in the target.JOBS instead.
If set to "N":
The TYPRUN=HOLD job card parameter is set to comment
and no job is submitted at all.
Note:
The #INSTALL member will be generated regardless of the
SUBMIT parameter value.
Installation verification is the same for both installation methods. See Verifying the z/OS Installation.
After installation has been completed, various administration tasks may be necessary.
Customize the attribute settings to suit your needs. See Broker Attributes.
See Administering Broker Stubs.
A persistent store can be optionally used for storing unit of work messages and message status information to disk. For z/OS, you can use an Adabas persistent store (recommended) or a DIV persistent store that uses a VSAM linear data set.
See Implementing an Adabas Database as Persistent Store and Adabas-specific Attributes in the Broker attribute file documentation for more information.
See Implementing a DIV Persistent Store and DIV-specific Attributes for more information.
See RPC Server for CICS, RPC Server for Batch or RPC Server for IMS for more information.