Chapter Contents

Previous

Next
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

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.