DSC monitor
DSC includes an APF-authorized started task monitor (IQIMONTR).
End users can communicate with IQIMONTR using operator commands issued to the IQINONTR address space, or via the DSCMON Control Center ISPF application.
Only a single DSC Monitor task can be active in any given node (z/OS® image) of a sysplex. There may be multiple concurrent instances of the DSCMON Control Center application, communicating with the IQIMONTR address-space using z/OS cross-memory services.
All active IQIMONTR tasks of a sysplex communicate with each other via the z/OS Cross-System-Coupling-Facility (XCF).
In order to control the DSC Monitor operation a user is expected to have one of the following RACF® defined authority levels:
- FULL
- Complete control to start, stop, modify, and display Monitor status.
- LIBS
- Modify monitored LLA libraries status and display Monitor status.
- VIEW
- May only display Monitor status.
- NONE
- No authority at all.
IQIMONTR requires the ability to dynamically establish and activate SMF IEFU83 and IEFU84 system user exits in order to examine SMF records type 14, 15 and type 42.
JCL procedure
A sample JCL procedure is provided in member IQIJMON of the SIQIINST target library. The sample should be copied into the system PROCLIB library in order to be used to start a DSC Monitor task.
Here is the procedure:
//*********************************************************************
//*********************************************************************
//* LICENSED MATERIALS - PROPERTY OF IBM *
//* 5698-DSC (C) COPYRIGHT IBM CORP. 2013,2018. *
//* ALL RIGHTS RESERVED. *
//* *
//* US GOVERNMENT USERS RESTRICTED RIGHTS *
//* - USE, DUPLICATION OR DISCLOSURE RESTRICTED BY *
//* GSA ADP SCHEDULE CONTRACT WITH IBM CORPORATION. *
//* *
//* PROCEDURE: IQIJMON *
//* *
//* FUNCTION: *
//* EXECUTE DATA SET COMMANDER LLA MONITOR *
//* *
//* THIS JOB SHOULD BE RUN IN EACH Z/OS IMAGE OF A SYSPLEX *
//* THAT REQUIRES AUTOMATIC LLA REFRESH SERVICES. *
//* *
//* *
//* DESCRIPTION *
//* THE IQIMONTR IS AN APF-AUTHORIZED STAND-ALONE JOB WHICH MAY *
//* SUBMITED AS A LONG RUNNING BATCH JOB OR A STARTED TASK. *
//* IT ACCEPTS OPERATOR COMMANDS VIA A "MODIFY" CONSOLE COMMAND *
//* OR VIA THE "DSCMON" MENU-DRIVEN ONLINE APPLICATION WHICH IS *
//* PART OF THE INTERACTIVE COMPONENT OF THE DATA SET COMMANDER. *
//* *
//* NOTE: *
//* ARROWS "<==" POINT TO LINES WHICH ARE RECOGNIZED *
//* AS REQUIRING CUSTOMIZATION. PARAMETERS AND *
//* KEYWORDS NEEDING TO BE CUSTOMIZED ARE ENTERED *
//* IN LOWER CASE TO MAKE THEM EASIER TO FIND. *
//* ALL JCL MUST BE IN UPPER CASE BEFORE SUBMITTING *
//* THE JOB TO AVOID JCL ERRORS. *
//* SPECIFIC ITEMS NEEDING CUSTOMIZATION INCLUDE: *
//* 1. ADD A JOB CARD WHEN EXECUTING IN A BATCH JOB. *
//* 2. CHANGE "AUTHLIB" IF NECESSARY. *
//* 3. CHANGE "HLQ" IF NECESSARY. *
//* 4. LIST OF MONITOR OPTIONS ENCLOSED WITH SINGLE QUOTES. *
//* 5. CHANGE "OUTCL" IF NECESSARY. *
//* 6. CHANGE "SMFILTER" IF NECESSARY, AND SPECIFY "SMFFILT" *
//* OPTION TO ACTIVATE AT MONITOR STARTUP. *
//* *
//*********************************************************************
//*********************************************************************
//*
//*********************************************************************
//IQIJMON PROC AUTHLIB=SIQILOAD, <== LOW LEVEL QUALIFIER /*NOTE 2*/
// DYNMAX=999, DYNAMIC ALLOCATION LIMIT
// HLQ=IQI.V9R1M0, <== HIGH LEVEL QUALIFIER /*NOTE 3*/
// OPTS=, <== EXECUTION OPTIONS /*NOTE 4*/
// OUTCL=A, <== OUTPUT PRINT CLASS /*NOTE 5*/
// REG=0M, REGION SIZE
// SMFILTER=NULLFILE, <== SMF FILTERING INPUT /*NOTE 6*/
// TIMELIM=1440 RUNNING TIME LIMIT
//*
//IQIMONTR EXEC PGM=IQIMONTR,
// DYNAMNBR=&DYNMAX,
// PARM='&OPTS',
// REGION=®,
// TIME=&TIMELIM
//STEPLIB DD DISP=SHR,DSN=&HLQ..&AUTHLIB
//IQIMTFLT DD DISP=SHR,DSN=&SMFILTER
//IQIMTMSG DD OUTLIM=0,SYSOUT=&OUTCL
//SYSABEND DD OUTLIM=0,SYSOUT=&OUTCL
//* PEND
A sample batch job is provided in member IQIJBMON of the SIQIINST target library. It can be used for submitting a DSC Monitor batch job.
For a description of the execution parameters for IQIMONTR, see the DSC User's Guide and Reference.
SMF Record Filtering Definition File
This sequential file contains SELECT and EXCLUDE statements of the target data set names. Member IQIMTFLT of the SIQITLIB library is an example of expected input file.
*---------------------------------------------------------------------*
* IBM Data Set Commander *
* 5698-DSC (C) Copyright IBM Corp. 2012,2018. All rights reserved. *
*---------------------------------------------------------------------*
* *
*---------------------------------------------------------------------*
* SMF record filtering Table *
* ========================== *
* *
* The DSC Monitor SMF filtering function may be used to direct SMF to *
* suspend recording of SMF records pertaining to irrelevant data sets.*
* SMF filtering is enabled when DD IQIMTFLT, of the DSC Monitor job *
* or started task, specifies a partitioned data set source member or *
* a sequential data set with at least one valid SELECT or EXCLUDE *
* statement. *
*@Note: SMF record types 14, 15, 17, 18, 42, 62, and 64 of data set *
* names that are explicitly or implicitly filtered out, *
* will not be recorded. *
* *
* Syntax *
* ------ *
*<> Significant text - columns 1 to 71. *
*<> Comment line - any non-action text. *
* Starts with "*" in column 1. *
*<> Selection statement - specifies a distinct data set name or a *
* data set name pattern mask, preceded by a "S=" or "SELECT=" . *
* May start at column 1 or be preceded by one or more blanks. *
* Ends with blank after the data set name string. *
*<> Exclusion statement - specifies a distinct data set name or a *
* data set name pattern mask, preceded by an "E=" or "EXCLUDE=" . *
* May start at column 1 or be preceded by one or more blanks. *
* Ends with blank after the data set name string. *
* *
* Filter processing rules *
* ----------------------- *
*<> EXCLUDE statements have priority over SELECT statements. *
*<> When a data set name does not match any filter statement, it will *
* be excluded if at least one SELECT statement is present, *
* or included if only EXCLUDE statements are present. *
* *
* Pattern mask rules *
* ------------------ *
*<> "%" character is the "any single character" wild-card. *
*<> "*" character is the "any character string" wild-card. *
*<> both wild cards may represent a potential "." (dot) character. *
*<> an "all wild cards" mask is unacceptable. *
* *
* Distinct data set selection examples *
* ------------------------------------ *
SELECT=IQI.SIQIPLIB
EXCLUDE=IQI.SIQITLIB
*
* Data set pattern mask selection examples *
* ---------------------------------------- *
S=SYS%.*IQI*LIB
E=SYS1.AIQI*
* *
*---------------------------------------------------------------------*
* IBM Data Set Commander *
* 5698-DSC (C) Copyright IBM Corp. 2012,2018. All rights reserved. *
*---------------------------------------------------------------------*
APF authority
The load library containing load modules IQIMONTR, IQIMONCA, IQIMON24 and IQIMON31 must be defined as an APF authorized library. These modules normally reside in the SIQILOAD target library. Failure to do so will cause the address space to terminate with return code of 24, with the following messages in the JESMSGLG of the job output.
+IQIMT100E IQIMONTR MUST RESIDE IN AN APF AUTHORIZED LIBRARY
+IQIMT064I MONITOR SHUTTING DOWN
z/OS console command SETPROG may be used to APF-authorize a library, for example:
SETPROG APF,ADD,DSN=IQI.V9R1M0.SIQILOAD,SMS
RACF authority
IQIMONTR is protected via the following RACF defined resource entities:
ENTITY=IQIMONTR.OPER of CLASS=FACILITY
ENTITY=IQIMONTR.TSO of CLASS=FACILITY
The expected RACF user authorization levels may be defined as follows:
FULL - LEVEL=CONTROL for ENTITY=IQIMONTR.OPER of CLASS=FACILITY
LIBS - LEVEL=ALTER for ENTITY=IQIMONTR.OPER of CLASS=FACILITY
LIBS - LEVEL=UPDATE for ENTITY=IQIMONTR.OPER of CLASS=FACILITY
LIBS - LEVEL=CONTROL for ENTITY=IQIMONTR.TSO of CLASS=FACILITY
VIEW - LEVEL=READ for ENTITY=IQIMONTR.OPER of CLASS=FACILITY
VIEW - LEVEL=UPDATE for ENTITY=IQIMONTR.TSO of CLASS=FACILITY
VIEW - LEVEL=READ for ENTITY=IQIMONTR.TSO of CLASS=FACILITY
NONE - All other possible RACF levels.
SMF Dynamic User Exit
IQIMONTR requires the ability to dynamically establish an SMF IEFU83 system user exit in order to examine SMF records type 15 and type 42.
EXIT ADD EXITNAME(SYS.IEFU83) MODNAME(IEFU83)
EXIT ADD EXITNAME(SYSSTC.IEFU83) MODNAME(IEFU83)
EXIT ADD EXITNAME(SYS.IEFU84) MODNAME(IEFU84)
EXIT ADD EXITNAME(SYSSTC.IEFU84) MODNAME(IEFU84)
SYS(TYPE(...,14,15,...42,...)...)
SYS(EXITS(...,IEFU83,IEF84,..))
SUBSYS(STC,EXITS(...,IEFU83,IEFU84,...))
Cross-Coupling-Facility (XCF) naming convention
Each active IQIMONTR task dynamically registers (that is, joins) into the sysplex XCF environment with:
XCF GROUP NAME: IQIMONTR (8 characters)
XCF FUNCTION DESCRIPTION: IBM DSC_LLA_MONITOR (24 characters)
XCF MEMBER NAME: host system name (8 characters)
References
For more information, see:
- z/OS MVS™ Initialization and Tuning Guide
- z/OS Security Server RACF System Programmer's Guide
- z/OS MVS Programming: Sysplex Services Guide
- z/OS MVS Setting Up a Sysplex
- z/OS MVS Programming: Sysplex Services Reference
- z/OS MVS System Commands