Command Directory

rsystem

Execute an Operating System Command on a Remote System

Note: The SAS/C Debugger's rsystem command is intended for use with the remote debugger. It is similar to the system command described in this chapter, but it allows you to execute an operating system command in the environment of the program being debugged. [cautionend]

ABBREVIATION

rs{ystem}

FORMAT

rsystem OPERATING-SYSTEM-COMMAND

DESCRIPTION

The rsystem command is intended for use with the remote debugger. It sends the command specified in the argument OPERATING-SYSTEM-COMMAND to the environment of the program being debugged. For example, you might use this command to execute a CMS command from TSO when debugging a CMS program from TSO.

The rsystem command cannot be followed by another debugger command on the same line. That is, the arguments to the rsystem command are assumed to extend to the end of the line, including any semicolons on the line.

EXAMPLES

rsystem alloc fi(iforgot) da(to.allocate.this.dataset) shr: executes the TSO ALLOCATE command.
rsystem access 391 Q: executes the CMS ACCESS command.

SYSTEM DEPENDENCIES

See system (CMS) for more information about the system command. Command output, if any, generally appears in the remote program's session or log.

The rsystem command cannot be used when the remote program is executing under UNIX System Services or CICS.

COMMAND CAN BE ISSUED FROM

PROFILE yes

configuration file no

Source window prefix none

SCOPE

The rsystem command is not affected by changes in scope.

RETURN CODES SET

Successful: return code from operating system

Unsuccessful: -101 or less;

-103 means command not found;

-104 means syntax error;

-110 means the command is not supported in the target environment

SEE ALSO

system (CMS)

Chapter Contents
Previous
Next
Top of Page

Successful:	return code from operating system

Unsuccessful:	-101 or less;
	-103 means command not found;
	-104 means syntax error;
	-110 means the command is not supported in the target environment