Invoking the Storage Management Subsystem IPCS dump formatter (SMSDATA)

Invoke the SMS IPCS Dump Formatter (SMSDATA) from the IPCS environment. The syntax follows.

If you do not select any options, SMSDATA defaults to MAP and FORMAT(SUMMARY). If you select only the NOMAP parameter, SMSDATA defaults to FORMAT(SUMMARY).

The SMSDATA verb keywords and abbreviations are described in the following list:

MAP | NOMAP

Specifies whether the SMS module map (ERMAP) is to be formatted.

CONFIG(ACTIVE | ALL)

CON(ACTIVE | ALL)

Requests formatting of the SMS control blocks related to an SMS configuration in the storage management address space (SMAS). You may select either the active configuration or request all configurations in the SMAS. The following control blocks are related to an SMS configuration:

• ACOHD
• AGD
• AGN
• BCD
• DCD
• DRD
• LBD
• MCD
• OPSCR
• SCD
• SGD
• VLD

FORMAT

FOR

Requests formatting of SMS control blocks, either individually or in groups. The two available groups consist of control blocks related to the active configuration, and control blocks that are not related to the configuration, as cited in the following two lists.

Note: If you specify both the FORMAT and CONFIG options, SMSDATA only formats the control blocks once, under the "Configuration" section of the SMSDATA output.

SUMMARY

Requests formatting of the control blocks that are not related to the configuration.

ALL

Requests formatting of all control blocks, whether or not they are configuration related.

Select the control blocks related to the active configuration by specifying the applicable parameters from the following list.

ACS

Requests formatting of the ACS routine object table headers (ACOHD).

DATACLAS

Requests formatting of the data classes in the configuration (DCD).

MGMTCLAS

Requests formatting of the management classes in the configuration (MCD).

STORCLAS

Requests formatting of the storage classes in the configuration (SCD).

STORGRP

Requests formatting of the storage groups in the configuration (SGD).

VOLUMES

Requests formatting of the volume definitions in the configuration (VLD).

Select the control blocks that are not related to the configuration by specifying the applicable parameters from the following list:

• ERTRE
• ERTRT
• ICMDS (COMMDS)
• ICMRT
• OPSRT
• SSIAT
• SSIVT

TRACE

TR

Requests formatting of the SMS trace table.

Note: If TRACE is specified or implied and no other limiting parameters are supplied (for example, SELECT, ASID), then all of the trace records are formatted.

ASID(asid number)

Restricts formatting of trace records to those in which the home ASID is equal to the asid number you select (specified in decimal). Specifying ASID implies the TRACE option.

SELECT

SEL

Restricts formatting of trace records to those associated with one or more trace events selected from the following list. The valid trace events are the same as those that can be specified in SYS1.PARMLIB or on the SETSMS operator command. Specifying SELECT implies the TRACE option.

ACSINT

ACS services interfaces.

ACSPRO

Perform ACS processing.

ALL

All of the other options.

CATG

SMS catalog services.

CDSC

Control data set changes.

CONFA

Activate a new configuration.

CONFC

Configuration changes.

CONFR

Return data from an active configuration.

CONFS

Configuration services.

DCF

Device control facility.

DEBUG

Trace temporary trace points.

DISP

SMS disposition processing.

DPN

SMS device pool name selection subsystem interface.

DSTACK

SMS data stacking service.

ERR

SMS error recovery and recording services.

IDAX

SMS interpreter/dynamic allocation exit.

MODULE

All SMS module entries/exits.

MSG

SMS message services.

OPCMD

SMS operator commands.

RCD

SMS recording services and fast VTOC/VVDS access.

SCHEDP

SMS scheduling services (prelocate catalog orientation).

SCHEDS

SMS scheduling services (system selection).

SMSSJF

SJF interfaces.

SMSSSI

SSI interfaces.

TVR

SMS tape volume record update facility.

VOLREF

SMS VOLREF services.

VTOCA

VTOC/data set services (add a volume to a data set).

VTOCC

VTOC/data set services (create a new data set).

VTOCD

VTOC/data set services (delete existing data set).

VTOCL

VTOC/data set services (allocate existing data set).

VTOCR

VTOC/data set services (rename existing data set).

START(DDD,HH:MM:SS)

ST(DDD,HH:MM:SS)

Restricts formatting of trace records to those created at or after the specified time. Specifying START implies the TRACE option.

STOP(DDD,HH:MM:SS)

SP(DDD,HH:MM:SS)

Restricts formatting of trace records to those created at or before the specified time. Specifying STOP implies the TRACE option.

TADDR(ERTRE address)

TD(ERTRE address)

Allows the user to specify explicitly the location of the SMS trace table. If TADDR is not specified, SMSDATA locates the trace table using the globally owned SMS control blocks. Specifying TADDR implies the TRACE option.

STORAGE(IMC address,IMC ASID,DATA | FLO | IMC)

STO(IMC address,IMC ASID[,DATA | FLO | IMC])

The STORAGE option requests formatting of the control blocks that make up the automatic data areas used by the SMS modules. You must supply the address of the root control block (IMC) as the first positional parameter. If you do not supply the IMC ASID parameter, SMSDATA defaults to the SMAS ASID. The DATA, FLO, and IMC parameters are optional and nonpositional; you can select more than one. If you do not specify any of these parameters, SMS does not produce any output.

DATA

Requests formatting of the automatic data areas that were active when the dump was taken.

FLO

Requests formatting of the procedure flow trace table attached to the IMC. This table contains the names of the modules in the order they received control, and any applicable return and reason codes. Because the table is wraparound, it is most useful for determining module flow immediately before an error.

IMC

Requests formatting of all of the control blocks associated with the IMC whose address was specified. These control blocks are:

ERPTT

SMS procedure flow trace table.

ERRCA

SMS error recovery communications area.

IMC

SMS intermodule communications area.

SSISP

SMS automatic data area block header (only the fixed-length portion).

SSISS

SMS storage segment header (only the fixed-length portion).

When formatted using the IMC parameter, these control blocks receive no special formatting considerations as they do when formatted using the DATA or FLO options.