CICS Requirements - ironstream_for_servicenow_discovery_1 - 7.5

Ironstream for ServiceNow® Discovery for IBM Z® Installation

Product type
Software
Portfolio
Integrate
Product family
Ironstream
Product
Ironstream > Ironstream for ServiceNow® Discovery
Version
7.5
Language
English
Product name
Ironstream for ServiceNow® Discovery for IBM Z®
Title
Ironstream for ServiceNow® Discovery for IBM Z® Installation
First publish date
2007
Last updated
2024-08-08
Published on
2024-08-08T06:53:53.282486

General

The command consoles created by the Ironstream agent must be defined to CICS unless auto-install has been configured for EMCS consoles in CICS.

Enter these commands in CICS to define consoles that Ironstream can use to issue commands for information gathering:

CEDA DEF TE(CNxx) GR(EVOGRP) TY(DFHCONS) CONSN(staticname)

CEDA DEF TE(CNyy) GR(EVOGRP) TY(DFHCONS) CONSN(EVRXCNzz)

where:

EVOGRP a group name for Ironstream.
CNxx,CNyy an available terminal name, for example CN10.
staticname the console name of the extended console defined on Ironstream’s CMD parameter card (see CMD Parameter Card definition page 17).
zz the two-character value of the &SYSCLONE. system symbol for this LPAR. The resulting “EVRXCNzz” console will be dynamically created as needed in Rexx programs.

Run the install transactions after defining the consoles.

CEDA INSTALL GR(EVOGRP) TE(CNxx)

CEDA INSTALL GR(EVOGRP) TE(CNyy)

RACF Permissions

Discovery is started for CICS regions by issuing z/OS MODIFY commands to each one. RACF requires a user to have UPDATE authority in order to do this.
Commands Issued RACF General Resource Native or RACF Security Configuration Requirements
CEMT I SYSTEM
CEMT I DBCONN
CEMT I FILE(DFHCSD)

TCICSTRN

GCICSTRN

VCICSCMD

Class = TCICSTRN

Profile = SSID.CEMT with Authority READ

Class = GCICSTRN

Profile = CAT2 with Authority READ

Class = VCICSCMD

Profile = CEMT with Authority READ

Member = INQUIRY

Read access to the CICS System Definition (CSD) dataset.

CICS Transaction and Program Discovery

If CICS Transaction and Program discovery is being performed, the Ironstream discovery agent needs these:

  • Access to two modules in the CICS SDFHLOAD dataset (DFHCSDUP and DFHEITCU). There are three options to provide the agent access to these modules:
    • Add the SDFHLOAD dataset to the Ironstream Discovery agent STEPLIB DD statement. If this option is chosen, then the SDFHLOAD dataset must be APF authorized.
    • Add SDFHLOAD to the LNKLST.
    • Copy members DFHCSDUP and DFHEITCU from the SDFHLOAD dataset to the agent’s ISDE4Z.Vxx.LOAD dataset. This option should only be used if options 1 or 2 are not possible.
  • Scratch datasets CSDIN and CSDOUT must be defined and the SDFHLOAD loadlib must be added to the steplib.

If you do not wish to use the CICS default user, you can assign a user to the terminal that is defined for the agent console. When a terminal is defined as a console to CICS for ServiceNow, there is a field that can be used to specify a userid for security. The field is called PRESET SECURITY. This is where you can specify the userid attribute on the TERMINAL resource definition.

Example:

PRESET SECURITY
    USERid         : CICSUSER
    NAtlang        : E

CICSPlex Discovery

If CICSPlex discovery is being performed, the Ironstream discovery agent needs the SEYUAUTH load library in the STEPLIB DD of its JCL. The SEYUAUTH dataset must be APF authorized.

Note: If CICSPlex discovery is not required then:
  1. SEYUAUTH is also not required.
  2. You should turn off the CICSPlex discovery probe in ServiceNow.