friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
8826eae394
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/adddstclge.htm

1048 lines
40 KiB
HTML
Raw Normal View History

Add readme and dist folders
2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Add DST Catalog Entry (ADDDSTCLGE)</title>
</head>
<body bgcolor="white">
<a name="ADDDSTCLGE.Top_Of_Page"></a>
<h2>Add DST Catalog Entry (ADDDSTCLGE)</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="#ADDDSTCLGE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDDSTCLGE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDDSTCLGE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDDSTCLGE"></a>
<p>The Add Distribution Catalog Entry (ADDDSTCLGE) command is used to add an entry to the distribution catalog. A data object can optionally be loaded into the distribution repository from an iSeries library, folder, or from any of the integrated file systems.
</p>
<p>The distribution catalog contains a list of objects that are eligible for distribution. Each catalog entry is identified by a network-wide unique name called a global name. Each catalog entry describes where the object to be distributed is located for retrieval or can be stored when received.
</p>
<p>The catalog entry consists of the global name of the object, the name of the object's storage location (if the object exists), and attributes of the object. The data object associated with the global name can be stored as a standard iSeries object in a library, folder, stream file, or distribution repository.
</p>
<p><b>Notes:</b>
</p>
<ol>
<li>When the object type *LICKEY is specified, it is assumed that the file that is to be cataloged is a license key file.
</li>
<li>A specific format to catalog a license key file or a stream file for a global name is not required.
</li>
<li>A specific global name format is required to catalog an installable object.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDDSTCLGE.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" rowspan="11"><a href="#ADDDSTCLGE.GLBNAME"><b>GLBNAME</b></a></td>
<td valign="top">Global name</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="11">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Element 1: Global name token 1</td>
<td valign="top">
<i>Character value</i>, *NETID, *MDDATE, *MDTIME, *SERVER, *TARGET</td>
</tr>
<tr>
<td valign="top">Element 2: Global name token 2</td>
<td valign="top">
<i>Character value</i>, *NETID, *CPNAME, *DATE, *TIME, *MDDATE, *MDTIME, *SERVER, *TARGET</td>
</tr>
<tr>
<td valign="top">Element 3: Global name token 3</td>
<td valign="top">
<i>Character value</i>, *NETID, *CPNAME, *DATE, *TIME, *MDDATE, *MDTIME, *SERVER, *TARGET</td>
</tr>
<tr>
<td valign="top">Element 4: Global name token 4</td>
<td valign="top">
<i>Character value</i>, *NETID, *CPNAME, *DATE, *TIME, *MDDATE, *MDTIME, *SERVER, *TARGET</td>
</tr>
<tr>
<td valign="top">Element 5: Global name token 5</td>
<td valign="top">
<i>Character value</i>, *NETID, *CPNAME, *DATE, *TIME, *MDDATE, *MDTIME, *SERVER, *TARGET</td>
</tr>
<tr>
<td valign="top">Element 6: Global name token 6</td>
<td valign="top">
<i>Character value</i>, *NETID, *CPNAME, *DATE, *TIME, *MDDATE, *MDTIME, *SERVER, *TARGET</td>
</tr>
<tr>
<td valign="top">Element 7: Global name token 7</td>
<td valign="top">
<i>Character value</i>, *NETID, *CPNAME, *DATE, *TIME, *MDDATE, *MDTIME, *SERVER, *TARGET</td>
</tr>
<tr>
<td valign="top">Element 8: Global name token 8</td>
<td valign="top">
<i>Character value</i>, *NETID, *CPNAME, *DATE, *TIME, *MDDATE, *MDTIME, *SERVER, *TARGET</td>
</tr>
<tr>
<td valign="top">Element 9: Global name token 9</td>
<td valign="top">
<i>Character value</i>, *NETID, *CPNAME, *DATE, *TIME, *MDDATE, *MDTIME, *SERVER, *TARGET</td>
</tr>
<tr>
<td valign="top">Element 10: Global name token 10</td>
<td valign="top">
<i>Character value</i>, *NETID, *CPNAME, *DATE, *TIME, *MDDATE, *MDTIME, *SERVER, *TARGET</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDSTCLGE.OBJTYPE"><b>OBJTYPE</b></a></td>
<td valign="top">Object type</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDDSTCLGE.OBJ"><b>OBJ</b></a></td>
<td valign="top">Object</td>
<td valign="top">Single values: *NONE<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Object</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="#ADDDSTCLGE.MBR"><b>MBR</b></a></td>
<td valign="top">Member</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b>, *FIRST</td>
<td valign="top">Optional, Positional 4</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDSTCLGE.DATATYPE"><b>DATATYPE</b></a></td>
<td valign="top">Data type</td>
<td valign="top"><b><u>*UNSPEC</u></b>, *CL, *REXX</td>
<td valign="top">Optional, Positional 5</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDSTCLGE.DLO"><b>DLO</b></a></td>
<td valign="top">Document library object</td>
<td valign="top"><i>Character value</i>, *NONE</td>
<td valign="top">Optional, Positional 6</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDSTCLGE.FLR"><b>FLR</b></a></td>
<td valign="top">Folder</td>
<td valign="top"><i>Character value</i>, *NONE</td>
<td valign="top">Optional, Positional 7</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDSTCLGE.STMF"><b>STMF</b></a></td>
<td valign="top">Stream file</td>
<td valign="top"><i>Path name</i>, *NONE</td>
<td valign="top">Optional, Positional 8</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDSTCLGE.STGLOC"><b>STGLOC</b></a></td>
<td valign="top">Local storage location</td>
<td valign="top"><b><u>*STD</u></b>, *DSTRPS</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDSTCLGE.TGTRLS"><b>TGTRLS</b></a></td>
<td valign="top">Target release</td>
<td valign="top"><b><u>*CURRENT</u></b>, *PRV, V5R2M0, V5R3M0, V5R4M0</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDSTCLGE.DTACPR"><b>DTACPR</b></a></td>
<td valign="top">Data compression</td>
<td valign="top"><b><u>*NONE</u></b>, *SNA</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDSTCLGE.SNACPRCHR"><b>SNACPRCHR</b></a></td>
<td valign="top">Compression character</td>
<td valign="top">X'00'-X'FF', <b><u>*BLANK</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDSTCLGE.AUTL"><b>AUTL</b></a></td>
<td valign="top">Authorization list</td>
<td valign="top"><i>Name</i>, <b><u>QCQRPSAUTL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDSTCLGE.DTAACCKEY"><b>DTAACCKEY</b></a></td>
<td valign="top">Data access key</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDSTCLGE.TEXT"><b>TEXT</b></a></td>
<td valign="top">Catalog entry text</td>
<td valign="top"><i>Character value</i>, <b><u>*OBJTEXT</u></b>, *BLANK</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="11"><a href="#ADDDSTCLGE.VERSIONATR"><b>VERSIONATR</b></a></td>
<td valign="top">Version attributes</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="11">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Global name token 1</td>
<td valign="top">
<b><u>*UNSPEC</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Global name token 2</td>
<td valign="top">
<b><u>*UNSPEC</u></b>, *NETID, *CPNAME, *ORDCHAR, *ORDDATE, *ORDDEC, *ORDTIME, *STI, *SYSTYPE</td>
</tr>
<tr>
<td valign="top">Element 3: Global name token 3</td>
<td valign="top">
<b><u>*UNSPEC</u></b>, *NETID, *CPNAME, *ORDCHAR, *ORDDATE, *ORDDEC, *ORDTIME, *STI, *SYSTYPE</td>
</tr>
<tr>
<td valign="top">Element 4: Global name token 4</td>
<td valign="top">
<b><u>*UNSPEC</u></b>, *NETID, *CPNAME, *ORDCHAR, *ORDDATE, *ORDDEC, *ORDTIME, *STI, *SYSTYPE</td>
</tr>
<tr>
<td valign="top">Element 5: Global name token 5</td>
<td valign="top">
<b><u>*UNSPEC</u></b>, *NETID, *CPNAME, *ORDCHAR, *ORDDATE, *ORDDEC, *ORDTIME, *STI, *SYSTYPE</td>
</tr>
<tr>
<td valign="top">Element 6: Global name token 6</td>
<td valign="top">
<b><u>*UNSPEC</u></b>, *NETID, *CPNAME, *ORDCHAR, *ORDDATE, *ORDDEC, *ORDTIME, *STI, *SYSTYPE</td>
</tr>
<tr>
<td valign="top">Element 7: Global name token 7</td>
<td valign="top">
<b><u>*UNSPEC</u></b>, *NETID, *CPNAME, *ORDCHAR, *ORDDATE, *ORDDEC, *ORDTIME, *STI, *SYSTYPE</td>
</tr>
<tr>
<td valign="top">Element 8: Global name token 8</td>
<td valign="top">
<b><u>*UNSPEC</u></b>, *NETID, *CPNAME, *ORDCHAR, *ORDDATE, *ORDDEC, *ORDTIME, *STI, *SYSTYPE</td>
</tr>
<tr>
<td valign="top">Element 9: Global name token 9</td>
<td valign="top">
<b><u>*UNSPEC</u></b>, *NETID, *CPNAME, *ORDCHAR, *ORDDATE, *ORDDEC, *ORDTIME, *STI, *SYSTYPE</td>
</tr>
<tr>
<td valign="top">Element 10: Global name token 10</td>
<td valign="top">
<b><u>*UNSPEC</u></b>, *NETID, *CPNAME, *ORDCHAR, *ORDDATE, *ORDDEC, *ORDTIME, *STI, *SYSTYPE</td>
</tr>
<tr>
<td valign="top" rowspan="11"><a href="#ADDDSTCLGE.MATCHATR"><b>MATCHATR</b></a></td>
<td valign="top">Match attributes</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="11">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Global name token 1</td>
<td valign="top">
<b><u>*MATCH</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Global name token 2</td>
<td valign="top">
<b><u>*NOMATCH</u></b>, *MATCH</td>
</tr>
<tr>
<td valign="top">Element 3: Global name token 3</td>
<td valign="top">
<b><u>*NOMATCH</u></b>, *MATCH</td>
</tr>
<tr>
<td valign="top">Element 4: Global name token 4</td>
<td valign="top">
<b><u>*NOMATCH</u></b>, *MATCH</td>
</tr>
<tr>
<td valign="top">Element 5: Global name token 5</td>
<td valign="top">
<b><u>*NOMATCH</u></b>, *MATCH</td>
</tr>
<tr>
<td valign="top">Element 6: Global name token 6</td>
<td valign="top">
<b><u>*NOMATCH</u></b>, *MATCH</td>
</tr>
<tr>
<td valign="top">Element 7: Global name token 7</td>
<td valign="top">
<b><u>*NOMATCH</u></b>, *MATCH</td>
</tr>
<tr>
<td valign="top">Element 8: Global name token 8</td>
<td valign="top">
<b><u>*NOMATCH</u></b>, *MATCH</td>
</tr>
<tr>
<td valign="top">Element 9: Global name token 9</td>
<td valign="top">
<b><u>*NOMATCH</u></b>, *MATCH</td>
</tr>
<tr>
<td valign="top">Element 10: Global name token 10</td>
<td valign="top">
<b><u>*NOMATCH</u></b>, *MATCH</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDDSTCLGE.GLBNAME"></a>
<h3>Global name (GLBNAME)</h3>
<p>Specifies the token values of the global name. The global name is the name by which the object is known in a system network architecture (SNA) network. The global name can be a maximum of 65-<i>n</i> characters in length, where <i>n</i> is the number of tokens. A maximum of 10 tokens can be specified and each token can be a maximum of 16 characters in length.
</p>
<p>Valid tokens consist of uppercase letters A-Z and numbers 0-9. The special characters #, $, or @ are valid only when VERSIONATR(*CPNAME) is specified. In multilingual networks, language translation may make the value not valid when the special characters are used. Use of these characters is not recommended.
</p>
<p><b>Notes:</b>
</p>
<ol>
<li>The global name must contain at least one token with VERSIONATR(*STI) specified when adding a distribution catalog entry for a product.
</li>
<li>If OBJTYPE(*PRODUCT) is specified, global names can have up to a maximum of 7 tokens before VERSIONATR(*STI) is specified, and a maximum of 2 tokens after VERSIONATR(*STI) is specified.
</li>
<li>At least two tokens must be specified in the global name.
</li>
<li>*SERVER, *TARGET, *MDDATE, and *MDTIME values are valid for token 1 or token 2.
</li>
</ol>
<p>This is a required parameter.
</p>
<p>The possible token 1 values are:
</p>
<dl>
<dt><b>*NETID</b></dt>
<dd>The first global name token value is a network ID generated by the command from the network attributes. VERSIONATR(*UNSPEC) or VERSIONATR(*NETID) must be specified.
</dd>
<dt><b>*MDDATE</b></dt>
<dd>This token is stored within the change request activity with the value &amp;DATE, and replaced when distributed by the date the object was last modified.
</dd>
<dt><b>*MDTIME</b></dt>
<dd>This token is stored within the change request activity with the value &amp;TIME, and replaced when distributed by the time the object was last modified.
</dd>
<dt><b>*SERVER</b></dt>
<dd>This token is stored within the change request activity with the value &amp;SERVER, and replaced by the short name of the change control server when the object is distributed.
</dd>
<dt><b>*TARGET</b></dt>
<dd>This token is stored within the change request activity with the value &amp;TARGET, and replaced by the short name of the target when the object is distributed.
</dd>
<dt><b><i>global-name-token</i></b></dt>
<dd>Specify the first token of the global name. The first token is recommended to be the registered enterprise ID or network ID.
</dd>
</dl>
<p>The possible subsequent token values are:
</p>
<dl>
<dt><b>*NETID</b></dt>
<dd>Identifies the global name token <i>n</i> value as a network ID. This value is generated from the network attributes. VERSIONATR(*UNSPEC) or VERSIONATR(*NETID) must be specified for the corresponding token.
</dd>
<dt><b>*CPNAME</b></dt>
<dd>Identifies the global name token value as a control point name. This value is generated from the network attributes. VERSIONATR(*UNSPEC) or VERSIONATR(*CPNAME) must be specified for the corresponding token.
</dd>
<dt><b>*DATE</b></dt>
<dd>Identifies the global name token value as the current date. This value is generated from the system value with the format Y1992M04D10. VERSIONATR(*UNSPEC), VERSIONATR(*ORDDATE), or VERSIONATR(*ORDCHAR) must be specified for the corresponding token.
</dd>
<dt><b>*TIME</b></dt>
<dd>Identifies the global name token value as the current time. This value is generated from the system value with the format H13M30S20. VERSIONATR(*UNSPEC), VERSIONATR(*ORDTIME), or VERSIONATR(*ORDCHAR) must be specified for the corresponding token.
</dd>
<dt><b>*MDDATE</b></dt>
<dd>This token is stored within the change request activity with the value &amp;DATE, and replaced when distributed by the date the object was last modified.
</dd>
<dt><b>*MDTIME</b></dt>
<dd>This token is stored within the change request activity with the value &amp;TIME, and replaced when distributed by the time the object was last modified.
</dd>
<dt><b>*SERVER</b></dt>
<dd>This token is stored within the change request activity with the value &amp;SERVER, and replaced by the short name of the change control server when the object is distributed.
</dd>
<dt><b>*TARGET</b></dt>
<dd>This token is stored within the change request activity with the value &amp;TARGET, and replaced by the short name of the target when the object is distributed.
</dd>
<dt><b><i>global-name-token</i></b></dt>
<dd>Specify a token of the global name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.OBJTYPE"></a>
<h3>Object type (OBJTYPE)</h3>
<p>Specifies the type of object used.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*FILEDATA</b></dt>
<dd>A file member containing data is transferred without attributes. The MBR parameter is required when OBJTYPE(*FILEDATA) is specified and OBJ(*NONE) is not specified.
</dd>
<dt><b>*PRODUCT</b></dt>
<dd>A save file containing a product packaged with the i5/OS product packaging support.
</dd>
<dt><b>*LICKEY</b></dt>
<dd>A license key file generated through the Display License Key (DSPLICKEY) command. The MBR parameter is required when *LICKEY is specified and the OBJ parameter is not *NONE.
</dd>
<dt><b>*STMF</b></dt>
<dd>A stream file containing a continuous stream of data.
</dd>
<dt><b>*INSOBJ</b></dt>
<dd>An installable object containing a combination of objects to be installed and a list of those objects associated with the name of the target library, folder, or path where the objects must be created when the installable object is installed.
</dd>
<dt><b><i>object-type</i></b></dt>
<dd>Specify the i5/OS object type to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.OBJ"></a>
<h3>Object (OBJ)</h3>
<p>Specifies the qualified name of the object to be used when adding the catalog entry.
</p>
<p>The possible single value is:
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>A data object is not loaded into the repository. OBJ(*NONE) is only valid when STGLOC(*DSTRPS) is specified.
</dd>
</dl>
<p>The name of the object can be qualified by one of the following library values:
</p>
<dl>
<dt><b><u>*LIBL</u></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, the QGPL library 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 object name value is:
</p>
<dl>
<dt><b><i>object-name</i></b></dt>
<dd>Specify the name of the local object.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.MBR"></a>
<h3>Member (MBR)</h3>
<p>Specifies the file member to be used when OBJTYPE(*FILEDATA), OBJTYPE(*FILE), or OBJTYPE(*LICKEY) is specified.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>When STGLOC(*DSTRPS) is specified, the entire file is loaded into the distribution repository and a catalog entry is added to the catalog for the repository object. When STGLOC(*STD) is specified, a catalog entry is added for the file. MBR(*ALL) is only valid when OBJTYPE(*FILE) is specified.
</dd>
<dt><b>*FIRST</b></dt>
<dd>When STGLOC(*DSTRPS) is specified, the first file member is loaded into the distribution repository and a catalog entry is added to the catalog for the repository object. When STGLOC(*STD) is specified, a catalog entry is added for the first member.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the name of the file member to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.DATATYPE"></a>
<h3>Data type (DATATYPE)</h3>
<p>Specifies the type of data contained in a member that is handled as data only, without attributes. This parameter is only valid when OBJTYPE(*FILEDATA) is specified.
</p>
<dl>
<dt><b><u>*UNSPEC</u></b></dt>
<dd>The data type is not specified.
</dd>
<dt><b>*CL</b></dt>
<dd>The data type is control language (CL).
</dd>
<dt><b>*REXX</b></dt>
<dd>The data type is REXX.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.DLO"></a>
<h3>Document library object (DLO)</h3>
<p>Specifies the document library object name being cataloged. This parameter is required when OBJTYPE(*DOC) is specified.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>A document is not loaded into the distribution repository. DLO(*NONE) is only valid when STGLOC(*DSTRPS) is specified.
</dd>
<dt><b><i>document-name</i></b></dt>
<dd>Specify the name of the document to be cataloged. Valid document names can be up to eight characters in length and optionally qualified with a period and a one to three character extension.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.FLR"></a>
<h3>Folder (FLR)</h3>
<p>Specifies the folder name in which the document specified on the DLO parameter is located. This parameter is required when OBJTYPE(*DOC) or OBJTYPE(*FLR) is specified.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No folder or document is loaded into the repository. This parameter is only valid when STGLOC(*DSTRPS) is specified.
</dd>
<dt><b><i>folder-name</i></b></dt>
<dd>Specifies the name of the folder in which the document is located or the folder name is being cataloged. The folder name can be a maximum of 63 characters in length.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.STMF"></a>
<h3>Stream file (STMF)</h3>
<p>Specifies the stream file to be cataloged. This parameter is required when OBJTYPE(*STMF) is specified.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No stream file is loaded into the distribution repository. This parameter is only valid when STGLOC(*DSTRPS) is specified.
</dd>
<dt><b><i>object-path-name</i></b></dt>
<dd>Specifies the path name of the stream file. This can be a path name of 1980 characters. Additional information about path names is in the <i>Integrated File System Introduction</i> book.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.STGLOC"></a>
<h3>Local storage location (STGLOC)</h3>
<p>Specifies the storage location of the data object to which the global name points.
</p>
<dl>
<dt><b><u>*STD</u></b></dt>
<dd>The global name refers to the object specified on the OBJ name parameter.
</dd>
<dt><b>*DSTRPS</b></dt>
<dd>The global name refers to an object in the distribution repository. If an object is specified on the OBJ parameter, it is loaded into the repository.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.TGTRLS"></a>
<h3>Target release (TGTRLS)</h3>
<p>Specifies the release of the operating system on which you intend to use the object. This parameter is ignored when OBJTYPE(*FILEDATA), OBJTYPE(*PRODUCT), OBJTYPE(*LICKEY), OBJTYPE(*STMF), OR OBJTYPE(*INSOBJ) is specified, or the object is a save file.
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>The object is used on the release of the operating system currently running on your system. If V5R4M0 is running on your system, *CURRENT means that you intend to use the object on a system with V5R4M0 installed. The object also can be used on a system with any later release of the operating system installed.
</dd>
<dt><b><i>release-level</i></b></dt>
<dd>Specify the release level in the format VxRxMx. The object is used on a system with the specified release or with any later release of the operating system installed.
<p>Valid values depend on the current version, release, and modification level, and they change with each new release.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.DTACPR"></a>
<h3>Data compression (DTACPR)</h3>
<p>Specifies the compression method used to load a member into the distribution repository.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The object is not compressed.
</dd>
<dt><b>*SNA</b></dt>
<dd>The object is compressed using SNA compression.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.SNACPRCHR"></a>
<h3>Compression character (SNACPRCHR)</h3>
<p>Specifies the prime compression character used by the SNA compression algorithm when DTACPR(*SNA) is specified. Valid values range from hexadecimal '00'X through 'FF'X. This parameter is ignored when DTCPR(*NONE) is specified.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>The prime compression character is a blank (hexadecimal value '40'X ).
</dd>
<dt><b><i>character</i></b></dt>
<dd>Specify the hexadecimal value of the prime compression character to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.AUTL"></a>
<h3>Authorization list (AUTL)</h3>
<p>Specifies the name of the authorization list of the repository object. This parameter is required when STGLOC(*DSTRPS) is specified.
</p>
<dl>
<dt><b><u>QCQRPSAUTL</u></b></dt>
<dd>The default authorization list is used.
</dd>
<dt><b><i>authorization-list-name</i></b></dt>
<dd>Specify the name of the authorization list to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.DTAACCKEY"></a>
<h3>Authorization list (DTAACCKEY)</h3>
<p>Specifies the data access key (DAK) associated with the file. If this value is specified, the data access key name must exist in the access key table. This access key protects the catalog entry when used in the change control server/client environment.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No access key is assigned to the catalog entry.
</dd>
<dt><b><i>access-key</i></b></dt>
<dd>Specify the name of the data access key (DAK) associated with the file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.TEXT"></a>
<h3>Catalog entry text (TEXT)</h3>
<p>Specifies the text description of the catalog entry.
</p>
<dl>
<dt><b><u>*OBJTEXT</u></b></dt>
<dd>The text description of the local object is used. This value is not valid when OBJ(*NONE) is specified.
<p>
<b>Note: </b>When cataloging a stream file and *OBJTEXT is used for the text parameter, the catalog entry description for the stream file being cataloged is generated with the text <i>Catalog entry for a stream file</i>.
</p>
</dd>
<dt><b>*BLANK</b></dt>
<dd>No text is specified.
</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="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.VERSIONATR"></a>
<h3>Version attributes (VERSIONATR)</h3>
<p>Specifies the version attributes of the tokens in the global name. The attributes identify the kind of token.
</p>
<p>The possible value for token 1 is:
</p>
<dl>
<dt><b><u>*UNSPEC</u></b></dt>
<dd>The version attribute is not specified.
</dd>
</dl>
<p>The possible values for tokens 2-10 are:
</p>
<dl>
<dt><b><u>*UNSPEC</u></b></dt>
<dd>The version attribute is not specified.
</dd>
<dt><b>*NETID</b></dt>
<dd>The corresponding token is a network ID.
</dd>
<dt><b>*CPNAME</b></dt>
<dd>The corresponding token is control point name.
</dd>
<dt><b>*SYSTYPE</b></dt>
<dd>The corresponding token is a system type.
</dd>
<dt><b>*STI</b></dt>
<dd>The corresponding token is a subtree indicator.
<p>The tokens with the following attributes may be used in partial matching:
</p>
</dd>
<dt><b>*ORDCHAR</b></dt>
<dd>The corresponding token is an ordered character.
</dd>
<dt><b>*ORDDATE</b></dt>
<dd>The corresponding token is an ordered date with the format Y1989M05D03.
</dd>
<dt><b>*ORDDEC</b></dt>
<dd>The corresponding token is an ordered decimal.
</dd>
<dt><b>*ORDTIME</b></dt>
<dd>The corresponding token is an ordered time with the format H13M30S20.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDSTCLGE.MATCHATR"></a>
<h3>Match attributes (MATCHATR)</h3>
<p>Specifies whether each token in the global name must match the corresponding token on the global name in the request when partial global name matching is done.
</p>
<p>The possible value for token 1 is:
</p>
<dl>
<dt><b>*MATCH</b></dt>
<dd>The requested token must match this token.
</dd>
</dl>
<p>The possible values for tokens 2-10 are:
</p>
<dl>
<dt><b><u>*NOMATCH</u></b></dt>
<dd>The requested token is not required to match this token. This match attribute should be specified for all tokens that have VERSIONATR(*ORDDATE, *ORDTIME, *ORDCHAR, or *ORDDEC) specified.
</dd>
<dt><b>*MATCH</b></dt>
<dd>The requested token must match this token.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDDSTCLGE.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Adding a Catalog Entry for a File</b>
</p>
<p>
<pre>
ADDDSTCLGE GLBNAME(ENTID FINANCE PAYROLL DEDUCT)
OBJTYPE(*FILE) OBJ(*LIBL/PAYDED) STGLOC(*STD)
</pre>
</p>
<p>This command adds a catalog entry for the payroll deductions file. All requests received referring to global name ENTID FINANCE PAYROLL DEDUCT are performed on the file PAYDED.
</p>
<p><b>Example 2: Loading a File into the Repository for Filedata</b>
</p>
<p>
<pre>
ADDDSTCLGE GLBNAME(ENTID INVENTORY *DATE) OBJTYPE(*FILEDATA)
OBJ(APPLZ/CURINV) MBR(*FIRST) STGLOC(*DSTRPS)
DTACPR(*SNA) AUTL(MYLIST)
VERSIONATR(*UNSPEC *ORDCHAR *ORDDATE)
MATCHATR(*MATCH *NOMATCH *NOMATCH)
</pre>
</p>
<p>This command loads the current inventory file APPLZ in library CURINV into the distribution repository in compressed form. The file in the distribution repository can be referred to by the global name ENTID INVENTORY Y1993M09D15. The file is secured by authorization list MYLIST.
</p>
<p><b>Example 3: Loading a Document into the Repository for a Document</b>
</p>
<p>
<pre>
ADDDSTCLGE GLBNAME(ENTID NYPS1 SALESRPT) OBJTYPE(*DOC)
DLO(STATUS) FLR(NY/SALES.RPT/APRIL)
STGLOC(*DSTRPS)
</pre>
</p>
<p>This command loads document STATUS in folder path NY/SALES.RPT/APRIL into the distribution repository.
</p>
<p><b>Example 4: Adding a Distribution Catalog Entry into the Repository for a Product</b>
</p>
<p>
<pre>
ADDDSTCLGE GLBNAME(I3IBM1 AS400 ACCOUNT V1R1M0 BASE ALL 2924
REF 001 V5R2M0) OBJTYPE(*PRODUCT)
OBJ(ACCLIB/ACCPKG) STGLOC(*DSTRPS)
VERSIONATR(*UNSPEC *ORDCHAR *ORDCHAR *ORDCHAR
*ORDCHAR *ORDCHAR *ORDCHAR *STI *ORDDEC *ORDCHAR)
MATCHATR(*MATCH *NOMATCH *NOMATCH *NOMATCH *NOMATCH
*NOMATCH *NOMATCH *NOMATCH *MATCH *NOMATCH
*NOMATCH) TEXT('Accounting Base Product V1R1M0')
</pre>
</p>
<p>This command adds an entry to the Distribution Catalog and points to a product stored in the distribution repository.
</p>
<p><b>Example 5: Adding an Entry into the Distribution Catalog for a Product</b>
</p>
<p>
<pre>
ADDDSTCLGE GLBNAME(I3IBM1 AS400 DISTSYS V1R2M0 BASE ALL
2924 REF 001 V5R2M0) OBJTYPE(*PRODUCT)
OBJ(DSTSYSLIB/DSTLP) STGLOC(*STD)
VERSIONATR(*UNSPEC *ORDCHAR *ORDCHAR *ORDCHAR
*ORDCHAR *ORDCHAR *ORDCHAR *STI *ORDDEC *ORDCHAR)
MATCHATR(*MATCH *NOMATCH *NOMATCH *NOMATCH *NOMATCH
*NOMATCH *NOMATCH *MATCH *NOMATCH *NOMATCH)
TEXT('Distribution System Base Product V1R2M0')
</pre>
</p>
<p>This command adds an entry for a product to the distribution catalog and points to the save file DSTLP in the library DSTSYSLIB.
</p>
<p><b>Example 6: Adding a Distribution Catalog Entry for License File Pointing to Distribution Repository</b>
</p>
<p>
<pre>
ADDDSTCLGE GLBNAME(COMPANY1 ACCOUNT LICENSES)
OBJTYPE(*LICKEY) OBJ(ACCNTLIB/ACCLICF)
MBR(*FIRST) STGLOC(*DSTRPS)
TEXT('License file for ACCOUNT product')
</pre>
</p>
<p>This command adds a distribution catalog entry that is stored in the distribution repository. The license file was previously generated running the DSPLICKEY command to obtain the existing licenses keys for the product ACCOUNT from the license repository.
</p>
<p><b>Example 7: Adding a Distribution Catalog Entry for License File Pointing to i5/OS Standard Location</b>
</p>
<p>
<pre>
ADDDSTCLGE GLBNAME(COMPANY2 PURCHASE V3 LICKEYS)
OBJTYPE(*LICKEY) OBJ(PURCHLIB/PURCHLICF)
STGLOC(*STD) MBR(V3LIC)
</pre>
</p>
<p>This command adds an entry in the distribution catalog pointing to the PURCHLIB/PURCHLICF in i5/OS standard location. The license file can or cannot exist at this time.
</p>
<p><b>Example 8: Adding a Distribution Catalog Entry for Stream File</b>
</p>
<p>
<pre>
ADDDSTCLGE GLBNAME(STREAM FILE CATALOG EXAMPLE)
OBJTYPE(*STMF) STMF('/Dir1/Dir2/Dir3/UsrFile')
STGLOC(*DSTRPS)
TEXT('User file cataloged as stream file')
</pre>
</p>
<p>This command adds a distribution catalog entry to the repository that points to a stream file that is to be loaded in the distribution repository.
</p>
<p><b>Example 9: Adding a Distribution Catalog Entry for Stream File with Symbolic Link</b>
</p>
<p>
<pre>
ADDDSTCLGE GLBNAME(STREAM FILE WITH SYMBOLIC LINKS CATALOG
EXAMPLE) OBJTYPE(*STMF) STMF('FileLink')
STGLOC(*DSTRPS)
TEXT('Catalog a stream file using symbolic links')
</pre>
</p>
<p>This command adds a distribution catalog entry that points to a stream file stored in the distribution repository. However, in this example, the stream file is referred with a symbolic link. An assumption made in this example is that the current directory contains the following symbolic link:
</p>
<p>
<pre>
FileLink = /SomeDirectory/SomeFile
</pre>
</p>
<p>For information about symbolic links, see the Integrated File System Introduction topic in the Information Center.
</p>
<p><b>Example 10: Adding a Distribution Catalog Entry for a Stream File using *MDDATE and *MDTIME on a remote change control server.</b>
</p>
<p>These tokens are useful when you catalog files that are distributed regularly, such a transaction logs or sales data. For example, if you want to retrieve a transaction log from the remote change control client (remote target) on a daily basis, you can catalog it on the remote change control server where the remote change control client is attached to with a global name such as:
</p>
<p>
<pre>
ADDDSTCLGE GLBNAME(EURO TRANSACT LOG *MDDATE *MDTIME)
OBJTYPE(*STMF) OBJ('/transact/logfile')
STGLOC(*STD)
VERSIONATR(*UNSPEC *ORDCHAR *ORDCHAR *ORDDATE
*ORDTIME) TEXT('Transaction log file')
</pre>
</p>
<p>When displaying the catalog entry it will appear as:
</p>
<p>
<pre>
EURO.TRANSACT.LOG.&amp;DATE.&amp;TIME
</pre>
</p>
<p>To retrieve the file, you can add the next change request activity in the local system:
</p>
<p>
<pre>
ADDCRQA CRQD(QGPL/CRQDRTV) ACTIVITY(ACT01) ACTION(*RTV)
GLBNAME(EURO TRANSACT LOG *MDDATE *MDTIME)
CPNAME(RMTSRV RMTCLT)
</pre>
</p>
<p>When the change request is submitted in the local system, the remote change control client returns the global name with the *MDDATE and *MDTIME tokens expanded to the actual date and time the file was last modified. For example, if the local file was last modified on 27 February 2001 at 15:40:00, the global name returned from the change control client is:
</p>
<p>
<pre>
EURO.TRANSACT.LOG.Y2001M02D27.H15M40S00
</pre>
</p>
<p>The local system (the one to which you retrieved the file) catalogs the file under this name. This way, you can retrieve the same file every day, and each copy is cataloged under a different name. You can see the date and time of the file easily from the catalog entry.
</p>
<p><b>Example 11: Adding a Distribution Catalog Entry for a Stream File using *SERVER and *TARGET tokens.</b>
</p>
<p>These tokens are used so that one catalog entry can be used for a file on multiple change control clients (targets). The following catalog entry is added in the change control server named "FREDSWS FREDSWS":
</p>
<p>
<pre>
ADDDSTCLGE GLBNAME(EURO SALES FILE *SERVER *TARGET)
OBJTYPE(*STMF)
STMF('/targetdir/sales/sales.file')
STGLOC(*STD) TEXT('Clients sale file')
</pre>
</p>
<p>The change control server "FREDSWS FREDSWS" has two change control client (targets) attached: the change control client "FREDSWS ROSE" and "FREDSWS NORA", and the file '/targetdir/sales/sales.file' exists on both targets.
</p>
<p>If a user at another SNA distribution services node retrieved the sales files for all the targets attached to the change control server FREDSWS by requesting the global name EURO SALES FILE *SERVER *TARGET, that user would receive the global names EURO SALES FILE FREDSWS ROSE and EURO SALES FILE FREDSWS NORA
</p>
<p>If a user at another SNA distribution services node retrieved it from the change control server "FREDSWS FREDSWS", he would receive the global name EURO SALES FILE FREDSWS FREDSWS. Also, sending the file pointed by EURO SALES FILE *SERVER *TARGET to a focal point from the i5/OS change control server "FREDSWS FREDSWS" would result in catalog entry EURO SALES FILE FREDSWS FREDSWS sent.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDDSTCLGE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>MSS005B</b></dt>
<dd>Storage limit exceeded.
</dd>
<dt><b>MSS0116</b></dt>
<dd>Maximum global name length exceeded.
</dd>
<dt><b>MSS0117</b></dt>
<dd>Global name token &amp;3 not valid. Reason code &amp;4.
</dd>
<dt><b>MSS0118</b></dt>
<dd>Global name token &amp;3 not valid. Reason code &amp;4.
</dd>
<dt><b>MSS0123</b></dt>
<dd>Internal processing error occurred.
</dd>
<dt><b>MSS0124</b></dt>
<dd>Error while managing distribution catalog.
</dd>
<dt><b>MSS0132</b></dt>
<dd>Catalog entry already exists for object &amp;1.
</dd>
<dt><b>MSS0133</b></dt>
<dd>Not authorized to add distribution catalog entry.
</dd>
<dt><b>MSS0135</b></dt>
<dd>Distribution catalog entry not added.
</dd>
<dt><b>MSS0136</b></dt>
<dd>Global name already exists.
</dd>
<dt><b>MSS0137</b></dt>
<dd>Distribution catalog entry not added.
</dd>
<dt><b>MSS0138</b></dt>
<dd>Object, file member, folder or document does not exist.
</dd>
<dt><b>MSS0139</b></dt>
<dd>Library *LIBL not valid when local storage location is *STD.
</dd>
<dt><b>MSS013A</b></dt>
<dd>Member *FIRST not valid when local storage location is *STD.
</dd>
<dt><b>MSS013B</b></dt>
<dd>Catalog entry already exists for document &amp;1.
</dd>
<dt><b>MSS013C</b></dt>
<dd>Catalog entry already exists for the folder.
</dd>
<dt><b>MSS013D</b></dt>
<dd>Object not loaded into distribution repository.
</dd>
<dt><b>MSS014E</b></dt>
<dd>Value &amp;2 for OBJ is more than 8 characters.
</dd>
<dt><b>MSS014F</b></dt>
<dd>&amp;1 is not an installable object.
</dd>
<dt><b>MSS0185</b></dt>
<dd>Stream file not loaded into distribution repository.
</dd>
<dt><b>MSS0188</b></dt>
<dd>Catalog entry already exists for the stream file.
</dd>
<dt><b>MSS019B</b></dt>
<dd>Description for object &amp;1 not found.
</dd>
<dt><b>MSS019D</b></dt>
<dd>Folder description not found.
</dd>
<dt><b>MSS01A1</b></dt>
<dd>Object type &amp;2 not supported.
</dd>
<dt><b>MSS01A6</b></dt>
<dd>Global name format is only valid for iSeries products.
</dd>
<dt><b>MSS01A7</b></dt>
<dd>Target release in global name token &amp;4 not supported.
</dd>
<dt><b>MSS01A9</b></dt>
<dd>Stream file not found.
</dd>
<dt><b>MSS01AA</b></dt>
<dd>Stream file cannot be accessed. Reason code &amp;1.
</dd>
<dt><b>MSS01D2</b></dt>
<dd>File not cataloged.
</dd>
<dt><b>MSS01D5</b></dt>
<dd>Match attribute &amp;4 for token &amp;3 not valid.
</dd>
<dt><b>MSS01D6</b></dt>
<dd>Length of global name token &amp;3 not valid.
</dd>
<dt><b>MSS01D7</b></dt>
<dd>Value of global name token &amp;3 not valid.
</dd>
<dt><b>MSS01D8</b></dt>
<dd>Global name not valid.
</dd>
<dt><b>MSS01DA</b></dt>
<dd>Version attribute &amp;4 for token &amp;3 not valid.
</dd>
<dt><b>MSS01E1</b></dt>
<dd>Library must be QSYS or *LIBL.
</dd>
<dt><b>MSS01FB</b></dt>
<dd>Object specified does not contain a product.
</dd>
<dt><b>MSS01FC</b></dt>
<dd>Global name not valid for product.
</dd>
<dt><b>MSS01FE</b></dt>
<dd>Target release &amp;1 not valid.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDSTCLGE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue Copy Permalink