Previous Topic: DETACH CommandNext Topic: ELSE Statement


DISPLAY Command

The DISPLAY command displays information about CA‑L‑Serv and its servers.

Syntax

Display [[ACTIVE] [ALL] [INIT] [LOGS] [MSGTABLE] [OPTIONS] [SSNAME] [STORAGE]
        [VERSION]]
Display [TASK(COMMSERVER) [[ALL] [APPLICATIONS] [INIT] [OPTIONS]
        [ROUTES[(ACTIVE|INACTIVE)] ]... ]]
Display [TASK(FILESERVER) [[ALL] [BUFFERPOOL] [DATABASE [[DDNAME(ddname)]
        [GROUP(name)] [RESET]]] [OPTIONS] [STATISTICS [[DDNAME(ddname)]
        [RESET] [=SERVICE]]] [SYSTEMS]]]
Display [TASK(SQLSERVER) [[ALL] [OPTIONS] [STATISTICS] [TABLE]]]

Parameters

ACTIVE

Displays a list of active CA‑L‑Serv servers. (See message LDM0420I.)

ALL

Displays all available information for CA‑L‑Serv and its active servers. Use the TASK parameter to limit the display to a particular server.

APPLICATIONS

Displays a list of clients using the communications server and the number of send and receive requests from each client. (See message LDM0920I.)

BUFFERPOOL

Displays information about LSR buffer pools defined for files that CA‑L‑Serv is managing. (See message LDM0552I). For a discussion of the fields displayed, see CA-L-Serv administrating topics and the IBM Using Data Sets manuals.

DATABASE

Displays information about each file that CA‑L‑Serv is managing. Information includes options set through the ADDFILE command and the status of the file. (See message LDM0522I). By default, CA‑L‑Serv displays all managed files:

To display only one file, specify the name of the file name on the DDNAME parameter.

To display only one file group, specify a group ID on the GROUP parameter.

To display cumulative information and then reset the display, specify RESET.

INIT

Displays values that cannot be changed while the CA‑L‑Serv shell or a CA‑L‑Serv server is running. In response, CA‑L‑Serv issues a series of messages (one for the shell and one per applicable server). By default, all of these messages are displayed. To display values of only a certain server, specify the TASK parameter also.

LOGS

Displays status information about the CA‑L‑Serv message, trace, and change logs. Each log file is listed separately. (See message LDM0750I.)

MSGTABLE

Displays a list of message tables, what language each table is in, and how many messages each table contains. (See message LDM0422I.)

OPTIONS

Displays values that you can change while the CA‑L‑Serv shell or a CA‑L‑Serv server is running. In response, CA‑L‑Serv issues a series of messages (one for the shell and one per applicable server). By default, all of these messages are displayed.

Use the TASK parameter to limit the display to a particular server.

ROUTES

Displays information about VTAM and XCF communication routes associated with XMVS communication. (See message LDM0912I.)

By default, the display includes all routes.

To display only active routes, specify ROUTES(ACTIVE).

To display only inactive routes, specify ROUTES(INACTIVE).

SSNAME

Displays a list of subsystems (including CA‑L‑Serv) that are running on a local system. Status information for each subsystem is also shown. (See message LDM0410I).

STATISTICS

Displays information about I/O activity for VSAM files (in message LDM0546I) and SQL tables (in message LDM4080I).

By default, CA‑L‑Serv displays one line per file in the display of the file server. Information is cumulative, as of the last time the statistics display was reset. To change the display, specify one or more of these parameters:

To display only one file, specify the name of the file on the DDNAME parameter.

To display cumulative statistics and then reset the display, specify RESET.

To display an additional line that shows averages for all files, specify =SERVICE.

You can also use the TASK parameter to limit the display to the file server or the SQL server.

STORAGE

Displays information about storage use, including the size of a storage block, how many blocks were allocated, and how many blocks were used. (See message LDM0425I.)

SYSTEMS

Displays a list of systems where the file server is running. For each system, the display includes statistics about send and receive requests, what type of server is running, and how many times CA‑L‑Serv split and reassembled data to fit its data buffer. (See message LDM0555I.)

TABLE

Displays information about SQL relational tables. (See message LDM4521I.)

To limit the display to a particular table, specify the name of the table in place of name.

TASK

Limits the display to one of the CA‑L‑Serv servers. Use TASK with the INIT, OPTIONS, and/or STATISTICS parameters, or use TASK if you have an ambiguous truncation for a parameter.

Specify COMMSERVER, FILESERVER, or SQLSERVER.

VERSION

Displays the CA‑L‑Serv release and maintenance level. (See message LDM0402I.)

Note: Issue the DISPLAY command from the CA‑L‑Serv parameter data set or from a console.

Example

To display information about the DPMFVIF file:

DISPLAY DATABASE DDNAME(DPMFVIF)