Display Comm Side Information (DSPCSI)

The Display Communications Side Information (DSPCSI) command is used to display or print the specified side information object.

Parameters

Keyword Description Choices Notes
CSI Side information Qualified object name Required, Positional 1
Qualifier 1: Side information Name
Qualifier 2: Library Name, *LIBL, *CURLIB
OUTPUT Output *, *PRINT Optional

Side information (CSI)

Specifies the name of the side information object to be displayed. An object name must be specified.

This is a required parameter.

The possible library values are:

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library is used to locate the side information object. If no library is specified as the current library, QGPL is used.
library-name
Specify the name of the library where the side information object is located.
side-information-name
Specify the name of the object that contains the side information object.

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

The possible values are:

*
The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
*PRINT
The output is printed with the job's spooled output.

Examples

Example 1: Locating an Object

DSPCSI   CSI(SIDEOBJ)

This command locates the first side information object named SIDEOBJ in the library list and displays the side information.

Example 2: Printing Side Information

DSPCSI   CSI(QGPL/SIDEOBJ)  OUTPUT(*PRINT)

This command prints the side information contained in the object SIDEOBJ in library QGPL with the job's spooled output.

Error messages

*ESCAPE Messages

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.