Customizing the UNIX System Services shell

You need to customize the UNIX System Services shell, not only if you want to start the CIM server from here.

All commands of the z/OS CIM server are UNIX style programs running in a UNIX System Services shell and executing in the Enhanced ASCII mode. This means that all string data is represented in ASCII rather than in EBCDIC encoding. To be able to execute z/OS CIM server commands, a UNIX System services shell has to be started and the environment has to be set up to enable automated ASCII-EBCDIC translation and to find the necessary libraries and executables.

There are two ways to set up a shell for CIM server commands:

• In the UNIX System Services, or
• Using BPXBATCH in a JCL job

Setting up a shell in the UNIX System Services:

The file /usr/lpp/wbem/install/profile.add contains the basic settings to enable z/OS CIM server commands. You can add the contents of profile.add to /etc/profile to set up the z/OS CIM server environment for all users of the UNIX System Services shell or to the individual profile in the home path of each user who wants to use the commands.

Setting up a shell using BPXBATCH in a JCL job:

Use the utility BPXBATCH to run CIM server commands using a JCL job.

Example to run the cimivp utility:

//STEP1    EXEC PGM=BPXBATCH,TIME=NOLIMIT,REGION=0M,
//         PARM='PGM /usr/lpp/wbem/bin/cimivp 127.0.0.1'
//STDENV   DD   PATH='/etc/wbem/cimserver.env'
//STDOUT   DD SYSOUT=*
//STDERR   DD SYSOUT=*
//CEEDUMP  DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//SYSMDUMP DD SYSOUT=*

The file /etc/wbem/cimserver.env contains the basic settings for the BPXBATCH environment. You can find an alternative example for the usage of BPXBATCH in job CFZRCUST in SYS1.SAMPLIB.

More information:

• See Setting the CIM server environment variables for details on CIM server specific environment variables.
• See z/OS® UNIX System Services User's Guide for details on the BPXBATCH utility.