Invoke the SMS IPCS Dump Formatter (SMSDATA) from the IPCS environment.
The syntax follows.
Command |
Parameters |
SMSDATA
|
[MAP | NOMAP]
|
|
[CONFIG{(ACTIVE | ALL)}]
|
|
[FORMAT(SUMMARY | ALL | ACS | DATACLAS |
MGMTCLAS | STORCLAS | STORGRP | VOLUMES |
BCD | ERTRE | ERTRT | ICMDS | ICMRT | OPSCR |
OPSRT | SSIAT | SSIVT)]
|
|
[TRACE]
|
|
[ASID(asid number)]
|
|
[SELECT{(ALL | ACSINT | ACSPRO | CATG | CDSC |
CONFA | CONFC | CONFR | CONFS | DCF | DEBUG
DISP | DPN | ERR | IDAX |
MODULE | MSG | OPCMD | RCD | SCHEDP | SCHEDS |
SMSSJF | SMSSSI | TVR |
VOLREF | VTOCA | VTOCC |
VTOCD | VTOCL | VTOCR)}]
|
|
[START(ddd,hh:mm:ss)]
|
|
[STOP(ddd,hh:mm:ss)]
|
|
[TADDR(ERTRE address)]
|
|
[STORAGE(IMC address,IMC asid,[DATA |
FLO | IMC])]
|
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.