ibm-information-center/dist/eclipse/plugins/i5OS.ic.rbam6_5.4.0.1/proxycmds.htm

77 lines
5.1 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="concept" />
<meta name="DC.Title" content="Proxy commands" />
<meta name="abstract" content="Use proxy commands to create shortcuts to target commands." />
<meta name="description" content="Use proxy commands to create shortcuts to target commands." />
<meta name="DC.Relation" scheme="URI" content="cmdinfodoc.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/crtprxcmd.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/chgprxcmd.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/dltcmd.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="proxycmds" />
<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>Proxy commands</title>
</head>
<body id="proxycmds"><a name="proxycmds"><!-- --></a>
<img src="./delta.gif" alt="Start of change" /><!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Proxy commands</h1>
<div><p>Use proxy commands to create shortcuts to target commands.</p>
<p>A proxy command differs from a typical i5/OS™ command in its ability to run a target
command, rather than a command processing program. </p>
<p>Use the <span class="cmdname">Create Proxy Command (CRTPRXCMD)</span> to create a
proxy command. <span class="cmdname">Create Proxy Command (CRTPRXCMD)</span> requires
a <span class="cmdname">Command name (CMD)</span> and a <span class="cmdname">Target command (TGTCMD)</span>.
Optional parameters include a Text description (TEXT), Authority (AUT) and
a Replace command (REPLACE) option. For example, to create a proxy command
that has a target command of QSYS/DSPJOB, enter the following command: </p>
<p><samp class="codeph">CRTPRXCMD CMD(MYLIB/PCMD1) TGTCMD(QSYS/DSPJOB) TEXT(dspjob proxy)</samp></p>
<p> Specifying a proxy command for the TGTCMD parameter is allowed. A proxy
“chain” can be up to 5 proxy commands in length, ending with a 6th non-proxy
command. Running a proxy command with a chain of more than 5 proxy commands
will cause a CPD0196 error “Number of chained proxy commands exceeds 5.”</p>
<p>When you create a proxy command, you do not specify command definition
source. A proxy command does not contain any parameter information, prompt
control information, or interparameter dependency information. When a proxy
command is used, all of that information is inherited from the target command
defined in the proxy command. You specify all the same parameters for the
proxy command that you would for the target command.</p>
<p>Use the <span class="cmdname">Change Proxy Command (CHGPRXCMD)</span> command, to
change a proxy command. Use the <span class="cmdname">Delete Command (DLTCMD)</span> command
to delete a proxy command.</p>
<p>To run or process a command that is “resolved to” via a proxy chain, the
user must have the correct authority for that command and library, as well
as *USE authority for each of the proxy commands (and libraries) in the chain.</p>
<p>Since proxy commands run other commands, attempting to register an exit
program for a proxy command is not allowed, and will cause the error message
CPF019A to be issued. When a proxy command is run, and the non-proxy command
that it resolves to has a registered exit program, the proxy chain that was
followed will be placed in the RTVC0100 and/or CHGC0100 returned format data.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="cmdinfodoc.htm" title="This describes how you can define your own commands and provide documentation for them.">Define and document commands</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../cl/crtprxcmd.htm">Create Proxy Command (CRTPRXCMD) command</a></div>
<div><a href="../cl/chgprxcmd.htm">Change Proxy Command (CHGPRXCMD) command</a></div>
<div><a href="../cl/dltcmd.htm">Delete Command (DLTCMD) command</a></div>
</div>
</div>
<img src="./deltaend.gif" alt="End of change" /></body>
</html>