CICS Requirements - ironstream_for_servicenow_discovery_1 - 7.5

Ironstream™ Software for ServiceNow® Discovery for IBM Z® Installation

Product type
Software
Portfolio
Integrate
Product family
Ironstream™ software
Product
Ironstream™ software > Ironstream™ software for ServiceNow® Discovery
Version
7.5
ft:locale
en-US
Product name
Ironstream™ Software for ServiceNow® Discovery for IBM Z®
ft:title
Ironstream™ Software for ServiceNow® Discovery for IBM Z® Installation
First publish date
2007
ft:lastEdition
2026-02-03
ft:lastPublication
2026-02-03T14:17:18.347000
L1_Product_Gateway
Integrate
L2_Product_Segment
Data Integration
L3_Product_Brand
Precisely Ironstream
L4_Investment_Segment
Log Data Integration
L5_Product_Group
LDI - Ironstream
L6_Product_Name
Ironstream for ServiceNow

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.