Appendix A. Concurrent Copy 517
//SYSIN DD *
//*
COPY FULL -
INDYNAM ((CP11S3)) -
OUTDYNAM ((TP11S3)) -
COPYVOLID -
CC
ADR101I (R/I)-RI01 (01), TASKID 001 HAS BEEN ASSIGNED TO COMMAND 'COPY '
ADR109I (R/I)-RI01 (01), 2000.107 16:09:59 INITIAL SCAN OF USER CONTROL STATEMENTS
COMPLETED.
ADR016I (001)-RI01 (01), RACF LOGGING OPTION IN EFFECT FOR THIS TASK
ADR006I (001)-STEND(01), 2000.107 16:10:00 EXECUTION BEGINS
ADR241I (001)-DDTFP(01), TARGET VTOC BEGINNING AT 000550:0000 AND ENDING AT 000550:0014 IS
OVERLAID
ADR806I (001)-T0MI (02), VOLUME COPIED USING A FAST REPLICATION FUNCTION.
ADR734I (001)-T0MI (03), 2000.107 16:10:12 CONCURRENT COPY INITIALIZATION SUCCESSFUL FOR
VOLUME CP11S3. SERIALIZATION FOR THIS DATA
IS RELEASED IF DFSMSDSS HELD IT. THE INTERMEDIATE RETURN CODE IS
0000.
ADR320I (001)-SBRTN(01), VOLUME SERIAL TP11S3 ON UNIT D70C IS CHANGED TO CP11S3
ADR344I (001)-SBRTN(01), VOLSER ON UCB D70C IS A DUPLICATE. VOLUME MADE UNAVAILABLE.
ADR006I (001)-STEND(02), 2000.107 16:10:35 EXECUTION ENDS
ADR013I (001)-CLTSK(01), 2000.107 16:10:35 TASK COMPLETED WITH RETURN CODE 0000
ADR012I (SCH)-DSSU (01), 2000.107 16:10:35 DFSMSDSS PROCESSING COMPLETE. HIGHEST RETURN
CODE IS 0000
Invocation from an application program
When DFSMSdss is invoked from an application program, you can use the user interaction
module (UIM) to interact with DFSMSdss. For user interactions to take place, the application
must invoke DFSMSdss and must provide a pointer to a user interaction module (UIM) list.
DFSMSdss can be invoked by any of the following system macros:
ATTACH EP=ADRDSSU,PARAM=(OPTPTR,DDPTR,PAGEPTR,UIMPTR,UAPTR),VL=1
LINK EP=ADRDSSU,PARAM=(OPTPTR,DDPTR,PAGEPTR,UIMPTR,UAPTR),VL=1
CALL (15),(OPTPTR,DDPTR,PAGEPTR,UIMPTR,UAPTR),VL
When a UIM exit routine is specified, DFSMSdss processes normally, then at each point in
the process (DFSMSdss exit points), the UIM exit routine is called conditionally to allow some
types of user operations. The exit identification block is passed to the UIM every time
DFSMSdss gives control to it.
Among the exit points that are available with DFSMSdss (EIOPTION 1 to 26), DFSMSdss
calls the UIM with option code 24 (EIOPTION 24) to inform it that the initialization of the
Concurrent Copy session for a given data set or volume has completed. For full volume or
tracks operation, there is only one call (because there is only one input volume). For a
physical data set operation, there is one call for each input volume. For a logical data set
operation, there is one call for every data set.
DFSMSdss does not call the UIM with this option code, if the CONCURRENT keyword is not
specified. DFSMSdss provides the UIM with information through the EIREC24 structure
within the exit identification block, ADREIB (in the ADREID0 macro).
For a detailed description of the DFSMSdss interaction with the user interface module (UIM)
when invoking from an application program, refer to z/OS DFSMSdss Storage Administration
Reference, SC35-0424.