EVORXCON - Issue Console Command - ironstream_for_micro_focus_universal_discovery - 7.4

Ironstream for Micro Focus® Universal Discovery for IBM Z® Administration

Product type
Software
Portfolio
Integrate
Product family
Ironstream
Product
Ironstream > Ironstream for Micro Focus® Universal Discovery
Version
7.4
Language
English
Product name
Ironstream for Micro Focus Universal Discovery for IBM Z
Title
Ironstream for Micro Focus® Universal Discovery for IBM Z® Administration
Copyright
2022
First publish date
2007
ft:lastEdition
2023-08-23
ft:lastPublication
2023-08-23T16:22:42.216801

Name

Details

Description

The EVORXCON command is used to establish an extended console session using MVS console services. This session allows you to enter MVS system commands (or subsystem commands) from the REXX program.

Syntax

EVORXCON('cmd','var'[,'HC'][,'consname'][,'NR'][,'MAXSIZE=max'][,'RCA'])

where:

command An MVS console command

returnmsg A 1 to 17 character variable name that will be used as a compound variable containing any response message(s) to the command

'HC' ”Hard Copy”: An optional third parameter which will cause the MVS command and response to be written to the hardcopy log.

consname An optional name to be used when initializing the extended console. The name must be 1-8 uppercase alphanumeric characters. If no name is given or an invalid name is specified, the name is set to the default name of "EVORXCON". If this parameter is to be specified, then the third parameter must also be specified, even if only with a null value (two consecutive commas). See the second example below.

'NR' ”No Response”: An optional parameter which will cause the EVORXCON to return without waiting for any response message(s) from the command.

'MAXSIZE=max' An optional parameter to define the maximum memory size (in bytes) to be allocated to hold the command's response messages. If not specified, the default memory allocation is 56 Kbytes.

'RCA' ”Route Codes All”: An optional parameter which specifies that the messages making up the response can accept all MVS route codes. If not specified, command responses are, by default, expected to have no route codes. (Note that using this option may result in receiving message responses that are not associated with the original command if other messages with route codes are generated at the same time that the command is being processed. This option is primarily intended to be used for receiving responses to a WTOR reply.)

Return Value

A variable can be assigned to the command to hold one of the return text: OK - The command completed

REXX

Example

Issue the "D A,L" command to display the names of all active address spaces on the mainframe. The response lines are printed by reading the RMSG compound variable.

/*REXX*/

x = EVORXCON('D A,L','RMSG')

if x = 'OK' then do

do i = 1 to RMSG.0 say RMSG.i

end end

exit

Issue the "D R,U" command to display the devices that require operator intervention. The response lines are printed by reading the RMSG compound variable. Use the console name "REXXCON", and do not display the command/response on the hardcopy log.

/*REXX*/

x = EVORXCON('D R,U','RMSG',,'REXXCON')

if x = 'OK' then do

do i = 1 to RMSG.0 say RMSG.i

end end

exit