02.05.2013 Views

SAS(R) 9.1.3 Companion for z/OS

SAS(R) 9.1.3 Companion for z/OS

SAS(R) 9.1.3 Companion for z/OS

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

248 CALL SYSTEM Routine Chapter 13<br />

Details<br />

CALL SLEEP puts the DATA step in which it is invoked into a nonactive wait state,<br />

using no CPU time and per<strong>for</strong>ming no input or output. If you are running multiple <strong>SAS</strong><br />

tasks, each task can execute CALL SLEEP independently without affecting the other<br />

tasks.<br />

CALL SYSTEM Routine<br />

R<br />

Note:<br />

3 In batch mode, extended sleep periods can trigger automatic host session<br />

termination based on timeout values set at your site. Contact your host system<br />

administrator as necessary to determine the timeout values used at your site.<br />

3 If you are running the asynchronous RSUBMIT statement in a <strong>SAS</strong>/CONNECT<br />

session, specifying CALL SLEEP <strong>for</strong> a DATA step affects only that DATA step. It<br />

does not affect any other <strong>SAS</strong> tasks that you are running on the remote system.<br />

Submits an operating system command <strong>for</strong> execution<br />

Category: Special<br />

z/<strong>OS</strong> specifics: all<br />

See: CALL SYSTEM Routine in <strong>SAS</strong> Language Reference: Dictionary<br />

Syntax<br />

CALL SYSTEM(command);<br />

command<br />

can be a system command enclosed in quotation marks, an expression whose value is<br />

a system command, or the name of a character variable whose value is a system<br />

command. Under z/<strong>OS</strong>, "system command" includes TSO commands, CLISTs, and<br />

REXX execs.<br />

Details<br />

The CALL SYSTEM routine is similar to the X (or TSO) statement, the X (or TSO)<br />

command, the SYSTEM (or TSO) function, and the %SYSEXEC (or %TSO) macro<br />

statement.<br />

In most cases, the X statement, the X command, or the %SYSEXEC macro statement<br />

are preferable because they require less overhead. However, the CALL SYSTEM<br />

routine can be useful in certain situations because it is executable and because it<br />

accepts expressions as arguments. For example, the following DATA step executes one<br />

of three CLISTs depending on the value of a variable named ACTION that is stored in<br />

an external file named USERID.TRANS.PROG:<br />

data _null_;<br />

infile ’userid.trans.prog’;<br />

/* action is assumed to have a value of */

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!