IMS HP Image Copy address space considerations

IMS HP Image Copy consists of a single job that can be submitted by the user or a job scheduler, or initiated as a started task.

About this task

The job name is determined by the user. The authority is obtained from the user ID that is associated with the job. The user ID that is associated with the job requires CONTROL access to the RECON data sets, READ access to log and database data sets, and ALTER access to image copy data sets. When Advanced Image Copy Services of IMS HP Image Copy is used, it schedules the DFSMSdss program (server) in a different address space from the address space of IMS HP Image Copy and uses its application programming interface (API).

Advanced Image Copy Services of IMS HP Image Copy schedules the DFSMSdss program (server) and uses its application programming interface (API). The DFSMSdss server runs in a different address space from the address space of IMS HP Image Copy. When a batch job starts, it starts the DFSMSdss server address space. The server remembers which job started the server. While the server is running, it accepts other connections until the originating job ends. At the end of the originating job, the job notifies the server that it has finished and this notification alerts the server that it can stop. Until the DFSMSdss address space is stopped, the address space is reused by the DFSMSdss API.

You can also start the DFSMSdss server within IMS HP Image Copy jobs. When the server is started, the server can be used by other applications that run in the same system.

Tip: The DFSMSdss server address space simplifies the running of multiple jobs. Therefore, consider starting the DFSMSdss server address space in the system whenever possible.

Procedure

To start the DFSMSdss server address space within an IMS HP Image Copy job, follow these steps:

Create the following started task procedure and add it to SYS1.PROCLIB.

//********************************************************************  
//*   THIS PROCEDURE WILL CREATE AN APPROPRIATE DFSMSDSS CROSS       *  
//*   MEMORY SERVER TO BE USED WITH APPLICATIONS THAT INVOKE CROSS   *  
//*   MEMORY REQUESTING THE DEFAULT DFSMSDSS SERVER NAME.            *  
//*                                                                  *  
//*   TO USE, ENTER THE FOLLOWING AT A CONSOLE:                      *  
//*   START DFSMSDSS,PROG=ADRXMAIB                                   *  
//*                                                                  *  
//*   WHEN THE DFSMSDSS CROSS MEMORY SERVER IS NO LONGER REQUIRED    *  
//*   ISSUE THE FOLLOWING MODIFY COMMAND:                            *  
//*   F DFSMSDSS,STOP                                                *  
//*                                                                  *  
//********************************************************************  
//DFSMSDSS PROC PROG=IEFBR14  
//IEFPROC  EXEC PGM=&PROG,REGION=0M,TIME=1440,DYNAMNBR=1635

Start the DFSMSdss server address space by using either of the following methods:
- Issue the following command:
```
S DFSMSDSS,PROG=ADRXMAIB 
```
- Add the procedure as a started task in your IPL procedure.
When the DFSMSdss server address space is started, run the IMS HP Image Copy jobs.
When your IMS HP Image Copy jobs end, and if you want to stop the server address space, issue the following command:
```
   F DFSMSDSS,STOP
```