CL Command Reference - DSPDIRE
CL Command List > DSPDIRE Reference
Description:
The Display Directory Entries (DSPDIRE) command is used to display, print, or create a database file for some or all system distribution directory entries. The database file output is displayed, printed, or created based on the following:
. For displayed output, when the USRID or the USER parameters apply to more than one directory entry, the system provides a list of entries. When these parameters uniquely identify a directory entry, the system provides the details for the entry.
. For printed or database file output, if the USRID parameter specifies the full directory, the DETAIL parameter determines whether a list of the entries or the full details for each entry is the output. If the USRID or the USER parameters specify a user ID or profile, the full details for that user are sent to the output.
The DSPDIRE command does not update the directory. That function is provided interactively, with display support by the Work with Directory Entries (WRKDIRE) command, the Add Directory Entry (ADDDIRE) command, the Remove Directory Entry (RMVDIRE) command, the Change Directory Entry (CHGDIRE) command, and the Rename Directory Entry (RNMDIRE) command.
Examples:
Example 1: Showing the Display for One Description
DSPDIRE USRID(HURST NEWYORK)
This command shows the Display Directory Entry Details display for user ID and address HURST NEWYORK if this user ID has only one description associated with it. If more than one description exists, the Display Directory Entries display is shown with all entries for the user ID and address.
Example 2: Printing Directory Information
DSPDIRE USER(JONES) OUTPUT(*PRINT)
This command prints the full directory details for user profile JONES. If there is more than one description in the directory for JONES, the printed output contains each description.
Example 3: Sending Full Details to a Database File
DSPDIRE OUTPUT(*OUTFILE)
OUTFILE(MYLIB/DIRLIST) OUTMBR(*FIRST *REPLACE)
DETAIL(*FULL)
This command sends a record to the database file DIRLIST in library MYLIB for each entry in the directory. This record contains the full details for each user. The format of the output file is the one used prior to Release 3.0 because of the default of OUTFILFMT(*TYPE1). If the file does not exist, it is created. If the file does exist, it is replaced.
Example 4: Sending Basic Information to a Database File
DSPDIRE OUTPUT(*OUTFILE)
OUTFILE(MYLIB/DIRLIST) DETAIL(*BASIC)
OUTFILFMT(*TYPE2)
This command sends a record to the database file named DIRLIST in the MYLIB library for each entry in the directory. The data contains only the basic fields, user ID, address, and description. If the file named DIRLIST in the MYLIB library already exists for releases 1.0 or 2.0 data (see Example 2), an error occurs; otherwise, the file is be created in the Release 3.0 format.