Chapter Contents

Previous

Next
Command Directory

system (CMS)

Execute a CMS Command

ABBREVIATION
sy{stem}

FORMAT
system OPERATING-SYSTEM-COMMAND

DESCRIPTION
The system command sends the CMS command specified in the argument OPERATING-SYSTEM-COMMAND to the operating system. Using the debugger system command is equivalent to calling the system function from within a program.

The system command cannot be followed by another debugger command on the same line. That is, the arguments to the system command are assumed to extend to the end of the line, including any semicolons on the line. The screen is refreshed after completion of execution of the system command.

EXAMPLE

system filelist
invokes the CMS FILELIST command.

SYSTEM DEPENDENCIES
See the discussion of this command for TSO if you are running the debugger under TSO.

Note:    Some CMS commands, such as HELP and XEDIT, can cause storage allocated by the GETMAIN macro to be freed. If the program being debugged allocates storage by means of GETMAIN, do not invoke these commands. C programs do not use GETMAIN to allocate storage, so you can safely invoke these commands if your program is written entirely in C.  [cautionend]

COMMAND CAN BE ISSUED FROM

PROFILE yes
configuration file no
Source window prefix none

SCOPE
The system command is not affected by changes in scope.

RETURN CODES SET:
Successful: 0
Unsuccessful: return code from system

SEE ALSO
exec (CMS) (CMS version)


Chapter Contents

Previous

Next

Top of Page

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