Batch Utilities › CA IDMS Enforcer Batch Utilities › Dictionary Audit (ESXAUDIT) › SELECT\EXCLUDE Table

SELECT\EXCLUDE Table

Each of the entity-type names must be fully specified as listed below.

Exhibit 4.12: SELECT/EXCLUDE Dictionary Entities

 //ESXAUDIT JOB (job card parameters),CLASS=A,MSGCLASS=A
 //ESXAUDIT EXEC PGM=ESXBDIC,REGION=1000K
 //STEPLIB  DD DISP=SHR,DSN=your.ca.loadlib
 //         DD DISP=SHR,DSN=your.idms.loadlib
 //SYSCTL   DD DISP=SHR,DSN=your.idms.sysctl
 //SYSIDMS  DD *
 DMCL=your.dmcl.name
 //SYSLST   DD SYSOUT=a
 //SYSIPT   DD *
  PROCESS,
    DICTIONARY=dictionary-name,
    NODE=node-name,
    TERSE,
  SELECT=select-value(s),
  EXCLUDE=exclude-value(s),
  STARTDATE=mmddyy,
  ENDDATE=mmddyy
 /*
 //

Exhibit 4.13: Model z/OS and Z/OS JCL (ESXAUDIT)

Key to Variables

• job card parameters — The job card parameters at your company.
• your.ca.loadlib — The name of the load library into which the CA IDMS Enforcer load modules were link edited.
• your.idms.loadlib — The name of the load library into which the CA IDMS load modules were link edited.
• your.idms.sysctl — The dataset name of the SYSCTL file for the Central Version (CV) used during CA IDMS Enforcer batch processing.
• your.dmcl.name — The name of your runtime system DMCL.
• a — An appropriate SYSOUT class for your company.
• dictionary-name — Is optional. If specified, must be a 1- to 8-character name of the dictionary specified for utility function.
• node-name — Is optional. If specified, must be a 1- to 8-character name of the node specified for utility function.
• select-value(s) — The entity-type name(s) selected for audit. The required keyword, SELECT, provides the entity-types that are selected for audit. You must select one or more entity types or specify the ALL parameter on the SELECT statement. Multiple entity names must be encased in parenthesis and separated by commas. See SELECT\EXCLUDE Table for SELECT values.
• exclude-value(s) — Optional keyword EXCLUDE enables you to limit the entity selections made with the SELECT parameter. Multiple entity types specified must be encased in parenthesis and separated by commas. See SELECT\EXCLUDE Table for EXCLUDE values.
• mmddyy — The STARTDATE and ENDDATE parameters may be optionally specified. These optional keywords indicate the dates against which entity name occurrences are compared for the purpose of audit selection. Any entity that was added to the dictionary prior to the STARTDATE specified is not included in the audit. Any entity that was added to the dictionary after the ENDDATE is not included in the audit.

   * $$ JOB JNM=ESXAUDIT
   // JOB ESXAUDIT
   *
   // OPTION NODUMP
   // UPSI   a
   // ASSGN  SYS009,IGN
   *
   *  *** CORE IMAGE LIBRARY FOR PRODUCT
   // DLBL   dbms,'your.corelib'
   // EXTENT ,volserc
   // LIBDEF PHASE,SEARCH=(dbms.sublibrary,idms.sublibrary),TEMP
   *
   *  *** INPUT - SYNTAX
   // ASSGN  SYSIPT,SYSRDR
   *
   *  *** OUTPUT - AUDIT REPORT FILE
   // ASSGN  SYS011,SYSLST
   *
   *  *** PERFORM PASSIVE ENFORCEMENT
   // DLBL SYSIDMS,'#SYSIPT',0,SD
   // EXEC   ESXBDIC,SIZE=(ESXBDIC,400K)
   *
   *  Rnn.n OPTIONAL SYSIDMS PARAMETERS
   /*
    PROCESS,
      DICTIONARY=dictionary-name,
      NODE=node-name,
      TERSE
    SELECT=(select-values)
    EXCLUDE=(exclude-values)
    STARTDATE=mmddyy
    ENDDATE=mmddyy
   /*
   /*
   * $$ EOJ
  

Exhibit 4.14: Model Z/VSE JCL (ESXAUDIT.S)

Key to Variables

• a — The UPSI switch to be replaced with specifications from the IDMSOPTI module.
• ca or ca.sublibrary — The file name of the core image library into which the executable phases of CA IDMS Enforcer were installed.
• your.corelib — The name of the core image library into which the executable phases of CA IDMS Enforcer were installed.
• volser — The volume serial number or generic assignment of the disk volume on which the library, as specified in the previous statement, resides. The following letters identify the type of library or installation media: c=core image library, w=work file, r=relocatable library and s=source statement library.
• idms or idms.sublibrary — The file name of the core image library into which the executable phases of CA IDMS were installed.
• dictionary-name — The name of the alternate dictionary specified for this utility function.
• node-name — The name of the node specified for this utility function.
• select-value(s) — The entity-type name(s) selected for audit. The required keyword, SELECT, provides the entity-types that are selected for audit. Select one or more entity types or specify the ALL parameter on the SELECT statement. Multiple entity names must be encased in parenthesis and separated by commas. See SELECT\EXCLUDE Table for SELECT values.
• exclude-value(s) — Optional keyword EXCLUDE enables you to limit the entity selections made with the SELECT parameter. Multiple entity types specified must be encased in parenthesis and separated by commas. See SELECT\EXCLUDE Table for EXCLUDE values.
• mmddyy — The STARTDATE and ENDDATE parameters may be optionally specified. These optional keywords indicate the dates against which entity name occurrences are compared for the purpose of audit selection. Any entity that was added to the dictionary prior to the STARTDATE specified is not included in the audit. Any entity that was added to the dictionary after the ENDDATE is not included in the audit.

   /*  */
   TRACE OFF; SIGNAL ON ERROR
   CA_LOADLIB_FN      = 'yourlib'
   IDMS_LOADLIB_FN    = 'idmslib'
   IDMS_TXTLIB_FN     = 'txtlib'
   /*                                                                   */
   /* Link and access the Minidisks containing the required librarie(s) */
   'GLOBAL TXTLIB  IDMS_TXTLIB_FN'
   'GLOBAL LOADLIB CA_LOADLIB_FN IDMS_LOADLIB_FN'
   'CP SPOOL PRINTER NOCONT CLOSE'
   'CP SPOOL PRINTER TO * NOHOLD CONT FORM OFF DIST OFF'
   /*                                                                   */
   /* Create the input parameter file.                                  */
    CALL CREATE_INPUT_PARM_FILE
   /*                                                                   */
   /* Product specific files.                                           */
   'FILEDEF  SYSLST   PRINTER'
   'FILEDEF  SYSIPT   DISK ESXAUDIT SYSIPT A'
   /* You must create a file 'SYSIDMS INPUT A' containing the SYSIDMS   */
   /* parameters you use to specify your runtime environment.           */
   'FILEDEF  SYSIDMS  DISK SYSIDMS INPUT A'
   SIGNAL OFF ERROR
   SAY 'STARTING RUN OF CA IDMS/DICTIONARY AUDIT UTILITY'
   'EXECOS OSRUN ESXBDIC'
   ESXBDIC_RC = RC
   'CP SPOOL PRINTER NOCONT'
   'CP CLOSE PRINTER NAME ESXAUDIT LISTING'
   'CP SPOOL PRINTER OFF'
   SAY 'DICTIONARY AUDIT FINISHED WITH A RETURN CODE OF ' ESXBDIC_RC
   'GLOBAL LOADLIB'
   'GLOBAL TXTLIB'
   'FILEDEF * CLEAR'
   EXIT ESXBDIC_RC
  

   /*++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ */
   CREATE_INPUT_PARM_FILE:
   /*++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ */
   SIGNAL OFF ERROR
   'ERASE ESXAUDIT SYSIPT A'
   /*                                                                   */
    PUSH 'FFILE'
    PUSH
    PUSH 'EXCLUDE=(exclude-values)'
    PUSH 'ENDDATE=mmddyy'
    PUSH 'STARTDATE=mmddyy'
    PUSH 'SELECT=(select-values)'
    PUSH 'TERSE'
    PUSH 'NODE=node-name,'
    PUSH 'DICTIONARY=dictionary-name,'
    PUSH 'PROCESS,'
    PUSH 'INPUT'
    PUSH 'SET LRECL 80'
    PUSH 'SET RECFM F'
    'XEDIT ESXAUDIT SYSIPT A' ,
     '(NOPROFILE NOSCREEN NOMSG'
   RETURN
   /*++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ */
   ERROR:
   /*++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ */
   ERROR_RC = RC
   TRACE OFF; SIGNAL OFF ERROR
   SAY 'NON-ZERO RETURN CODE ENCOUNTERED IN EXEC AT LINE' SIGL
   'CP SPOOL PRINTER NOCONT'
   'CP CLOSE PRINTER NAME ESXAUDIT LISTING'
   'CP SPOOL PRINTER OFF'
   'GLOBAL LOADLIB'
   'FILEDEF * CLEAR'
   EXIT ERROR_RC
  

Exhibit 4.15: Model Z/VM EXEC--ESXAUDIT

Key to Variables

• yourlib — The file name of the load library into which you downloaded CA IDMS Enforcer.
• idmslib — The file name of the load library containing your CA IDMS SUBSCHEMA and DMCL modules.
• txtlib — The name of the text library containing your CA IDMS text files.
• dictionary-name — The name of the alternate dictionary specified for download.
• node-name — The name of the node specified for download.
• exclude-values — Any of the CA IDMS Enforcer entity types.
• select-values — Any of the CA IDMS Enforcer entity types.
• mmddyy — Used to limit validation to entities added on or after this date.