Skip to Content

z/OS

  1. Run JQPREGA job to allocate the QPREG input data set. Member JQPREG in the installation PDS contains JCL to allocate the QPREG input data set. See Code listing 9 for sample JCL.
  2. Enter registration commands in the QPREG input data set from step 1.
    The monitoring extension name and type paths are case sensitive and control statements cannot span records. This table lists the possible values for the input file for QPREG. See the list below for the sample QPREG input file format.
  3. Run JQPREG job to register objects (update EAAXML) for monitoring on z/OS.
    Member JQPREG in the installation PDS contains JCL to run the QPREG program using the QPREG input data set updated in previous step. See the list below for sample JCL.

Related topics

Defining-policies  

Monitoring-objects

Sample input file for QPREG on z/OS
R,WebSphere MQ Server Connection Monitor,ComMQSoftwareWebSphereMQSVRCONNQueue Manager!ComMQSoftwareWebSphereMQServerClientMachine,CSQ1!WORKSTATION1
U,WebSphere MQ Server Connection Monitor,ComMQSoftwareWebSphereMQSVRCONNQueue Manager!ComMQSoftwareWebSphereMQServerClientMachine,CSQ1!WORKSTATION2
R,WebSphere MQ Server Connection Monitor,ComMQSoftwareWebSphereMQSVRCONNQueue Manager!ComMQSoftwareWebSphereMQServerClientMachine,CSQ1!WORKSTATION3

The list above is an example that updates EAAXML and tells QPSCM to monitor all server connection channels to queue manager CSQ1 used by clients WORKSTATION1 and WORKSTATION3. It also unregisters the connection from WORKSTATION2 so that MainView Middleware Monitor does not report this information. The list below is an example JCL to allocate the QPREG input file.

Allocate QPREG input file
//JQPREG JOB (990),'JQPREG', MSGCLASS=X,CLASS=A,NOTIFY=&SYSUID
//*
//ALLOC EXEC PGM=IEFBR14
//DD1 DD=YOURHLQ s/b YOURHLQ.QPSCM.IN
//DISP=(NEW,CATLG,DELETE),
//UNIT=3390,
//VOL=SER=MQS263,
//SPACE=(TRK,(30,15),RLSE),
//DCB=(LRECL=1020,DSORG=PS,RECFM=FB,BLKSIZE=1020)

The list below is an example of JCL to execute QPREG using the parameters entered in the QPREG input file defined in the list above. The file name execution must be in the form of DD:DDNAME.

Register QPREG input file
//JQPREG JOB (990),'REGISTER',MSGCLASS=C,CLASS=A,
// NOTIFY=&SYSUID
//*
//JOBL DD DISP=SHR,DSN=YOURHLQ.LOADLIB
//*
//FILE EXEC PGM=QPREG
//PARM=('MSGFILE(SYSOUT)/file DD:SYSIN')
//SYSPRINT DD SYSOUT=*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//SYSIN DD DISP=OLD,DSN=YOURHLQ.QPSCM.IN

Warning

Note

If you are getting sock_connect failed with error: 37 messages, then add an EAAPIINI DD to the QPREG JCL, as shown below:
 //EAAPIINI DD DSN=YOUR.PDS.CNTL(QRGEAAPI),
 // DISP=SHR
Then, in the PDS member, QRGEAAPI, add the following (SDV22D could be changed to IP address too):
(networksettings)
sock_bind_address=SDV22D

 

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

MainView Middleware Monitor 9.1