EVORXCON - Issue Console Command - ironstream_for_micro_focus_universal_discovery - 7.4

Name

Details

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.)

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