Host setup and configuration - syncsort_scc_monitor - Latest

Step 2 - Setup monitor

A fully functional Explorer GUI requires a Monitor license. If you activate Monitor on your host systems, the following configuration changes to Monitor are required to activate the Explorer GUI interface.

The Explorer/Monitor interface is performed using the MONRUNM started task. Copy the MONRUNM member from the DTS.R61.SLyyddd.SAMPLIB library to a system procedure library such as SYS1.PROCLIB.

Fields represented with bold type in the delivered members may need to be modified to match installation standards before submission.

//*
//* THIS PROCEDURE IS USED BY SCC MONITOR TO RUN MONRUN AS A STC
//* FOR THE PURPOSE OF GETTING OUTPUT BACK TO EXPLORER GUI
//*
//* NOTE: MODIFY THE PROCEDURE PARAMETERS TO USE THE APPROPRIATE
//*       DIF AND SCC MONITOR DATA SETS
//*       ALSO SORT UTIL DDNAMES (DEFAULTS ARE FOR ICETOOLS)
//*
//*       THIS MEMBER MUST BE COPIED TO A SYSTEM PROCLIB
//*
//MONRUNM PROC NAME=@MONPDSI,
//           PGMLIB='DTS.R61.LOADLIB',
//           PRM0LIB='DTS.R61.RULELIB',
//           P=,
//           P2=
//RUN      EXEC PGM=MONRUN,
// PARM='&P,&P2'
//STEPLIB DD DISP=SHR,DSN=&PGMLIB
//TEMPPDS DD DISP=(NEW,DELETE),SPACE=(CYL,(1,1,20)),UNIT=SYSDA,
//   DCB=(LRECL=80,RECFM=FB,BLKSIZE=3120,DSORG=PO)
//TEMPSEQ DD DISP=(NEW,DELETE),SPACE=(CYL,(1,1)),UNIT=SYSDA,
//   DCB=(LRECL=80,RECFM=FB,BLKSIZE=3120,DSORG=PO)
//PARMLIB DD DISP=OLD,DSN=*.TEMPPDS,VOL=REF=*.TEMPPDS,
//   DCB=BLKSIZE=32000
//         DD DISP=SHR,DSN=&PRM0LIB
//SYSPRINT DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))
//SYSOUT   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))
//SYSUT1   DD UNIT=SYSALLDA,SPACE=(CYL,(10,10))
//SYSUT2   DD UNIT=SYSALLDA,SPACE=(CYL,(10,10))
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(10,10))
//TOOLMSG  DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))
//DFSMSG   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))
//JCLLIST  DD DUMMY
//SYSIN    DD DISP=SHR,DSN=&PRM0LIB(&NAME)

      

The MONPOOLS member in the DTS.R61.PARMLIB dataset is used to define the default pool definitions used by Monitor and the Explorer GUI. The MONPOOLS member delivered by DTS contains a single statement that automatically maps the DF/SMS storage groups into pool definitions:

INCLUDE #SMSPOOL

Examine the MONPOOLS member. The PDS member contains sample pool definitions that can be used by your installation to create additional pool definitions. For example, you can use the DEFPOOL statements to create pools for non-SMS managed volumes.

Step 2c - Start monitor and optionally MON-RTM

If the MON-Snapshot (MON) product has not already been started, modify the START00 member in the DTS.R61.PARMLIB dataset to include the statement below. The Monitor will automatically start when the DIF started task performs initialization.

START MON

F DIF,START MON

If the installation is also running the MON-RTM product on the host to be used by the Explorer History Database component, add the following statement to the START00 member:

START RTM

If your installation is running SRS, use the following steps to set up the Explorer GUI to monitor SRS recovery messages. First create an SRS recovery log file. The JCL below can be used to create a GDG base and the initial log file. To avoid problems on the DIF dynamic allocation request, the volume specified in STEP2 must be the location of the catalog (master or usercat) used by the GDG data set.

//JOBCARD JOB ... (RC=0 expected)
//STEP1 EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
  DELETE DTS.SRSRECV.MSG.* DELETE DTS.SRSRECV.MSG FORCE
  DEFINE GDG(NAME(DTS.SRSRECV.MSG) LIMIT(10))
//STEP2 EXEC PGM=IEFBR14
//DD1 DD DSN=DTS.SRSRECV.MSG,DISP=(NEW,KEEP),
// SPACE=(TRK,(0)),UNIT=SYSALLDA,VOL=SER=CATVOL
//STEP3 EXEC PGM=IEFBR14
//DD1 DD DSN=DTS.SRSRECV.MSG(+1),DISP=(NEW,CATLG),
// SPACE=(CYL,(10,10)),UNIT=SYSALLDA
      

Once the file is created, add the following DD statement to the DIF JCL located in a system procedure library such as SYS1.PROCLIB:

//SRSRECV DD DISP=SHR,DSN=DTS.SRSRECV.MSG(0)

The SRS rules must be updated so that SRS recovery actions produce log records for the SRS recovery log used by the Explorer GUI. Add the following statement to the SRS rules member (typically ACCRULES or SRSRULES in most installations):

DEFPROD MSG(RULESET(@SRSMSG))

After updating the rules, refresh the SRS product rules by issuing the following command from an MVS operator console:

F DIF,REFRESH SRS

Step 3b - Allocate DTS.R61.ISPFLIB to the SYSEXEC DD in the DIF started task

Several Explorer GUI commands require Rexx scripts that need to be allocated to the DIF SYSEXEC DD statement. The required members are located in the DTS ISPFLIB distribution dataset. The default library name is DTS.R61.ISPFLIB. Add the following DD statement to the DIF JCL located in a system procedure library such as SYS1.PROCLIB:

//SYSEXEC DD DISP=SHR,DSN=DTS.R61.ISPFLIB

If the installation is also running the MON-RTM product on the host to be used by the Explorer History Database component, an RTMDB DD statement is required. For example:

//RTMDB DD DUMMY

Step 4 - Restart the DIF started task

DIF must be restarted to get the SRS recovery log or other new or modified DD statements activated. Issue the following commands to restart the DIF address space. The SCC products running under DIF will remain active during the restart when using the command shown below:

F DIF,Z S DIF

An OMVS segment must be defined to the RACF userid used by the DIF started task. This segment definition allows DIF to use TCP/IP.

Step 5A - Find the RACF userid assigned to DIF

Examine an executing DIF started task, or the output messages from a previous execution. One of the first messages in the log file (IEF695I) contains the userid assigned to the started task. For example, the following message shows DIF is using the STCUSER userid:

IEF695I START DIF WITH JOBNAME DIF IS ASSIGNED TO USER STCUSER , GROUP DTS

From a TSO ready prompt, issue the following LU command for the userid obtained in the previous step to display the OMVS information:

LU STCUSER OMVS

OMVS INFORMATION
----------------
... 
HOME= /
PROGRAM= /bin/sh

Step 5C - Adding an OMVS segment

The following RACF command can be used to update the RACF userid with the necessary OMVS parameters. The example uses the sample userid STCUSER. The directories specified on the HOME and PROGRAM parameters are case sensitive.

ALU STCUSER OMVS(HOME(/) PROGRAM(/bin/sh))

The Explorer GUI executes the MONRUNP started task to run third-party software products. For example, the following menu request runs ADRDSSU to compress DSORG=PO datasets on a volume:

Since the non-Monitor applications are not DIF aware, the procedure uses the IPIO subsystem to capture the output from the started task and route the output back to the Explorer GUI.

Step 6A - Start the SCCIPIO subsystem to capture output

The IPIO subsystem is a mainframe facility developed for the Explorer GUI to capture “real-time” output from user or third-party applications started by the Explorer GUI. The subsystem interface pipes I/O requests from DD statement(s) back to the Explorer GUI using a TCP/IP connection. The Explorer GUI receives the records as they are written to the DD statement instead of having to wait for the job to complete.

By default, IPIO is not installed by the installation procedures. To activate the subsystem, SCCIPIO must be started by DIF:

F DIF,START SCCIPIO

To configure DIF to automatically start the IPIO facility whenever DIF goes through initialization, add the following card to the START00 member of the DTS PARMLIB dataset:

START SCCIPIO

Fields represented with bold type may need to be modified to match installation standards before submission.

The ExplorerGUI/non-Monitor interface is performed using the MONRUNP started task. Copy the MONRUNP member from the DTS.R61.SLyyddd.SAMPLIB library to a system procedure library such as SYS1.PROCLIB. Fields represented with bold type may need to be modified to match installation standards before submission.

//*
//* THIS PROCEDURE IS USED BY THE SCC EXPLORER/IPHONE APPLICATIONS
//* TO RUN THIRD-PARTY SOFTWARE PRODUCTS.
//*
//* THE FIRST STEP CREATES THE SYSIN DD STATEMENT FOR THE
//* THIRD-PARTY SOFTWARE PRODUCT USING THE SYSIN PARAMETER ON THE
//* DIF OSJOB COMMAND USED TO START THE PROC.
//*
//* THE SECOND STEP USES THE DTS IPIO SUBSYSTEM INTERFACE TO
//* CAPTURE REAL-TIME OUTPUT RECORDS AND RETURN THEM TO THE
//* EXPLORER INTERFACE.
//*
//* NOTES: SCCIPIO MUST BE STARTED BY THE DIF ADDRESSS SPACE.
//*
//* THIS MEMBER MUST BE COPIED TO A SYSTEM PROCLIB
//*
//MONRUNP PROC PROG=IDCAMS,
//         PGMLIB='DTS.R61.LOADLIB',
//         P=
//INIT    EXEC PGM=DIFBR14
//STEPLIB DD DISP=SHR,DSN=&PGMLIB
//SYSIN   DD DISP=(NEW,PASS),SPACE=(CYL,(1,1)),UNIT=SYSDA,
//   DCB=(LRECL=80,RECFM=FB,BLKSIZE=3120),
//   DSN=&SYSIN
//SYSPRINT DD DUMMY
//RUN EXEC PGM=&PROG,PARM='&P'
//SYSPRINT DD SUBSYS=(IPIO),
// DCB=(LRECL=121,RECFM=F,BLKSIZE=121,DSORG=PS)
//SYSIN    DD DSN=*.INIT.SYSIN,DISP=OLD