DFHMAINJ has mandatory and optional parameters that can be validated
before any customization of the installation libraries takes place.
Mandatory parameters
- JOB1
- Together with JOB2 and JOB3, JOB1 is used to create the JCL JOB statements
for the required jobs in the .SCIZSAMP library. Do not alter the number of
+ symbols at the beginning of the statement, as it used to substitute the
jobname when DFHMAINJ runs.
- JOB2
- JCL JOB statement continued.
- JOB3
- JCL JOB statement continued.
- SHLQ your.smpe.install.hlq
- A 1-35 character length value that is the data set name high level qualifier
of the CICS® SFR SMP/E
installation libraries. This value must match what you specified in the previous
step for syshlq.
- QUAL your.runtime.library.hlq
- A 1-35 character length value that is the data set name high level qualifier
of the runtime libraries. This value must match what you specified in the
previous step for hlqual.
- VOLSER vvvvvv
- A 1-6 character value of the volume serial number that should be used
for data set allocations.
If you use Storage Management Subsystem (SMS)
to manage the creation of your data sets, this parameter is ignored when the
data sets are allocated.
Acceptable characters:A-Z a-z 0-9 ./_ ( $ # @
|
- RDOLIST grplist
- The name of the CICS RDO list that contains the CICS SFR group,
and the MQ groups if required. It is recommended that you use the list CICSSFRL.
Acceptable characters:A-Z a-z 0-9 $ # @
|
- MQ YES|NO
- Indicates if you require support for WebSphere® MQSeries® (WMQ). If you specify MQ
YES, then you must also define values for the HLQMQ and THE_QMGR parameters.
You must specify this parameter if you want to use the Simulator program to
verify your installation.
- CSDNAME your.cics.dfhcsd
- A 1 - 44 character length value that is the fully qualified name of the CICS DFHCSD
file. This file must exist.
- HLQCICS your.cics.hlq
- A 1-35 character length value that is the high level qualifier of the CICS libraries.
- HLQCOBOL your.cobol.hlq
- A 1-35 character length value that is the high level qualifier of the
COBOL runtime libraries.
- HLQCEE your.language.environment.hlq
- A 1-35 character length value that is the high level qualifier of the Language Environment® runtime libraries.
- HLAPPLID ivp_cics_applid
- The APPLID of the CICS region that is used for running CICS SFR.
This value is also used to configure the pool and target name parameter
properties for the FEPI adapter IVP.
Acceptable characters:A-Z a-z 0-9 $ # @
|
Note that the first character of this value cannot be a number.
- WSDIR_REQ /your/wsdir/requester/
- The fully qualified name of the Web service pickup directory on HFS that
contains the Web service binding file and optionally the WSDL for your Web
service requester application. The length of the fully qualified directory
name should not exceed 255 characters, and should start and end with a /.
Acceptable characters:A-Z a-z 0-9 ./_
|
The directory name is case sensitive.
- CONFIG_REQ /your/pipeline/configuration/requester_config.xml
- The name and location of the requester mode pipeline configuration file
in HFS. For example, /usr/lpp/cicsts/samples/pipelines/basicsoap11requester.xml.
The pipeline configuration file defines the message handlers that process
outbound and inbound Web service requests for your Web service requester application.
The length of the fully qualified directory name should not exceed 255 characters,
and should start with a /.
Acceptable characters:A-Z a-z 0-9 ./_
|
The directory and file name are case sensitive.
- SHELF_REQ your/shelf/directory/
- The fully qualified name of the directory on HFS that contains subdirectories
for the requester mode pipeline configuration files and Web service requester
binding files. The length of the fully qualified directory name should not
exceed 255 characters, and should start and end with a /.
Acceptable characters:A-Z a-z 0-9 ./_
|
The directory name is case sensitive.
- WSDIR_PROV /your/wsdir/provider/
- The fully qualified name of the Web service pickup directory on HFS that
contains the Web service binding file and optionally the WSDL for your Web
service provider application. The length of the fully qualified directory
name should not exceed 255 characters, and should start and end with a /.
Acceptable characters:A-Z a-z 0-9 ./_
|
The directory name is case sensitive.
- CONFIG_PROV your/pipeline/configuration/provider_config.xml
- The name and location of the provider mode pipeline configuration file
in HFS. For example, /usr/lpp/cicsts/samples/pipelines/basicsoap11provider.xml.
The pipeline configuration file defines the message handlers that process
inbound and outbound Web service requests for your Web service provider application.
The length of the fully qualified directory name should not exceed 255 characters,
and should start with a /.
Acceptable characters:A-Z a-z 0-9 ./_
|
The directory and file name are case sensitive.
- SHELF_PROV /your/shelf/directory/
- The fully qualified name of the directory on HFS that contains subdirectories
for the provider mode pipeline configuration files and Web service provider
binding files. The length of the fully qualified name should not exceed 255
characters, and should start and end with a /.
Acceptable characters:A-Z a-z 0-9 ./_
|
The directory name is case sensitive.
Optional parameters
- PREFIX your.prefix
- A 1-7 character length value. The JCL jobname is created as a combination
of this value and the name of the member that is customized. For example,
if you specify PREFIX CSFR, this would rename every jobname
in the members of the runtime SCIZSAMP library with CSFR as the first four
characters e.g. //DFHMASET would become //CSFRASET. If you do not specify
a value for this parameter, the sample jobnames are the same as the member
names.
Acceptable characters:A-Z a-z 0-9
|
The first character of this value must not be a number.
- HLQMQ your.mq.hlq
- A 1-35 character length value that is the high level qualifier of the
WMQ runtime libraries.
Note: This parameter is required
if you specified MQ YES.
- THE_QMGR qmgrname
- A 1-4 character length value that is the name of the WMQ queue manager
that resources are defined to.
Note: This parameter is
required if you specified MQ YES.
Acceptable characters:A-Z a-z 0-9
|
The first character of this value must be uppercase and not
a number.
- CICS.INITQ your.cics.initq
- A 1-44 character length value that is the name of the CICS WMQ initiation
queue.
Note: This parameter is required if you specified MQ
YES.
Acceptable characters:A-Z a-z 0-9 ./_%
|
- HLSYSID ivp_cics_sysid
- The SYSID of the CICS region that is used for the IVP. This is required
if you want to run the IVP for the FEPI adapter.
Acceptable characters:A-Z 0-9 $ # @
|