The Mainframe Discovery Adapter utilizes the Ironstream Proxy Server interface to communicate requests to the Ironstream agent on the z/OS systems. This interface provides the capability to request the agent to execute z/OS console commands, subsystem commands, reply to outstanding WTORs, execute REXX programs and requests other information via the Ironstream mainframe agent.
The ev390hostcmd is the interface to the Proxy Server for executing mainframe commands, subsystem commands, REXX programs or requesting information via the Discovery agent.
The format of ev390hostcmd is:
ev390hostcmd <type> <command>.<zOS_system_name>
where:
<type>
|
Specifies a code to direct where the command should be executed on the mainframe. Three codes are valid:
40 = z/OS (MVS) commands. The command is sent to a MCS console defined for VP390 on the mainframe. The VP390 mainframe job must have a CMD subtask defined.
45 = z/OS (MVS) commands that do not return a response. This is the same as a Type 40 code, except the ev390hostcmd does not wait for a response message with this option.
46 = z/OS system information commands. The command instructs the VP390 mainframe task to gather specific z/OS system information such as CPU usage or JES2 job queue contents. See section Clearing Mainframe CMDB tables.
|
<command>
|
The command text, syntax dependent on the type. The first period (.) encountered is used to mark the end of the command. If the command text has a period in it, enter two periods to signify that it is not the end of the command. See the example below. |
<zOS_system>
|
The z/OS system on which the command is to be executed. Use the IP address or name of the mainframe domain. This must match the details for the z/OS system that was configured in the Ironstream Configuration Tool. |
|
|
Examples:
- Send a command to z/OS system with the DNS name myhost.mysite.com to display the system time:
ev390hostcmd 40 D T.myhost.mysite.com
- Send a command to the z/OS system named myhost.mysite.com to start a job named MYJOB with a job identifier of MYIDENT
Note: The period between MYJOB and MYIDENT must be doubled to signify that it is not the end of the command:
ev390hostcmd 45 S MYJOB..MYIDENT.myhost.mysite.com
|