ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/chgsrvpvda.htm

312 lines
9.8 KiB
HTML

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Change Service Provider Attr (CHGSRVPVDA)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="CHGSRVPVDA.Top_Of_Page"></a>
<h2>Change Service Provider Attr (CHGSRVPVDA)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#CHGSRVPVDA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGSRVPVDA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGSRVPVDA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGSRVPVDA"></a>
<p>The Change Service Provider Attributes (CHGSRVPVDA) command displays and changes the configuration attributes of the service provider.
</p>
<p><b>Restriction:</b> This command is shipped with public *EXCLUDE authority and the QSRV and QSRVBAS user profile have private authority to use the command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVPVDA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGSRVPVDA.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVPVDA.LOGRMTPRB"><b>LOGRMTPRB</b></a></td>
<td valign="top">Log remote problems</td>
<td valign="top"><b><u>*SAME</u></b>, *NONE, *SRVRQS, *ALERT, *ALL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVPVDA.SNDPTFAUTO"><b>SNDPTFAUTO</b></a></td>
<td valign="top">Send PTFs automatically</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGSRVPVDA.MSGQ"><b>MSGQ</b></a></td>
<td valign="top">Message queue</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Message queue</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CHGSRVPVDA.MAXDST"><b>MAXDST</b></a></td>
<td valign="top">Maximum distribution</td>
<td valign="top">1-5000, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVPVDA.HLDPTF"><b>HLDPTF</b></a></td>
<td valign="top">Hold PTFs received</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVPVDA.CVRLTRLNG"><b>CVRLTRLNG</b></a></td>
<td valign="top">Cover letter language</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVPVDA.FWDRQSAUTO"><b>FWDRQSAUTO</b></a></td>
<td valign="top">Forward requests automatically</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVPVDA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGSRVPVDA.LOGRMTPRB"></a>
<h3>Log remote problems (LOGRMTPRB)</h3>
<p>Specifies when remote problem log entries are created.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>Problem log entries are not created when service requests or alerts are received.
</dd>
<dt><b>*SRVRQS</b></dt>
<dd>A problem log entry is created when a service request is received.
</dd>
<dt><b>*ALERT</b></dt>
<dd>A problem log entry is created when a remote alert is received.
</dd>
<dt><b>*ALL</b></dt>
<dd>A problem log entry is created when an alert, service request, or both are received from a managed system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVPVDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVPVDA.SNDPTFAUTO"></a>
<h3>Send PTFs automatically (SNDPTFAUTO)</h3>
<p>Specifies that program temporary fixes (PTFs) are sent automatically in response to a PTF order or service request.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NO</b></dt>
<dd>A response to a PTF or service request is not automatically sent.
</dd>
<dt><b>*YES</b></dt>
<dd>A response to a PTF or service request is automatically sent.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVPVDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVPVDA.MSGQ"></a>
<h3>Message queue (MSGQ)</h3>
<p>Specifies the name of the message queue to which messages are sent.
</p>
<p>The possible value is:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<p>The name of the message queue can be qualified by one of the following library values:
</p>
<dl>
<dt><b>*LIBL</b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is searched. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
<p>The possible value message queue name is:
</p>
<dl>
<dt><b><i>message-queue-name</i></b></dt>
<dd>Specify the name of the message queue being changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVPVDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVPVDA.MAXDST"></a>
<h3>Maximum distribution (MAXDST)</h3>
<p>Specifies the maximum number of kilobytes (KB) that can be used for each Program Temporary Fix (PTF) order or service request that receives a response. You can specify a maximum of 5000 KB.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of KB does not change.
</dd>
<dt><b>*NOMAX</b></dt>
<dd>Any number of kilobytes can be transmitted.
</dd>
<dt><b><i>maximum-number-of-kilobytes</i></b></dt>
<dd>Specify the maximum number of KB for PTFs to be sent. Valid values range from 1 through 5000.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVPVDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVPVDA.HLDPTF"></a>
<h3>Hold PTFs received (HLDPTF)</h3>
<p>Specifies that PTFs that are received are marked as held or are available for distribution.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NO</b></dt>
<dd>PTFs that are received are not held and are available for distribution.
</dd>
<dt><b>*YES</b></dt>
<dd>PTFs are held, and are not available for distribution.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVPVDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVPVDA.CVRLTRLNG"></a>
<h3>Cover letter language (CVRLTRLNG)</h3>
<p>Specifies the cover letter language to be used.
</p>
<p>The possible value is:
</p>
<dl>
<dt><b><i>cover-letter-language</i></b></dt>
<dd>Specify the cover letter language to be sent or retrieved with a PTF.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVPVDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVPVDA.FWDRQSAUTO"></a>
<h3>Forward requests automatically (FWDRQSAUTO)</h3>
<p>Specifies whether requests should be automatically forwarded to the next service provider.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The decision to forward requests automatically does not change.
</dd>
<dt><b>*NO</b></dt>
<dd>Requests are not forwarded. They are handled at this service provider.
</dd>
<dt><b>*YES</b></dt>
<dd>Requests are forwarded. They are handled at the next service provider.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVPVDA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGSRVPVDA.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Creating Remote Log Entries</b>
</p>
<p>
<pre>
CHGSRVPVDA LOGRMTPRB(*ALERT)
</pre>
</p>
<p>This command creates remote problem log entries when alerts are received.
</p>
<p><b>Example 2: Directing Messages to Another Queue</b>
</p>
<p>
<pre>
CHGSRVPVDA MSGQ(USERLIB/MSGQ)
</pre>
</p>
<p>This command directs all messages created on the service provider, as a result of receiving alert messages or service requests, to the message queue named MSGQ in the library named USERLIB.
</p>
<p><b>Example 3: Holding PTFs</b>
</p>
<p>
<pre>
CHGSRVPVDA HLDPTF(*YES)
</pre>
</p>
<p>This command specifies that all PTFs received through electronic customer support or from distribution media are to be held. They are not available for distribution. You can specify the RLSPTF command to release a PTF for distribution.
</p>
<p><b>Example 4: Specifying Maximum Size for Distribution</b>
</p>
<p>
<pre>
CHGSRVPVDA MAXDST(1000)
</pre>
</p>
<p>This command specifies that PTFs can have a maximum size of only 1000 bytes for distribution through electronic customer support.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVPVDA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGSRVPVDA.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVPVDA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>