68 lines
5.2 KiB
HTML
68 lines
5.2 KiB
HTML
|
<?xml version="1.0" encoding="UTF-8"?>
|
||
|
|
<!DOCTYPE html
|
||
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
|
<html lang="en-us" xml:lang="en-us">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="security" content="public" />
|
||
|
|
<meta name="Robots" content="index,follow" />
|
||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
|
|
<meta name="DC.Type" content="task" />
|
||
|
|
<meta name="DC.Title" content="Use the CALL command" />
|
||
|
|
<meta name="abstract" content="The Call Program (CALL) command calls a program named on the command, and passes control to it." />
|
||
|
|
<meta name="description" content="The Call Program (CALL) command calls a program named on the command, and passes control to it." />
|
||
|
|
<meta name="DC.subject" content="CALL (Call Program) command, description, Call Program (CALL) command, command, CL, CALL (Call Program), Call Program (CALL), program, calling, calling program, CALL command description, program flow, example, CALL command, passing, control to program, call stack, relationship to CALL command, stack, call, removing call, stack, call" />
|
||
|
|
<meta name="keywords" content="CALL (Call Program) command, description, Call Program (CALL) command, command, CL, CALL (Call Program), Call Program (CALL), program, calling, calling program, CALL command description, program flow, example, CALL command, passing, control to program, call stack, relationship to CALL command, stack, call, removing call, stack, call" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="passc.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/call.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="passp.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="ucall.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="callc" />
|
||
|
|
<meta name="DC.Language" content="en-us" />
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
|
|
<title>Use the CALL command</title>
|
||
|
|
</head>
|
||
|
|
<body id="callc"><a name="callc"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Use the CALL command</h1>
|
||
|
|
<div><p>The <span class="cmdname">Call Program (CALL)</span> command calls a program
|
||
|
|
named on the command, and passes control to it. </p>
|
||
|
|
<div class="section"> <p> The CALL command has the following format: </p>
|
||
|
|
<pre>CALL PGM(library-name/program-name) PARM(parameter-values)</pre>
|
||
|
|
<p>The program name or library name may be a variable. If the
|
||
|
|
called program is in a library that is not on the library list, you must specify
|
||
|
|
the qualified name of the program on the PGM parameter. When the called program
|
||
|
|
finishes running, control returns to the next command in the calling program.</p>
|
||
|
|
<br /><img src="rbafn555.gif" alt="The program name or library name may be a variable. If the called program is in a library that is not on the library list, you must specify the qualified name of the program on the PGM parameter. When the called program finishes running, control returns to the next command in the calling program." /><br /><p>The sequence of CALL commands
|
||
|
|
in a set of programs calling each other is the call stack. For example, look
|
||
|
|
at this series: <br /><img src="rbafn556.gif" alt="The sequence of CALL commands in a set of programs calling each other is the call stack example." /><br />In this series, the call stack
|
||
|
|
is as follows:</p>
|
||
|
|
<br /><img src="rbafn530.gif" alt="Call stack example." /><br /><p>When PROGC finishes processing, control returns
|
||
|
|
to PROGB at the command after the call to PROGC. Control is thus returned
|
||
|
|
up the call stack. This occurs whether or not PROGC ends with a RETURN or
|
||
|
|
an ENDPGM command.</p>
|
||
|
|
<p>A CL program can call itself.</p>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="passc.htm" title="This presents different options for passing control to a procedure.">Pass control</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="reltasks"><strong>Related tasks</strong><br />
|
||
|
|
<div><a href="passp.htm" title="When you pass control to another program or procedure, you can also pass information to it for modification or use within the receiving program or procedure.">Pass parameters</a></div>
|
||
|
|
<div><a href="ucall.htm" title="When the CALL command is issued by a CL procedure, each parameter value passed to the called program can be a character string constant, a numeric constant, a logical constant, or a CL variable.">CALL command</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
||
|
|
<div><a href="../cl/call.htm">Call (CALL) command</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|