CL Command Reference - ADDDSTCLGE
CL Command List > ADDDSTCLGE Reference
Description:
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.
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.
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.
Notes:
1. When the object type *LICKEY is specified, it is assumed that the file that is to be cataloged is a license key file.
2. A specific format to catalog a license key file or a stream file for a global name is not required.
3. A specific global name format is required to catalog an installable object.
Examples:
Example 1: Adding a Catalog Entry for a File
ADDDSTCLGE GLBNAME(ENTID FINANCE PAYROLL DEDUCT)
OBJTYPE(*FILE) OBJ(*LIBL/PAYDED) STGLOC(*STD)
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.
Example 2: Loading a File into the Repository for Filedata
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)
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.
Example 3: Loading a Document into the Repository for a Document
ADDDSTCLGE GLBNAME(ENTID NYPS1 SALESRPT) OBJTYPE(*DOC)
DLO(STATUS) FLR(NY/SALES.RPT/APRIL)
STGLOC(*DSTRPS)
This command loads document STATUS in folder path NY/SALES.RPT/APRIL into the distribution repository.
Example 4: Adding a Distribution Catalog Entry into the Repository for a Product
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¡¯)
This command adds an entry to the Distribution Catalog and points to a product stored in the distribution repository.
Example 5: Adding an Entry into the Distribution Catalog for a Product
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¡¯)
This command adds an entry for a product to the distribution catalog and points to the save file DSTLP in the library DSTSYSLIB.