DFSDFSRT

DFSDFSRT is a REXX program that starts the z/OS® Interactive Problem Control System (IPCS) with the IMS Dump Formatter.

Prerequisite: To provide access to the z/OS Interactive Problem Control System (IPCS) with the IMS Dump Formatter, include the IMS.SDFSEXEC data set in the SYSPROC DD concatenation.
Attention: Ensure that the IPCS is started before the IMS Application Menu is started. Otherwise, message DFSIX103 is displayed. See IMS Version 15.2 Installation for more information about the IMS Application Menu.

DFSDFSRT syntax

Read syntax diagramSkip visual syntax diagramDFSDFSRTHLQ( myhlq)ALTRESL(' hlq.data_set_ name1',' myhlq.data_set_ name2')

DFSDFSRT keyword parameters

DFSDFSRT
Command to start the IPCS with the IMS Dump Formatter.
HLQ
Keyword that enables you to specify the high-level qualifier of the IMS distribution data sets.

The HLQ parameter is required the first time you use the DFSDFSRT statement. If you do not specify a high-level qualifier, DFSDFSRT uses the most recently specified high-level qualifier. After the first required use, this parameter is optional.

myhlq
High-level qualifier of the IMS distribution data sets.
ALTRESL
Keyword that enables you to specify a list of data set names that contain load modules.

If you specify the ALTRESL parameter, you should include SDFSRESL in the list of data set names. If you do not specify the ALTRESL parameter, myhlq.SDFSRESL is used as the IPCS TASKLIB data set.

myhlq.data_set_ name1
Fully-qualified name of a data set that contains load modules.

Starting the z/OS IPCS with the IMS Dump Formatter

To start IPCS with the IMS Dump Formatter, use either of the following commands:
  • TSO %DFSDFSRT HLQ(myhlq)
  • EXEC 'IMS.SDFSEXEC(DFSDFSRT)' 'HLQ(myhlq)'

IRLM use of SDUMP

The IRLM uses the z/OS SDUMP program for dumping whenever its ESTAE or FRR routines are entered. SDUMP dumps are directed to the SYS1.DUMPxx data sets and printed using the IPCS service aid. SDUMP has the same advantages over the SYSABEND dump program as the spinoff dump program. The operator is told which data set contains the SDUMP by message IEA911E COMPLETE DUMP ON SYS1.DUMPxx.

Here are sample control statements for executing the IPCS program. 
 
 //SYSIN    DD    *
           NEWDUMP DD=INPUT
           FORMAT
           LOGDATA
           VTAMMAP
           IRLM  irlm.subsystem.name
           PRINT JOBNAME=(irlm.job.name)
           END

Related reading: For a description of the IPCS utility, see MVS/ESA Interactive Problem Control System (IPCS) Users Guide.