Display DST Catalog Entries (DSPDSTCLGE)

Where allowed to run: All environments (*ALL)
Threadsafe: No 		Parameters
Examples
Error messages

The Display Distribution Catalog Entry (DSPDSTCLGE) command allows the user to view information about distribution catalog entries.

Top

Parameters

Keyword Description Choices Notes
GLBNAME Global name Element list Optional, Positional 1
Element 1: Global name token 1 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 2: Global name token 2 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 3: Global name token 3 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 4: Global name token 4 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 5: Global name token 5 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 6: Global name token 6 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 7: Global name token 7 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 8: Global name token 8 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 9: Global name token 9 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 10: Global name token 10 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
OUTPUT Output *, *PRINT, *OUTFILE Optional
DETAIL Detail *BASIC, *FULL Optional
OUTFILE File to receive output Qualified object name Optional
Qualifier 1: File to receive output Name
Qualifier 2: Library Name, *LIBL, *CURLIB
OUTMBR Output member options Element list Optional
Element 1: Member to receive output Name, *FIRST
Element 2: Replace or add records *REPLACE, *ADD
Top

Global name token 1 (GLBNAME)

Specifies the tokens of the global name used to find the list of catalog entries to be displayed.

The possible values for token 1 are:

*ANY
The corresponding token value is ignored.
*HIGHEST
The catalog entry with the highest corresponding token value is selected.
*LOWEST
The catalog entry with the lowest corresponding token value is selected.
*NETID
The first global name token value is a network ID generated by the command from the network attributes.
*SERVER
This token is stored within the change request activity with the value &SERVER, and replaced by the short name of the change control server when the object is distributed.
*TARGET
This token is stored within the change request activity with the value &TARGET, and replaced by the short name of the target when the object is distributed.
*MDDATE
This token is stored within the change request activity with the value &DATE, and replaced when distributed by the date the object was last modified.
*MDTIME
This token is stored within the change request activity with the value &TIME, and replaced when distributed by the time the object was last modified.
global-name-token
Specify the first token of the global name.

The possible values for tokens 2 through 10 are:

*ANY
The corresponding token value is ignored.
*HIGHEST
The catalog entry with the highest corresponding token value is selected.
*LOWEST
The catalog entry with the lowest corresponding token value is selected.
*NETID
The global name token n value is a network ID. This value is generated from the network attributes.
*CPNAME
The global name token value is a control point name. This value is generated from the network attributes.
*SERVER
This token is stored within the change request activity with the value &SERVER, and replaced by the short name of the change control server when the object is distributed.
*TARGET
This token is stored within the change request activity with the value &TARGET, and replaced by the short name of the target when the object is distributed.
*MDDATE
This token is stored within the change request activity with the value &DATE, and replaced when distributed by the date the object was last modified.
*MDTIME
This token is stored within the change request activity with the value &TIME, and replaced when distributed by the time the object was last modified.
global-name-token
Specify a token of the global name.
Top

Output (OUTPUT)

Specifies whether the output from the command is shown at the requesting workstation, printed with the job's spooled output, or directed to a database file.

*
Output requested by interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.
*PRINT
The output is printed with the job's spooled output.
*OUTFILE
The output is directed to the database file specified on the OUTFILE parameter. All data is written to the output file regardless of the value specified on the DETAIL keyword.
Top

Detail (DETAIL)

Specifies which set of information is shown for each catalog entry. This parameter is valid only when OUTPUT(*PRINT) is specified.

*BASIC
A list of global names found in the search is printed.
*FULL
All of the catalog entry information found in the search is printed.
Top

File to receive output (OUTFILE)

Specifies the qualified name of the database file to which the output of the display is directed. If the output file does not exist, this command creates a database file in the specified library.

The name of the output file can be qualified by one of the following library values:

*LIBL
All libraries in the job's library list are searched until the first match is found.
*CURLIB
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.
library-name
Specify the name of the library to be searched.
outfile-name
Specify the name of the database to be used.
Top

Output member options (OUTMBR)

Specifies the name of the database file member to which the output of the display is directed. If a member already exists, and *REPLACE is specified, the system clears it and adds the new records. If the member does not exist and a member name is not specified, the system creates a member with the name of the file specified on the OUTFILE parameter. If the member name is specified, but the member does not exist, the system creates it.

The possible member to receive output values are:

*FIRST
The first member in the file receives the output.
member-name
Specify the name of the member to receive the output.

The possible operation to perform on member values are:

*REPLACE
The system clears the existing member and adds the new records.
*ADD
The system adds the new records to the end of the existing records.
Top

Examples

Example 1: Displaying All Catalog Entries 

DSPDSTCLGE

This command displays all of the catalog entries.

Example 2: Displaying Global Catalog Entries 

DSPDSTCLGE   GLBNAME(ABACO *HIGHEST ZONEA *LOWEST)  OUTPUT(*)

This command displays the catalog entry for the global name selected.

Example 3: Storing Catalog Information 

DSPDSTCLGE   GLBNAME(ABACO *HIGHEST LOGO *LOWEST)
             OUTPUT(*OUTFILE)  OUTFILE(MYLIB/MYFILE)

This command sends all information for all of the catalog entries meeting the selection criteria to the output file MYLIB/MYFILE.

Example 4: Displaying Catalog Entry Information

This example displays catalog entry information for an entry cataloged with *SERVER, *TARGET, *MDDATE and *MDTIME tokens. 

DSPDSTCLGE   GLBNAME(CMPNY1 SALES *SERVER *TARGET *MDDATE
               *MDTIME)  OUTPUT(*)

This command displays the catalog entry information for the global name CMPNY1 SALES &SERVER &TARGET &DATE &TIME

Top

Error messages

*ESCAPE Messages

CPF9845
Error occurred while opening file &1.
CPF9846
Error while processing file &1 in library &2.
CPF9860
Error occurred during output file processing.
CPF9871
Error occurred while processing.
MSS0114
Not authorized to distribution catalog.
MSS0116
Maximum global name length exceeded.
MSS0117
Global name token &3 not valid. Reason code &4.
MSS011B
Distribution catalog entry not found.
MSS011C
Distribution catalog not available.
MSS0123
Internal processing error occurred.
MSS0124
Error while managing distribution catalog.
MSS0125
Distribution catalog damaged.
MSS0909
Error while accessing change control server data base.
Top