Creating additional UIM servers
You must have a separate UIM server for each z/OS system that you want to access. Use the procedures in this section to create additional UIM servers.
When the UIM server was installed, the sample startup procedure was copied, customized, and saved in your UIM sample library (HLQ.XXSAMP, where HLQ is the high-level qualifier that you specified during installation). Use this sample to create an additional UIM server.
To create a new UIM server, complete the following procedures in this section:
To create a startup configuration member
- Locate the #NORMAL member in the UIM sample library.
Create a new startup configuration member by copying the #NORMAL member from the sample library into your configuration file and giving it a new name.You will use this same name when you name the started task procedure for the new UIM server. The following figure shows the startup configuration member. The HLQ shown in this member is the high-level qualifier that you specified during installation.
<bmchttp>
<bmc_parm id="PORT" value="9999" />
<bmc_parm id="AUTH_TIMEOUT_SECS" value="1800" />
<bmc_parm id="AFF_TIMEOUT_SECS" value="1800" />
<bmc_parm id="HFS_DATASET" value="<HLQ>.HFS" />
<bmc_parm id="ALLOW_NETCMD" value="YES" />
</bmchttp>Edit the new startup configuration member by changing the variables that are listed in the following table:
Variable
Definition
Accepted value
Reference
<BMC_PARM ID='PORT' VALUE= '9999'/>
Port value for the UIM server
Unique numeric value in the range of 1 through 65535
<BMC_PARM ID='AUTH_TIMEOUT_SECS' VALUE='1800'/>
Security authorization timeout
Numeric value in seconds
<BMC_PARM ID='AFF_TIMEOUT_SECS' VALUE='affinitySeconds'/>
Idle timeout period for affinity tasks
Unique numeric value in seconds
<BMC_PARM ID='HFS_DATASET' VALUE='HLQ.HFS'/>
Hierarchical file system (HFS) data set name
Extended partitioned data set (PDSE) name for storing the HFS data
<BMC_PARM ID='ALLOW_NETCMD' VALUE='YES' />
Whether to enable or disable the network browser command interface
YES (default), NO, or AUTHORIZE
To create a started task procedure
After creating the startup configuration member, you must create a started task procedure for that startup member.
- Locate the #UIMx member in the UIM server sample library.
Create a new #UIMx member by copying the #UIMx member to your system procedure library and giving the new member the name that you selected for the startup member.The following figure shows the #UIMx member:
//uimx PROC M=uimx, <-- name of configuration member
// ENV=
//*--------------------------------------------------------------
//uimx EXEC PGM=UIMMAIN, +
// ACCT=(acct), <--- specify accounting info +
// REGION=0K, <--- specify region size +
// TIME=1440, +
// PARM=('-C &M &ENV -L =B =CNFTRACE =VERSION')
//*
//*- - - - - - - - - - - - - - - - - - - - -
//*
//* COMMON COMMAND-LINE PARAMETERS:
//*
//* -C MMMMMM CONFIGURATION FILE MEMBERNAME
//*
//* -P 9999 TCP LISTENER PORT NUMBER
//*
//* -L LOG MESSAGES AND TRACE VIA SUBTASK
//*
//*- - - - - - - - - - - - - - - - - - - - -
//* ENVIRONMENT VARIABLES TO CONTROL EXECUTION:
//*
//* =SOUT= SPECIFY THE SYSOUT CLASS FOR DYNAMICALLY ALLOCATED
//* LOG FILES( IE. =SOUT=X )
//*
//*- - - - - - - - - - - - - - - - - - - - -
//* SAS/C RUNTIME LIBRARY PARAMETERS:
//*
//* =B PRINT FUNCTION TRACEBACK WITH LIBRARY WARNINGS
//*
//* =CNFTRACE PRINT DIAGNOSTICS DUE TO TCP/IP CONFIGURATION FAILURES
//*
//* =S PRINT STORAGE ANALYSIS REPORT AT TERMINATION
//*
//* =U PRINT STORAGE USAGE REPORT AT TERMINATION
//*
//* =VERSION PRINT RUNTIME LIBRARY RELEASE INFORMATION TO SYSTERM
//*
//*--------------------------------------------------------------
//STEPLIB DD DISP=SHR,DSN=HLQ.XXLINK <--from new UIM/DHS installation
// DD DISP=SHR,DSN=HLQ.LOAD <--from new product installation
//*
//* SAS/C DD'S
//*
//SYSTERM DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//STGRPT DD SYSOUT=*
//*
//MSGLOG DD SYSOUT=*
//TRCLOG DD SYSOUT=*
//HTPCONT DD DISP=SHR,DSN=HLQ.XXCONT <--new UIM server content library
// DD DISP=SHR,DSN=HLQ.CONT <--from new product installation
//*
//HTPPARM DD DISP=SHR,DSN=HLQ.UIMCNFG <--library from UIM configuration install panel to write out tailored
config members
DD DISP=SHR,DSN=HLQ.XXCNFG <--new UIM configuration library
DD DISP=SHR,DSN=HLQ.CONFIG <--from new product installation
//*
//STDERR03 DD DUMMY MSG LOGGER
//STDERR04 DD DUMMY TRACE LOGGER
//STDERR05 DD DUMMY RR LOGGER
//*
//* STANDARD JOB DD'S
//*
//SYSUDUMP DD SYSOUT=*Edit the new #UIMx member.
- Add your DB2 load library to the STEPLIB concatenation.
- Change the variables that are listed in the following table:
Data set name variables
Definition
Accepted value
uimx
uimx is the name of the started task procedure and the startup configuration member
Name that you gave to the #UIMx member when you copied it to your system procedure library
HLQ.XXLINK
HLQ is the high-level qualifier for the load library that contains the UIM server and product execution code
Valid data set name qualifier
HLQ.*LINK
HLQ is the high-level qualifier for the library that contains your product code
HLQ.XXCONT
HLQ is the high-level qualifier for the library that contains content information for the UIM server
HLQ.XXCNFG
HLQ is the high-level qualifier for the library that contains UIM server execution parameters that are used during initialization of the UIM server
HLQ.UIMCNFG
HLQ is the high-level qualifier for the library from the UIM configuration installation panel to write out tailored configuration members
To allocate the HFS data set
After creating the startup configuration member and the started task procedure, you can perform the following steps:
- You can allocate and initialize the HFS data set.This server-side storage data set stores user preferences and dynamic configuration information on the UIM server.
- You can submit the customized data set, or you can customize a copy of the data set member in the sample library.During installation, theHLQ.HFS member in the SAMP library was created and customized with your site specific information. You can submit the customized data set, or you can customize a copy of the data set member in the sample library.
- You can share the HFS data set between all UIM servers that are on the host, or you can create an HFS data set for each UIM that is on the host.
To customize a copy of the data set member
Locate the #DEFHFS member in the UIM sample library.The following figure shows the default #DEFHFS member. The HLQ shown in this member is the high-level qualifier that you specified during installation.
//ALLPDSE EXEC PGM=IEFBR14
//HFSPDSE DD DISP=(NEW,CATLG),UNIT=SYSDA,SPACE=(CYL,(1,1)),
// DCB=(DSORG=PO,RECFM=VB,LRECL=4096),
// DSNTYPE=LIBRARY,
// DSN=HLQ.HFSEdit the #DEFHFS member by changing the values of the parameters that are listed in the following table:
Parameter
Definition
Accepted value
UNIT
Device for placing data sets
See your site standards
DSN
High-level qualifier for the HFS data set
See your site standards
- Save the edited #DEFHFS member with a new name.
- Submit the DEFHFSJC member JCL.
To initialize the HFS data set
Before you can share connections in a sysplex, you must initialize the HFS data set that you allocated. During installation, the HFSLOAD data set is created and customized with your site-specific information.
To submit a copy of the customized data set member
Locate #LOADHFS in the UIM server sample data set. The following figure shows the default #LOADHFS member:
//*--------------------------------------------------------------
//*
//* Load the BMC HFS PDSE with SAMP library members.
//* Optionally convert previous BMC HFS HostList.xml if found.
//*
//*--------------------------------------------------------------
//LOADHFS EXEC PGM=UIMHFSL,REGION=0K,
// PARM='=version $UIMHFSL $UIMHFST'
//*- - - - - - - - - - - - - - - - - - - - -
//* UIMHFSL parameters:
//*
//* memname Samplib control cards member, default is $HFSLOAD.
//* - $HFSLOAD is a Load of default properties files
//* -t Activate tracing to SYSPRINT
//*
//* SAS/C Runtime Library parameters:
//*
//* =version Print Runtime Library release information to SYSTERM
//*
//*--------------------------------------------------------------
//STEPLIB DD DISP=SHR,DSN=HLQ.LOAD
//*
//* SAS/C DD'S
//SYSTERM DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//STGRPT DD SYSOUT=*
//*
//* STANDARD JOB DD'S
//SYSUDUMP DD SYSOUT=*
//*
//HFSPDSE DD DISP=SHR,DSN=HLQ.HFS
//SAMP DD DISP=SHR,DSN=HLQ.SAMP
//CONT DD DISP=SHR,DSN=HLQ.CONTENT
//*- Edit the #LOADHFS member, and change the variableHLQ to the high-level qualifier according to your site standards.
Save the edited member as HFSLOAD.
- Submit the HFSLOAD member JCL.
To enable or disable password caching
By default, when you create connections, the UIM server caches the password. However, you can enable and disable the password caching.
Locate member #UPDADM in the UIM server sample library. The following figure shows the default member #UPDADM:
//*--------------------------------------------------------------
//*
//* Load the BMC HFS PDSE with SAMP library member to update the
//* Password Caching setting.
//*
//*--------------------------------------------------------------
//UPDADM EXEC PGM=UIMHFSL,REGION=0K,
// PARM='=b =version $UPDADM'
//* memname Samplib control cards member, default is $HFSLOAD.
//* - $UPDADM is an update of Password cache member only
//* -t Activate tracing to SYSPRINT
//*
//*--------------------------------------------------------------
//STEPLIB DD DISP=SHR,DSN=HLQ.LOAD
//*
//* SAS/C DD'S
//SYSTERM DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//STGRPT DD SYSOUT=*
//*
//* STANDARD JOB DD'S
//SYSUDUMP DD SYSOUT=*
//*
//HFSPDSE DD DISP=SHR,DSN=HLQ.HFS
//SAMP DD DISP=SHR,DSN=HLQ.SAMP- Edit member #UPDADM, and changeHLQ to the high-level qualifier according to your site standards.
- Save the edited member as UPDADMIN.
Save the edited member as UPDADMIN.The following example shows the default member $ADMIN.
AllowPasswordCaching=true- Perform one of the following actions:
- To disable password caching, set AllowPasswordCaching=false.
- To enable password caching, set AllowPasswordCaching=true.
- Save $ADMIN.
- Submit the member UPDADMIN JCL.
Related topic