STATISTICS

Use this keyword to specify the type and destination of compression statistics collected. If you omit this keyword, statistics are stored in the DPICDS .

Usage

Optional keyword valid only on the ADD, UPDATE, and REPLACE commands.

Note

SYSOUT options can only be modified by using the UPDATE command. The UPDATE command replaces all statistics parameters with information included in the UPDATE command statement.

Syntax

STAT(NONE)

or

STAT(value)

Default

STAT(CDS(Y))

Values

Enter NONE (to not collect or display statistics), or one or more of the following values:

Value

Description

CDS(Y|N)

To send statistics to the CDS, for example: STAT(CDS(Y)). If you select CDS(N), you must select one of the following:

  • STAT(LTERM(name))
  • STAT(MTO)
  • STAT(SYSOUT(param1(a),param2(b)))
  • STAT(WTO(param1(a),param2(b)))

LTERM(name)

To send statistics to the specified IMS logical terminal, for example: STAT(LTERM(ABC123))

MTO

To send statistics to the IMS master terminal, for example: STAT(MTO)

SYSOUT(param1(a)param2),(b)...)

To send statistics to SYSOUT as specified by the parameters listed below, for example: STAT(SYSOUT(DD(STATOUT)))

Note

To modify SYSOUT information, use the UPDATE command. UPDATE will use keywords as specified.

  • DD(ddname)

    The ddname of the SYSOUT data set to use if allocated in the JCL. When DD is specified, NODE, USERID, CLASS, and HOLD are ignored; statistical information is written to the SYSOUT data set only.

  • NODE(name)

    The system identifier for the system or printer to which the SYSOUT data set will be routed. This must be a valid system or printer ID. DATA PACKER/IMS does not verify this value. The default is NODE(LOCAL).

  • USERID(user)

    The user ID of the user to which the SYSOUT data set will be routed. This user ID becomes the OWNER of the statistics. This must be a valid TSO user ID. DATA PACKER/IMS does not verify this value. The default is the user ID associated with the job.

  • CLASS(class)

    The output class where statistics are routed if statistical information is to be routed to a specific class. When you do not specify CLASS, the job MSGCLASS is used. If the job does not specify MSGCLASS, the data center default is used.

  • HOLD(y/n)

    Indicates whether the statistical information should be retained in the held output queue. The default is HOLD(N).

WTO(param1(a), param2(b)...)

Sends messages to the specified WTO. The default is STAT(WTO(DESC(4,7),ROUTE(2,11))).

The following subparameters can be specified with the WTO value:

Value

Description

DESC(n) or DESC(n,n)

The WTO descriptor codes

ROUTE(n) or ROUTE(n,n)

The WTO route codes

CONSOLE(id)

The console ID of the system console. Defaults to the system-defined OS console.

Note

Consult with your MVS systems programmer for information on the appropriate route and descriptor codes to use.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*