Configuring the started task on the z/OS server


When you install Universal Information Exchange (UIE) on the z/OS server, it automatically customizes a job in the hiqual.midqual.SAMPLJCL library named E2COMM.

The version that BMC sends you looks like the following JCL:

//E2COMM JOB(ACCOUNT),' USER NAME ',
// class="A",MSGCLASS=X,TIME=1440
//*
//*WHEN YOU ARE READY TO RUN THIS PROGRAM IN PRODUCTION MODE
//*(PROBABLY AS A STARTED TASK) YOU MAY REMOVE ALL THE STEPS EXCEPT
//*THE E2COMM STEP. THE OTHER STEPS EXIST TO CREATE AND PRIME THE
//*TARGETS FILE WHILE YOU ARE RUNNING THE PROGRAM IN TEST MODE.
//*PLEASE DO NOT FORGET TO REMOVE THE OVER-RIDE OF THE 'SYSUT1'
//*DD FOR THE 'INIT' STEP WHICH IS FOUND AT THE BOTTOM OF THE JOB.
//*
//*NOTE: THE E2COMM PROGRAM LISTENS FOR THE FOLLOWING CONSOLE
//*COMMANDS - "STOP E2COMM" OR "MODIFY E2COMM,STOP" IN ORDER
//*TO PROVIDE FOR A CLEAN SHUT DOWN.
//*
//* STARTPROC E2COMM
//*
//E2COMMPROC HIQUAL='BMCMVP',
//MIDQUAL='UIE.R1x00',
//PORT='2052'
//*
//ALLOCEXEC PGM=IEFBR14
//TARGETSDDDISP=(MOD,CATLG),
//UNIT=SYSALLDA,
//SPACE=(TRK,(1,5)),
//LRECL=260,
//BLKSIZE=0,
//RECFM=VB,
//DSORG=PS,
//DSN=&HIQUAL..&MIDQUAL..TARGETS
//*
//EMPTYEXEC PGM=E2NULL
//STEPLIBDDDISP=SHR,
//DSN=&HIQUAL..&MIDQUAL..LOAD
//DDDISP=SHR,
//DSN=&HIQUAL..&MIDQUAL..LINKLIB
//SYSTERMDDSYSOUT=*
//SYSUT1DDDISP=SHR,
//DSN=&HIQUAL..&MIDQUAL..TARGETS
//*
// IF (EMPTY.RC=1) THEN
//INITEXEC PGM=IEBGENER
//SYSPRINTDDSYSOUT=*
//SYSUT1DDDUMMY
//SYSUT2DDDISP=OLD,
//DSN=&HIQUAL..&MIDQUAL..TARGETS
//SYSINDDDUMMY
// ENDIF
//*
/E2COMMEXEC PGM=E2COMM,
//PARM='&PORT =TCPIP_MACH=TCPIP'<- TCPIP STC NAME
//*
//* IF YOUR TCP/IP STC NAME IS NOT "TCPIP" THEN YOU SHOULD
//* CHANGE THE PRECEDING PARM TO " =TCPIP_MACH=YOURTCP".
//* IF YOU NEED TO CHANGE THE NAME HERE, YOU WILL ALMOST
//* CERTAINLY NEED TO CHANGE THE " =TCPIP_MACH=YOURTCP" PARM
//* IN THE EXANAG02 JOB STEP WHICH TRANSMITS DATA FROM YOUR
//* Z/OS SERVER TO YOUR PC WHICH IS FOUND IN THE JCL PROC
//* THAT IS GENERATED BY THE UIE ISPF FRONT-END OPTION 5.
//* CHANGING "&HIQUAL..&MIDQUAL..ISPSLIB(EXANAG)" WHICH IS
//* USED BY THE ISPF FRONT-END AS A JCL SKELETON WILL MAKE
//* THE CHANGE GLOBALLY AVAILABLE TO ALL USERS OF UIE.
//*
//STEPLIBDDDISP=SHR,
//DSN=&HIQUAL..&MIDQUAL..LOAD
//DDDISP=SHR,
//DSN=&HIQUAL..&MIDQUAL..LINKLIB
//TARGETSDDDISP=SHR,FREE=CLOSE,
//DSN=&HIQUAL..&MIDQUAL..TARGETS
//SYSPRINTDDSYSOUT=*
//SYSTERMDDSYSOUT=*
//PODMSGDDSYSOUT=*
//SYSOUTDDSYSOUT=*
//PEND
//*
//* END OF PROC E2COMM
//*
//E2COMMEXEC E2COMM
//INIT.SYSUT1 DD *
<?XML VERSION="1.0"?>
<HOSTCOUNT>001</HOSTCOUNT>
<HOSTLIST>
<HOST NAME="USER.BMC.COM" ADDR="000.000.000.000" PORT="2052"/>
</HOSTLIST>
/*
// 

Customizing your library member

The E2COMM job runs as a started task after you have completed the entire installation and customization process and have begun to run Universal Information Exchange programs in a production mode.
The E2COMM program listens for the z/OS console commands, STOP E2COMM or MODIFY E2COMM, STOP to provide for a clean shutdown.
Make sure the E2COMM program, running as either a batch job or started task, is automatically started on your z/OS server following the initialization of TCP/IP. You want the E2COMM program to run continuously so that the workstation where you analyze the Universal Information Exchange data can connect to it at any time. You can run it continuously as a batch job, but be aware that the E2COMM program occupies an initiator as long as it runs.

This section contains the following topics:

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*