Discovery Data Flow - ironstream_for_servicenow_discovery_1 - 7.5
Ironstream for ServiceNow® Discovery for IBM Z® Administration
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® Administration
First publish date
2007
Last updated
2024-11-18
Published on
2024-11-18T05:02:12.928000
Ironstream for ServiceNow Discovery for IBM Z
Ironstream Overview
Architecture and Data Flow
Ironstream Mainframe Agent
Agent Main Task
Agent Subtasks
Types of Subtask Queues
TCP Subtask
CMD Subtask
SPO Subtask
OSINFO Subtask
SMF Subtask
Subtask Restart Function
Ironstream Proxy Server
Ironstream Proxy Server
Proxy Server Components
Adding a Mainframe to the Ironstream Proxy and ServiceNow
Mainframe Discovery Probes and Sensors
Discovery Data Flow
Data Input Mechanism
Discovery Probes
Configuring Ironstream
Phase 1: Configuring the Ironstream Mainframe Agent
Phase 2: Adding z/OS Systems to the Ironstream Configuration Tool
Additional Configuration Changes
Renamed Ironstream Agent Job
Customizing Script Timeout Values
Configuring CICS
Populating the Company field
Phase 3: Testing Discovery
Phase 4: Configure Ironstream Discovery probes
Organization of Ironstream Discovery Probes
Process Classifications
Configure and Customize Ironstream Discovery Probes
Important Notes About Running Ironstream Discovery:
Discovering Active Software Products and Updating the Mainframe Software User Catalog
Discover z/OS Jobs
Discovering CICS Programs
Discovering IMS CIs
Running Ironstream Discovery
Using ServiceNow Discovery Schedules
Using Scheduled Jobs
When the Discovery is Complete
Administering ServiceNow CIs
Clearing Mainframe CMDB tables
Sending Commands to the Agent
Using OSINFO System Information API Commands
Using OSINFO System Information API Commands
01 DASD Utilization Statistics
02 RMF Address Space Resource Statistics
03 Current CPU Snapshot for System and Specific Address Space
04 Current Active Jobs
05 System Statistics from RMF
06 JES2 Input Queue
07 JES2 Output Queue
08 JES2 Held Queue
10 Dataset Display
11 APF Dataset List
12 Execute REXX Program
20 Machine Type and LPAR Capacity
40 Active Jobs and Program Name
41 Display IMS Subsystem Name
42 Display Program Name and PARM Value
43 Display DDNames of Job
44 Display CICS Group Lists
50 Execute MQ Series Command
60 Display TCP/IP Connections
61 Display Network Interfaces
110 TSO-Generated Netstat Connections
111 TSO-Generated Netstat Home Addresses
112 TSO-Generated Netstat Routing Table
113 TSO-Generated Netstat ARP Cache
114 TSO-Generated Netstat Device Links
REXX Functions Provided by Ironstream
EVORXALO - Allocate/Concatenate DD Names
EVORXCON - Issue Console Command
EVORXDIR - Read PDS Directory
EVORXFRE - Free Allocated DDs
EVORXGET - Read a PDS Member
EVORXINT - Allocate an Internal Reader (INTRDR)
EVORXSYS - Display Users of Highest System Resources
EVORXWAT - Wait/Sleep
EVORXWTO - Issue a Write to Operator (WTO)
Troubleshooting
General Troubleshooting
Ironstream Proxy Server ev390mcs (Windows)
Ironstream Mainframe Agent
Subtasks
Specific Troubleshooting
Failure of the Discovery Jobs
TCP/IP Connection Problems
CICSPLEX Discovery
SMS Managed APF Datasets
LPAR/CPC Discovery
Logging in Ironstream
Diagnosing Issues
No Discovery Results
Appendix A: z/OS Console Commands
z/OS Console Commands
SHOW Commands
SHOW Task
SHOW ADDR
SHOW VERSION
SHOW FLOW
SHOW SUPPRESS
Subtask Control Commands
INIT
KILL
TERM
FILTER Commands
SHOW FILTER
FILTER ADD
FILTER DEL
Appendix B: VP390 Mainframe Messages
EVO001 Load library must be APF authorized, job terminating
EVO002 Type Subtask Initialized for Feature
EVO007 Invalid Size of Parameter 'parm' on Line Number
EVO008 Invalid Input Parameter Card on Line Number
EVO009 Duplicate Subtask Card on Line Number Ignored
EVO010 Maximum Number of Subtask Cards Reached; Ignoring Line Number
EVO011 Maximum Number of Type Filter Entries Reached; New Entry Ignored
EVO012 Unable to Allocate Name Filter Table
EVO018 VTAM ACB Generation for Subtask acb Failed, RC = rcnumber
EVO019 VTAM Subtask Open for acb failed, RC = rcnumber, error = enumber
EVO020 Subtask is Currently in Use
EVO021 Unsolicited msgtype Data is Unavailable
EVO026 Unexpected Subtask Return Code, RC = rcnumber
EVO033 VP390 COMMAND = command
EVO034 Initialization of SPO Name Failed in reqtype processing, RC1 = addr RC2 = size
EVO035 SPO Warning: Failure Retrieving Command Responses, Max Retries Reached.
EVO036 SPO Command Queue Depth Exceeded Maximum
EVO038 Subtask Command Support Unavailable
EVO039 Unable to Route Message (type=type)
EVO040 Authorization Lock Timeout for Subtask
EVO091 PPI Initialization Failed, step = stepnum RC = rcnumber
EVO095 VP390 PPI Buffer Size Error, RC = rcnumber
EVO096 VP390 PPI Interface Failed, ID = requestid, RC = rcnumber
EVO119 Count Messages Queued on Subtask. Command rejected: cmd
EVO121 MVS Console Name Could Not Obtain a Migration ID
EVO122 type console name initialization failed, RC = rc,reas
EVO126 Unable to open MSGCATLG message file
EVO127 Too Many Messages in MSGCATLG Message File
EVO128 Unable to find message ID msg in MSGCATLG file
EVO130 Unrecognized Command Option: code
EVO131 Query Failed, Error Code = Code
EVO132 Query Returned No Lines
EVO133 Unable to Collect Queue Queue Data: Error Accessing Source, rc=code
EVO134 Error in function call for value: code
EVO135 Dataset read error: text
EVO136 Command cmd failed because ddname DD not available
EVO137 Rexx Command Error: Error
EVO140 Maximum lines of output exceeded (linecount)
EVO141 Output size exceeded (bytecount)
EVO144 TCP/IP query failed: reason
EVO150 TCP/IP communications: function for workstation component agent failed with errno value
EVO151 VP390 Failure in Communication to TCP/IP
EVO152 Default TCP/IP Function Failed
EVO153 Message Length Exceeds Send Buffer Allocation
EVO154 Server Server Connection Lost on Port Number
EVO155 Server Server Connection Established on Port Number
EVO156 Invalid Connection Attempt from Different Servers
EVO157 Unable to Convert Segment Text Due to NLS Error
EVO158 Invalid Connection Attempt from address:rport to Port Iport
EVO160 Console Command Return code = rcnumber
EVO161 No Match for Console Command in Command Filter Table
EVO162 No Valid DD Names for Message Logging Subtask
EVO163 Unable to Open Message Logging File ddname
EVO164 Message Logging is Closing Dataset
EVO165 Message Logging is Wrapping to the First File
EVO170 Unable to Open Message Buffering File ddname
EVO178 Unable to Process Compressed CICS SMF record, RC = returncode
EVO181 Exitname Exit Unable to Write SMF Record
EVO205 MVS console name reached memory limit. Data lost
EVO206 MVS Console Name Reached Queue Limit, Data Lost
EVO207 MVS Console Name Stopped by Internal Error
EVO208 MVS Console Name Reached Alert Percentage
EVO209 MVS Console Name Suspended by Request
EVO210 MVS Console Name Alert ECB Posted for Unknown Reason
EVO211 DOM Source Key
EVO214 DOM Flag Updated
EVO215 PERF Parameter Updated
EVO216 SMF Buffer Size Changed from Old to New
EVO217 Debug for Task Changed from Old to New
EVO230 Unable to Initialize RMA Rexx Environment
EVO302 name : VP390 PPI TASK INITIALIZED
EVO303 name : VP390 PPI TASK TERMINATED
EVO304 name : DSIFRE FAILED FOR USER STORAGE
EVO305 name : DSIFRE FAILED FOR QUEUED STORAGE
EVO306 name : DSIFRE FAILED FOR MQS BUFFER
EVO307 name : DSIGET FAILED FOR USER STORAGE
EVO308 name : ENQ ERROR
EVO309 name : DEQ ERROR
EVO310 name : TASK ALREADY EXISTS
EVO311name : LOAD OF CNMNETV COMPLETE
EVO312 name : UNABLE TO LOAD CNMNETV
EVO313 name : NETVIEW INTERFACE FAILURE, RC=rcnumber
EVO314 name : NETVIEW COMMAND RECEIVED
EVO315 autotask COMMAND EXECUTION FAILED
EVO351 region TRANSACTION trans RESPONSE TIME OF used SECS. EXCEEDED THRESHOLD OF thresh SECS
EVO352 NO RESOURCE RECORD
EVO595 Command entered: cmdtxt
EVO600 TNUM TASKNAME STATUS RESTARTS/LIMIT SPECIFIC
EVO603 TNUM TASKNAME ADDRESS HEADER TCB
EVO605 TNUM TASKNAME INPUTQ OUTPUTQ INFLOW OUTFLOW MC
EVO608 TASKNAME DATE TIME
EVO609 type filters:
EVO610 type filter data action
EVO611 type filter data not found
EVO612 No type filters defined
EVO613 All type filters deleted
EVO614 No suppressed messages
EVO615 Suppressed message IDs:
EVO616 action suppression of msgid
EVO617 Message ID msgid not found in suppression table
EVO625 SMF captured types(subtypes):
EVO627 REC=style(types)
EVO628 count SMF record copy failures
EVO690 VP390 STOP Command accepted
EVO695 VP390 cmdtype command processed
EVO698 Subtask task is already status
EVO699 Invalid operator command entered
EVO701 Starting subtask #idnum for info
EVO702 Buffer size = sizeM, Queue depth = totalmsg, Maximum = maxmsg
EVO703 Console name is utilizing pct% of message queue
EVO704 Console name queue backlog has been relieved
EVO778 RMF data not available, rc=code
EVO801I ERROR ACTIVATING CONSOLE
EVO802I ERROR TRYING TO GET A MESSAGE
EVO805I ERROR DEACTIVATING CONSOLE
EVO901 Stopping subtask #number: name
EVO902 name subtask terminated, RC = rcnumber
EVO903 name type queue freed, RC = rcnumber
EVO904 All VP390 subtasks completed
EVO905 Restart #num of subtask name will be attempted in sec seconds
EVO906 No auto restart for name - Use INIT command to restart
Appendix C: CI Identification Rules
CI Identification Rules
Appendix D
Glossary of Terms
Glossary of Locations
Precisely Support
When probes are scheduled to run on the ServiceNow instance they are sent to the MID Server agent.
The probes run commands or scripts that make requests of the Proxy Server to collect data, relevant to the type of discovery being executed by the probe.
The requests
are passed by the Proxy Server to the mainframe agent.
The agent runs the commands on the mainframe.
The results
of the data request are returned to the Proxy Server.
The Proxy Server
passes the results back to the script which sends them back to the ServiceNow
instance. Depending on the probe, the script may perform additional processing with
the data returned from the mainframe.
The
associated sensor parses the output data and creates configuration items and
relationships in the CMDB.