Example Customization Input File (mqsicompcif)

***********************************************************************
***                                                                 ***
*** File Name: mqsicompcif                                          ***
***                                                                 ***
***********************************************************************
***                                                                 ***
*** Licensed Materials - Property of IBM;                           ***
*** 5655-G97 (c) Copyright IBM Corp. 2001, 2003;                    ***
*** All Rights Reserved;                                            ***
*** US Government Users Restricted Rights - use,                    ***
*** duplication or disclosure restricted by GSA                     ***
*** ADP Schedule Contract with IBM Corp.;                           ***
*** See Copyright Instructions                                      ***
***                                                                 ***
***                                                                 ***
*** Description:                                                    ***
***                                                                 ***
*** This Customization Input File (CIF) holds all configuration     ***
*** data for each component that is needed as input for the         ***
*** customization process.                                          ***
***                                                                 ***
*** Each configuration data entry is in the format KEY='value'.     ***
*** The keys are unique and must not be changed. The keys are used  ***
*** as place holders inside the files to be customized and are      ***
*** replaced during customization by values from the appropriate    ***
*** CIF entries.                                                    ***
***                                                                 ***
*** Specify your environment by updating the values of the CIF      ***
*** as appropriate. Where these  changes are mandatory the defaults ***
*** are pre-set with a pattern '++VALUE++'. When updating this file ***
*** please pay attention to the following rules:                    ***
***                                                                 ***
***   - Values must be surrounded by single quotes.                 ***
***   - values can contain references to other keys that are        ***
***     also replaced with the appropriate value. The referenced    ***
***     key must then be specified between < and >.                 ***
***   - References to other keys can occur anywhere in the CIF      ***
***                                                                 ***
***                                                                 ***
***********************************************************************

***********************************************************************
*** DB2 definitions. Used for broker only                           ***
***********************************************************************

*** DB2 Sample Program that can be DSNTIAD or DSNTEP2
*** This is required to run dynamic SQL using batch jobs.
*** It is necessary to specify the program name and the plan name.

*** DB2 Sample Program Name. (For example : 'DSNTIAD').
DB2_SAMPLE_PGMNAME='++DB2_SAMPLE_PGMNAME++'

*** DB2 Sample Program Plan Name. (For example : 'DSNTIAD').
DB2_SAMPLE_PGMPLAN='++DB2_SAMPLE_PGMPLAN++'

*** DB2 Plan Name for dsnacli. (For example : 'DSNACLI').
DB2_DSNACLI_PLANNAME='++DB2_DSNACLI_PLANNAME++'

*---------------------------------------------------------------------*

*** DB2 Accessibility
*** To access the data source it is necessary to specify the
*** DB2 Subsystem Name and the location name.

*** DB2 Subsystem Name
*** (set into dsnaoini). (For example : 'D631').
DB2_SUBSYSTEM='++DB2_SUBSYSTEM++'

*** DB2 Location Name
*** (set into dsnaoini and registry key DataSourceName).
*** (For example : 'WMQID631').
DB2_LOCATION='++DB2_LOCATION++'

*** DB2 Table Owner (CURRENTSQLID)
*** This is the prefix used to create and access the DB2 tables.
*** (set into dsnaoini and registry key DataSourceUserId).
*** (For example : 'Q482BRK').
DB2_TABLE_OWNER='++DB2_TABLE_OWNER++'

*---------------------------------------------------------------------*
*** DB2 Broker Database Creation
*** To create the broker database it is necessary to specify the
*** storage group name, VCAT, volume, and the database name.
*** These values are set into the DB2 command data members.

*** DB2 Storage Group Name. (For example : 'SQ482BRK').
DB2_STORAGE_GROUP='++DB2_STORAGE_GROUP++'

*** DB2 Storage Group VCAT. (For example : 'DSN631').
DB2_STOR_GROUP_VCAT='++DB2_STOR_GROUP_VCAT++'

*** DB2 Storage Group Volume
*** VOLUME for volume name or '*' for SMS managed volumes
DB2_STOR_GROUP_VOL=''*''

*** DB2 Database Name
*** (set into dsnaoini and registry key DataBaseName).
*** (For Example : 'DQ482BRK').
DB2_DATABASE='++DB2_DATABASE++'

*** DB2 Buffer Pool
*** used by this Database
*** (set into bipdbts and bipdbtb and bipdbdb).
*** (For Example : 'BP2').
DB2_BUFFER_POOL='++DB2_BUFFER_POOL++'

***********************************************************************
*** WBIMB definitions                                                ***
***********************************************************************

*** WBIMB Component Partitioned Data Set
*** This data set must exist before executing mqsicustomize. 
*** (For example.'WMQIV50.Q482BRK.BIPCNTL').
COMPONENT_PDS='++COMPONENT_PDS++'

*** Unique Component Key for Broker or UserNameServer.
*** Can be up to 8 uppercase characters and numbers.
*** A good convention is "queuemanagername||BRK" or "queuemanagername||UNS",
*** (For example  : COMPONENT_KEY='Q482BRK'  or COMPONENT_KEY='Q483UNS').
COMPONENT_KEY='MQ00BRK'

*** WBIMB Started Task Procedure Name
*** This name must not be longer than 7 characters and must not
*** start with the characters BIP.
STPN='MQ00BRK'

*** PDS Name of a dataset where the Started Task Procedure is copied.
*** This data set must exist before executing mqsicustomize.
*** (For example :'USER.PROCLIB').
USER_PROCLIB_PDS='++USER_PROCLIB_PDS++'

*** The Started task and utility STEPLIB concatenated libraries are held
*** in a separate JOBLIB member. This enables service to be applied without
*** the need to re-run this customization.  STEPLIB_NAME is used to specify
*** the name of the JOBLIB member. 
STEPLIB_NAME='++STEPLIB_NAME++'

*---------------------------------------------------------------------*

*** Java Settings

*** JAVAHOME environment variable
*** Contains the root directory of the JAVA installation.
*** (set into ENVFILE). (Typically : '/usr/lpp/java/IBM/J1.4').
*** The Java version must be at least 1.4.
JAVAHOME='++JAVAHOME++'

*** CLASSPATH environment variable
*** (set into ENVFILE).
CLASSPATH='/usr/lpp/mqsi/classes:<JAVAHOME>/lib'

*---------------------------------------------------------------------*

*** Settings for executables

*** PATH environment variable
*** Contains the path to the WBIMB and JAVA executables.
*** (set into ENVFILE).
PATH='/usr/lpp/mqsi/bin:/usr/lpp/mqsi/nnsy/bin:<JAVAHOME>/bin'

*** LIBPATH environment variable
*** Contains the path to the DLLs (Dynamic Link Libraries)
*** (set into ENVFILE).
LIBPATH='/usr/lpp/mqsi/lib/wbirf:/usr/lpp/mqsi/lib/wbimb:/usr/lpp/mqsi/lib/wbieb:
/usr/lpp/mqsi/lib:/usr/lpp/mqsi/nnsy/lib:/usr/lpp/mqsi/nnsy/MIF/lib:<JAVAHOME>/lib:
<JAVAHOME>/bin:<JAVAHOME>/bin/classic'

*** Path to WBIMB lils and/or customer lils
*** (set into registry key LilPath for a broker only).
LILPATH='/usr/lpp/mqsi/lil:/usr/lpp/mqsi/nnsy/MIF/lib'

*** Path to DistHub product executables
*** This is default.
*** Modify this if using a non-standard installation path for DistHub
*** (set into ENVFILE)
DISTHUB_PATH='/usr/lpp/DistHub/V5R0M0'

*---------------------------------------------------------------------*

*** NLS settings

*** Locale settings to determine in which locale the component runs.
*** These are set into the ENVFILE.
*** For example:
****   LANG=Ja_JP.IBM-939 and LC_ALL=Ja_JP.IBM-939  for Japanese locale.
***    LANG='C', LC_ALL='C' for US English locale.
LANG='++LANG++'
LC_ALL='++LC_ALL++'

*** Time zone settings
*** Holds the time zone setting in which you are located
*** Refer to the IBM Manual "Unix System Services
*** Command Reference SC28-1892)
*** For example:
***   TZ='EST5'      for USA Eastern Standard Time
***   TZ='MEZ-1MES,M3.5.0,M10.5.0'  for Central Europe
***   TZ='GMT0BST'   for the UK
TZ='++TZ++'

*** NLSPATH environment variable
*** Contains the location of the message catalogs.
*** (set into ENVFILE).
NLSPATH='/usr/lpp/mqsi/messages/%L/%N:/usr/lpp/mqsi/nnsy/MIF/messages/%N'

*** CONSOLE_NLSPATH is used to locate the messages for the console.
*** For Japanese or S-Chinese messages, change En_US to Ja_JP or Zh_CN
*** below. For English messages these can be displayed in mixed or upper
*** case only. (see MC_MESSAGES).
*** CONSOLE_NLSPATH does not use %L or %N
CONSOLE_NLSPATH='/usr/lpp/mqsi/messages/En_US'

*---------------------------------------------------------------------*
*** Other Environment Variables needed by WMQI

*** Setting if messages should appear in mixed case or
*** uppercase   NO/YES (For example: MC_MESSAGES='NO').
MC_MESSAGES='++MC_MESSAGES++'

*** Specify DB2 Converter. (For example DB2_CONVERSION='SINGLE')
*** SINGLE - WBIMB uses SQL_EBCDIC_SCCSID to determine the DB2 converter.
***  This setting reflects the current MQSI behavior.
*** MIXED - WBIMB uses SQL_EBCDIC_MCCSID to determine the DB2 converter.
***  This setting requires that DB2 is configured to accept mixed
***  byte data. Use this setting when you want data to
***  be stored in the configured DB2 EBCDIC mixed byte code page.
*** LOCAL - WBIMB uses the localConverter identified by LC_ALL/LANG settings.
***  This complies to what is done on distributed platforms. This setting requires
***  that WBIMB and DB2 are using the same codepage, otherwise only WBIMB can
***  read DB2 data correctly. It gets unreadable for other ( non-MQSI )
***  applications that want to read the data.
DB2_CONVERSION='++SINGLE++'

*---------------------------------------------------------------------*
*** Automatic Restart Management

*** Switch Use ARM "YES/NO" (For example : USE_ARM='NO').
*** (set into ENVFILE).
USE_ARM='++USE_ARM++'

*** ElementName: Maximimum 8 Characters.
*** (For example : ARM_ELEMENTNAME="Q482BRK")
*** (set into ENVFILE).
ARM_ELEMENTNAME='MQ00BRK'

*** ElementType. (For example : ARM_ELEMENTTYPE='SYSWMQI')
*** (set into ENVFILE).
ARM_ELEMENTTYPE='++ARM_ELEMENTTYPE++'

*---------------------------------------------------------------------*
*** Job Card Section
*** Place the job card parameters for all jobs between the (JOBCARDBEGIN)
*** and (JOBCARDEND) tag.
*** All JOBs have the same job card parameters.
*** Do not change //BIPXXXXX JOB in the first line of the Job Card Section.
*** Do not remove the (JOBCARDBEGIN) and (JOBCARDEND) tag
(JOBCARDBEGIN)
//BIPXXXXX JOB 5655-G97,
// MSGLEVEL=(1,1),
// MSGCLASS=A,
// NOTIFY=&SYSUID
(JOBCARDEND)

*---------------------------------------------------------------------*
*** Environment Variable Section.
*** Place user environment variables needed in addition to the WMQI for z/OS
*** supplied variables between the (ENVIRONMENTBEGIN) and (ENVIRONMENTEND) tag.
*** Specify the environment variables as they appear in the ENVFILE.
*** For example: MYPATH=/usr/local/mylib
*** Do not remove the (ENVIRONMENTBEGIN) and (ENVIRONMENTEND) tag 
(ENVIRONMENTBEGIN)
NNSY_ROOT=/usr/lpp/mqsi/nnsy
NNSY_CATALOGUES=/usr/lpp/mqsi/nnsy/NNSYCatalogues/en_US
NN_CONFIG_FILE_PATH=++U/HOME++
(ENVIRONMENTEND)

Related concepts
Broker
Broker domain
User Name Server

Related tasks
Editing the Customization Input File (mqsicompcif) for a broker
Editing the Customization Input File (mqsicompcif) for a User Name Server