AppendCPCommandOutput (Stringlist function): Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
m (→Syntax terms) |
||
| Line 6: | Line 6: | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>%rc</th><td> | <tr><th>%rc</th><td>The return code from the issued CP command.</td></tr> | ||
<tr><th>sl</th> | <tr><th>sl</th> | ||
<td>Stringlist | <td>Stringlist to receive output from the CP command.</td></tr> | ||
<tr><th>command</th> | <tr><th>command</th> | ||
<td> | <td>The CP command to be issued.</td></tr> | ||
<tr><th><var>BufferSize</var></th> | <tr><th><var>BufferSize</var></th> | ||
<td> | <td>The size of the virtual storage buffer to hold the result of the CP command. AppendCpCommandOutput uses Diagnose X'08' to issue the CP command and Diagnose X'08' requires that the output from the command go to a single contiguous output buffer. This buffer is only used as a staging area to hold the command output until it is moved to the output stringlist.</td></tr> | ||
</table> | </table> | ||
==Usage notes== | ==Usage notes== | ||
==Examples== | ==Examples== | ||
==See also== | ==See also== | ||
{{Template:Stringlist:AppendCPCommandOutput footer}} | {{Template:Stringlist:AppendCPCommandOutput footer}} | ||
Revision as of 12:38, 21 September 2011
Add output from CP command to Stringlist (Stringlist class)
[Introduced in Sirius Mods 7.9]
This callable method invokes a CP command in the Online's virtual machine and adds the output from that command to a Stringlist. The AppendCPCommand method accepts one or more arguments and returns a numeric result. Since CP commands are only available in a CMS environment, this method is useless when running under z/OS (MVS) or VSE and will result in request cancellation if invoked under those operating systems.
Syntax
[%rc =] sl:AppendCPCommandOutput( command, [BufferSize= number])
Syntax terms
| %rc | The return code from the issued CP command. |
|---|---|
| sl | Stringlist to receive output from the CP command. |
| command | The CP command to be issued. |
| BufferSize | The size of the virtual storage buffer to hold the result of the CP command. AppendCpCommandOutput uses Diagnose X'08' to issue the CP command and Diagnose X'08' requires that the output from the command go to a single contiguous output buffer. This buffer is only used as a staging area to hold the command output until it is moved to the output stringlist. |