SAS/C Software: Changes and Enhancements, Release 6.50

rsystem Command

The SAS/C Debugger's rsystem command is intended for use with the remote debugger. It is similar to the system command described in the SAS/C Debugger User's Guide and Reference, Third Edition, but allows you to execute an operating system command in the environment of the program being debugged.

The following reference section describes the rsystem command.

rsystem

Execute an Operating System Command on a Remote System

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 the discussion of the system command in SAS/C Debugger User's Guide and Reference, Fourth Edition if the remote program is running under TSO or CMS. Command output, if any, generally appears in the remote program's session or log.

rsystem cannot be used when the remote program is executing under OpenEdition 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.

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;