DSPBNDDIR (Display Binding Directory) Command Description

DSPBNDDIR Command syntax diagram

Purpose

The Display Binding Directory (DSPBNDDIR) command displays the contents of a binding directory.

Restrictions:

1. You must have *USE authority to the library where the binding directory is located.
2. You must have *OBJOPR authority and *READ authority to the binding directory.

Required Parameter

BNDDIR

Specifies the binding directory to be displayed.

The name of the binding directory 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.

*USRLIBL: Only the libraries in the user portion of the job's library list are searched.

library-name: Specify the name of the library to be searched.

binding-directory-name: Specify the name of the binding directory to be displayed.

Optional Parameters

OUTPUT

Specifies whether the output from the command is shown at the requesting workstation or printed with the job's spooled output. More information on this parameter is in commonly used parameters.

*: Output requested by an 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.

OUTFILE

Specifies the qualified name of the database file to which the output of the display is directed. If the OUTFILE does not exist, this command creates a database file in the specified library. The public authority of the file is the same as the create authority specified for the library in which the file is created. The record format of the output file is the same as that used in the IBM-supplied database file. The IBM-supplied database file and record format follows:

File

QABNDBND

Record Format

QBNDSPBD

The name of the database 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.

*USRLIBL: Only the libraries in the user portion of the job's library list are searched.

library-name: Specify the name of the library to be searched.

database-file-name: Specify the name of the database file that receives the output of the display.

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 in the OUTFILE parameter. If a member name is specified, but the member does not exist, the system creates it.

Element 1: Member to Receive Output

*FIRST: The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified on the OUTFILE parameter.

member-name: Specify the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it.

Element 2: Operation to Perform on Member

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

Example for DSPBNDDIR

DSPBNDDIR   BNDDIR(STORE)

This command displays a binding directory named STORE.

Error messages for DSPBNDDIR

*ESCAPE Messages

CPF5D01

Binding directory &1 in library &2 is not usable.

CPF980F

Binding directory &1 in library &2 not found.

CPF9801

Object &2 in library &3 not found.

CPF9802

Not authorized to object &2 in &3.

CPF9803

Cannot allocate object &2 in library &3.

CPF9807

One or more libraries in library list deleted.

CPF9808

Cannot allocate one or more libraries on library list.

CPF9810

Library &1 not found.

CPF9820

Not authorized to use library &1.

CPF9830

Cannot assign library &1.