584 lines
20 KiB
HTML
584 lines
20 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 Directory Shadow System (CHGDIRSHD)</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="CHGDIRSHD.Top_Of_Page"></a>
|
|
<h2>Change Directory Shadow System (CHGDIRSHD)</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="#CHGDIRSHD.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGDIRSHD.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGDIRSHD.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGDIRSHD"></a>
|
|
<p>The Change Directory Shadow System (CHGDIRSHD) command changes a system that is defined to be shadowed.
|
|
</p>
|
|
<p><b>Restriction:</b>
|
|
</p>
|
|
<p>To use this command, you must have security administrator (*SECADM) authority.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGDIRSHD.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="#CHGDIRSHD.SYSNAME"><b>SYSNAME</b></a></td>
|
|
<td valign="top">System name</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Key, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGDIRSHD.NXTSHD"><b>NXTSHD</b></a></td>
|
|
<td valign="top">Next shadow</td>
|
|
<td valign="top">Single values: *CURRENT, *SCD, <b><u>*SAME</u></b><br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Date</td>
|
|
<td valign="top">
|
|
<i>Date</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Time</td>
|
|
<td valign="top">
|
|
<i>Time</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGDIRSHD.SCD"><b>SCD</b></a></td>
|
|
<td valign="top">Scheduled shadow</td>
|
|
<td valign="top">Single values: *CURRENT, <b><u>*SAME</u></b><br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Date</td>
|
|
<td valign="top">
|
|
<i>Date</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Time</td>
|
|
<td valign="top">
|
|
<i>Time</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDIRSHD.FRQ"><b>FRQ</b></a></td>
|
|
<td valign="top">Shadowing frequency</td>
|
|
<td valign="top">*DAILY, *WEEKLY, *BIWEEKLY, *MONTHLY, *MONTHLYREL, *HOURS, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDIRSHD.HOURS"><b>HOURS</b></a></td>
|
|
<td valign="top">Intervals of hours</td>
|
|
<td valign="top">1-999, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDIRSHD.SKIPDAY"><b>SKIPDAY</b></a></td>
|
|
<td valign="top">Days to skip</td>
|
|
<td valign="top">Single values: *NONE, <b><u>*SAME</u></b><br>Other values (up to 5 repetitions): *SUN, *MON, *TUE, *WED, *THU, *FRI, *SAT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDIRSHD.MONTHWK"><b>MONTHWK</b></a></td>
|
|
<td valign="top">Week of the month</td>
|
|
<td valign="top">4, *LAST, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGDIRSHD.REINZ"><b>REINZ</b></a></td>
|
|
<td valign="top">Reinitialize data</td>
|
|
<td valign="top">Single values: *NONE, *NONAPPC, <b><u>*SAME</u></b><br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Method</td>
|
|
<td valign="top">
|
|
<b><u>*APPC</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Replace data</td>
|
|
<td valign="top">
|
|
*NO, *YES, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDIRSHD.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
|
|
<td valign="top">Remote location name</td>
|
|
<td valign="top"><i>Character value</i>, *SYSNAME, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDIRSHD.MODE"><b>MODE</b></a></td>
|
|
<td valign="top">Mode</td>
|
|
<td valign="top"><i>Character value</i>, *NETATR, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDIRSHD.RMTNETID"><b>RMTNETID</b></a></td>
|
|
<td valign="top">Remote network identifier</td>
|
|
<td valign="top"><i>Character value</i>, *LOC, *NETATR, *NONE, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDIRSHD.LCLLOCNAME"><b>LCLLOCNAME</b></a></td>
|
|
<td valign="top">Local location name</td>
|
|
<td valign="top"><i>Character value</i>, *LOC, *NETATR, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDIRSHD.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, *SYSNAME, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGDIRSHD.SYSNAME"></a>
|
|
<h3>System name (SYSNAME)</h3>
|
|
<p>Specifies the system that supplies data to the local system. A maximum of 8 characters can be specified for the name of the supplier system you are changing. You can specify uppercase letters A through Z, numbers 0 through 9, and special characters @, #, $, and embedded blanks. Embedded blanks must be enclosed in single quotation marks ('). Leading blanks are not allowed. The @, #, and $ characters are not recommended because they are not part of an invariant character set and are not available on all keyboards.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDIRSHD.NXTSHD"></a>
|
|
<h3>Next shadow (NXTSHD)</h3>
|
|
<p>Specifies the date and time when the next shadow will occur. This is the same as the scheduled shadow date unless a retry is performed or a next shadow date is specified in addition to the scheduled shadow date.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*CURRENT</b></dt>
|
|
<dd>The current date and time is used.
|
|
</dd>
|
|
<dt><b>*SCD</b></dt>
|
|
<dd>The scheduled date and time is used.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>Next Shadow Date</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>next-shadow-date</i></b></dt>
|
|
<dd>Specify the date on which the system next begins shadowing data to your system. The date must be specified in the job date format.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>Next Shadow Time</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>next-shadow-time</i></b></dt>
|
|
<dd>Specify the time at which the system next begins shadowing data to your system.
|
|
<p>The time is specified in 24-hour format with or without a time separator as follows:
|
|
</p>
|
|
<ul>
|
|
<li>With a time separator, specify a string of 5 or 8 digits where the time separator separates the hours, minutes, and seconds. If this command is entered from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command fails.
|
|
</li>
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where <b>hh</b> = hours, <b>mm</b> = minutes, and <b>ss</b> = seconds. Valid values for <b>hh</b> range from 00 through 23. Valid values for <b>mm</b> and <b>ss</b> range from 00 through 59.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDIRSHD.SCD"></a>
|
|
<h3>Scheduled shadow (SCD)</h3>
|
|
<p>Specifies the date and time of the scheduled shadow.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*CURRENT</b></dt>
|
|
<dd>The system begins shadowing data at the current date and time.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>Shadow Date</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>scheduled-shadow-date</i></b></dt>
|
|
<dd>Specify the date on which the system begins shadowing data to your system. The date must be specified in the job date format.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>Shadow Time</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>scheduled-shadow-time</i></b></dt>
|
|
<dd>Specify the time at which the system begins shadowing data to your system.
|
|
<p>The time is specified in 24-hour format with or without a time separator as follows:
|
|
</p>
|
|
<ul>
|
|
<li>With a time separator, specify a string of 5 or 8 digits where the time separator separates the hours, minutes, and seconds. If this command is entered from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command fails.
|
|
</li>
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where <b>hh</b> = hours, <b>mm</b> = minutes, and <b>ss</b> = seconds. Valid values for <b>hh</b> range from 00 through 23. Valid values for <b>mm</b> and <b>ss</b> range from 00 through 59.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDIRSHD.FRQ"></a>
|
|
<h3>Shadowing frequency (FRQ)</h3>
|
|
<p>Specifies the frequency with which the supplier system you are changing shadows data to your system, based on the value specified on the SCD parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*WEEKLY</b></dt>
|
|
<dd>Shadowing occurs once a week.
|
|
</dd>
|
|
<dt><b>*DAILY</b></dt>
|
|
<dd>Shadowing occurs once a day.
|
|
</dd>
|
|
<dt><b>*BIWEEKLY</b></dt>
|
|
<dd>Shadowing occurs every other week.
|
|
</dd>
|
|
<dt><b>*MONTHLY</b></dt>
|
|
<dd>Shadowing occurs on the same date every month.
|
|
</dd>
|
|
<dt><b>*MONTHLYREL</b></dt>
|
|
<dd>Shadowing occurs on the same relative day of the same relative week of every month, such as the first Monday of the month.
|
|
</dd>
|
|
<dt><b>*HOURS</b></dt>
|
|
<dd>Shadowing occurs in the interval specified on the HOURS parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDIRSHD.HOURS"></a>
|
|
<h3>Intervals of hours (HOURS)</h3>
|
|
<p>Specifies the number of hours between shadows from the supplier system. This parameter is valid only when FRQ(*HOURS) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b><i>number-of-hours</i></b></dt>
|
|
<dd>Specify the number of hours between shadowing.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDIRSHD.SKIPDAY"></a>
|
|
<h3>Days to skip (SKIPDAY)</h3>
|
|
<p>Specifies the days of the week when shadowing does not occur. A maximum of five values, other than *NONE, can be specified.
|
|
</p>
|
|
<p>This parameter is valid only when FRQ(*DAILY) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No days are skipped.
|
|
</dd>
|
|
<dt><b>*SUN</b></dt>
|
|
<dd>Sundays are skipped.
|
|
</dd>
|
|
<dt><b>*MON</b></dt>
|
|
<dd>Mondays are skipped.
|
|
</dd>
|
|
<dt><b>*TUE</b></dt>
|
|
<dd>Tuesdays are skipped.
|
|
</dd>
|
|
<dt><b>*WED</b></dt>
|
|
<dd>Wednesdays are skipped.
|
|
</dd>
|
|
<dt><b>*THU</b></dt>
|
|
<dd>Thursdays are skipped.
|
|
</dd>
|
|
<dt><b>*FRI</b></dt>
|
|
<dd>Fridays are skipped.
|
|
</dd>
|
|
<dt><b>*SAT</b></dt>
|
|
<dd>Saturdays are skipped.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDIRSHD.MONTHWK"></a>
|
|
<h3>Week of the month (MONTHWK)</h3>
|
|
<p>Specifies whether shadowing that occurs on the same relative day of the month is scheduled to occur in the fourth week or the last week of the month.
|
|
</p>
|
|
<p>This parameter is valid only when FRQ(*MONTHLYREL) is specified and when the SCD parameter date is the 22nd, 23rd, or 24th.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>4</b></dt>
|
|
<dd>Shadowing occurs on the same relative day in the fourth week of the month.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>Shadowing occurs on the same relative day in the last week of the month, whether or not the month has four or five weeks.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDIRSHD.REINZ"></a>
|
|
<h3>Reinitialize data (REINZ)</h3>
|
|
<p>Specifies the method used if the first shadow is done again. The first shadow duplicates all of the data in the supplier system's distribution directory. Subsequent shadows include only data that has changed since the previous shadow.
|
|
</p>
|
|
<p>The possible <b>Method</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>The shadowed directory data is not reinitialized.
|
|
</dd>
|
|
<dt><b>*NONAPPC</b></dt>
|
|
<dd>The Copy to Directory (CPYTODIR) command is used to reinitialize the directory.
|
|
</dd>
|
|
<dt><b>*APPC</b></dt>
|
|
<dd>The first shadow occurs when this command is run using advanced program-to-program (APPC) communications. If you are adding a supplier system with a large directory, you may want to specify *NONAPPC to prevent the first shadow from monopolizing your communications lines.
|
|
<p>When *APPC is specified, Element 2 allows you to specify whether the data in the fields of a directory entry on your system is replaced by shadowed data if the same entry also exists in the supplier system's directory.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p>When *APPC is specified for the <b>Method</b> field, the possible <b>Replace Data</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The data in the fields of existing directory entries on your system is not replaced with data from the supplier system.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>All shadowed data is added to your system distribution directory. The data in the fields of existing directory entries on your system is replaced with shadowed data if the same entry also exists in the supplier system's directory.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDIRSHD.RMTLOCNAME"></a>
|
|
<h3>Remote location name (RMTLOCNAME)</h3>
|
|
<p>Specifies the remote location name of the supplier system you are changing.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*SYSNAME</b></dt>
|
|
<dd>The value specified on the SYSNAME parameter is used for the remote location name.
|
|
</dd>
|
|
<dt><b><i>remote-location-name</i></b></dt>
|
|
<dd>Specify the name of a remote location.
|
|
<p>A maximum of 8 characters can be specified. The first character must be an uppercase letter A through Z, or special character $, #, or @. The name cannot contain a blank, plus sign (+), period (.), or an underscore (_). For more information, see the APPC Programmer's Guide.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDIRSHD.MODE"></a>
|
|
<h3>Mode (MODE)</h3>
|
|
<p>Specifies the name of the mode that defines the sessions on the device used when shadowing data from the supplier system.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NETATR</b></dt>
|
|
<dd>The mode in the network attributes is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>mode-name</i></b></dt>
|
|
<dd>Specify the mode name.
|
|
<p>A maximum of 8 characters can be specified. The first character must be an uppercase letter A through Z, or special character $, #, or @. The name cannot contain a blank, plus sign (+), period (.), or an underscore (_). For more information, see the APPC Programmer's Guide.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDIRSHD.RMTNETID"></a>
|
|
<h3>Remote network identifier (RMTNETID)</h3>
|
|
<p>Specifies the supplier system's remote network identifier (ID).
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*LOC</b></dt>
|
|
<dd>The remote network ID associated with the remote location is used. If several remote network IDs are associated with the remote location, the system determines which remote network ID is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NETATR</b></dt>
|
|
<dd>The remote network identifier specified in the network attributes is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No remote network ID is used.
|
|
</dd>
|
|
<dt><b><i>remote-network-ID</i></b></dt>
|
|
<dd>Specify the remote network ID.
|
|
<p>A maximum of 8 characters can be specified. The first character must be an uppercase letter A through Z, or special character $, #, or @. The name cannot contain a blank, plus sign (+), period (.), or an underscore (_). For more information, see the APPC Programmer's Guide.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDIRSHD.LCLLOCNAME"></a>
|
|
<h3>Local location name (LCLLOCNAME)</h3>
|
|
<p>Specifies the local location name. The local location name is used to identify your system to the supplier system you are changing.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*LOC</b></dt>
|
|
<dd>The local location name associated with the remote location is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NETATR</b></dt>
|
|
<dd>The LCLLOCNAME value specified in the system network attributes is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>local-location-name</i></b></dt>
|
|
<dd>Specify the local location name.
|
|
<p>A maximum of 8 characters can be specified. The first character must be an uppercase letter A through Z, or special character $, #, or @. The first character cannot contain a blank, plus sign (+), period (.), or an underscore (_). For more information, see the APPC Programmer's Guide.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDIRSHD.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the object.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*SYSNAME</b></dt>
|
|
<dd>The name specified on the SYSNAME parameter is used for the description.
|
|
</dd>
|
|
<dt><b><i>'description'</i></b></dt>
|
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGDIRSHD.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Changing the Next Shadow Date and Time</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGDIRSHD SYSNAME(NYCITY)
|
|
NXTSHD('93/05/01' '8:00:00')
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the next shadowing occurrence for the system NYCITY. This does not effect the scheduled date and time. When the shadowing is completed for this system, the next date and time will be calculated from the scheduled date and time. This command is used for temporary changes to shadowing schedules.
|
|
</p>
|
|
<p><b>Example 2: Changing the Shadow Date and Time</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGDIRSHD SYSNAME(NEWYORK)
|
|
SCD('93/06/01' '20:00:00')
|
|
FRQ(*BIWEEKLY)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the scheduled shadow date for system NEWYORK to June 1, 1993 at 8:00 PM. The frequency of the shadow is every 2 weeks.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGDIRSHD.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF90A8</b></dt>
|
|
<dd>*SECADM special authority required to do requested operation.
|
|
</dd>
|
|
<dt><b>CPF90FE</b></dt>
|
|
<dd>Add or change of shadow supplier &1 was not successful.
|
|
</dd>
|
|
<dt><b>CPF905C</b></dt>
|
|
<dd>Error occurred trying to find a translation table.
|
|
</dd>
|
|
<dt><b>CPF9838</b></dt>
|
|
<dd>User profile storage limit exceeded.
|
|
</dd>
|
|
<dt><b>CPF9845</b></dt>
|
|
<dd>Error occurred while opening file &1.
|
|
</dd>
|
|
<dt><b>CPF9846</b></dt>
|
|
<dd>Error while processing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9847</b></dt>
|
|
<dd>Error occurred while closing file &1 in library &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|