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.
- 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 |