Invoking DFSMSdss from Your Application Program

You can invoke DFSMSdss from an application program using the application interface. You can also invoke DFSMSdss to run in a separate address space by using the cross-memory application interface. This interface allows you, for example, to specify control variables, and to gather information on free and used space on a volume or in a data set. Any program that calls DFSMSdss must either be authorized by Authorized Program Facility (APF) or must invoke DFSMSdss using the cross-memory application interface. For more information on APF protection and authorization, see z/OS MVS Programming: Assembler Services Guide.

When you invoke DFSMSdss from an application program, you can provide a user interaction module (UIM) to interact with DFSMSdss during processing at various points. The UIM lets you perform the following tasks:

Replace, insert, delete, or modify a SYSIN record after DFSMSdss reads it, or a SYSPRINT record when DFSMSdss is ready to print it.
Replace, insert, delete, or modify a write-to-operator (WTO) message before DFSMSdss writes it.
Control processing and gather auditing information for an individual data set during a logical copy, dump, or restore.
Control processing for concurrent copy operations.
Insert statistical records during a logical dump.
Intercept records being dumped or supply records to be restored.