Client Copier

Target client

You can create a new client in the client maintenance (transaction SCC4). Your user must be authorized in the target client, for the client copy.

The newly-created client contains the initial user SAP* with the password PASS, which you can use to copy a client.

Resource requirements

Copying clients requires a large amount of system resources. To avoid premature termination due to bottlenecks, ensure that enough resources are available by:

• Database storage space

  Perform a test run before copying a client. The total of copied and deleted data in kB is at the end of the log file.

  For ORACLE, INFORMIX, ADABAS, and DB2/CS databases, you can check the test run log to see whether there is sufficient database space available.

  Caution

  Storage requirements can only be estimated, because space already allocated, but not yet used, is not taken into account. A client without application data needs approximately 500 MB in the database. In most databases, space made free by deleting data is only available after a reorganization.

  Note

  For pool tables, the estimate is very imprecise, because their extent size is very large. You must assume that a new extent is required for each pool table, which must be added to the estimate.

• Runtime

  Copying a client can take several hours or even days. Users or background processes in clients other than the source or target clients, can make the time longer. For example, locks in a third client in the same system can delay the processing of objects. It is technically possible to work in the system during a client copy, but this should only be done in absolute emergencies, since this can cause inconsistencies.

  Caution

  You may have to increase the standard timeout value for these processes if you are working online with slow databases, large clients or clients with a lot of users:

  1. To increase the default timeout value, call the transaction Maintain Profile Parameters (RZ 11).

  2. Specify the profile parameter rdisp/max_wprun_time.

  3. Choose Display.

  4. Choose Change Value.

  5. Specify a new value for the profile parameter.

     We recommend a value of 2000 seconds.

  If you use parallel processes, dialog processes are used even if the job is scheduled in the background. The standard timeout value is usually sufficient. If the database is loaded by additional processes, it can be advisable to increase the profile parameter.

• System load

  Copying or transporting a client can take a long time because large amounts of data are moved. One or more dialog processes are occupied for this time. The database interface is heavily loaded.

Protecting Clients Against User Logons

• You must ensure that no users log on to the system during the copy. For technical reasons, only the target client is locked. If, for example, the lock is not reset after a copy is cancelled, you can reset it by calling the transaction SCC3 in any client.

  Caution

  Users who are in the target client before the start of the copy cannot be locked automatically, so you must ensure that they leave the system.

• The source and target clients should both be additionally protected by a system message (SM02). Monitor compliance in both clients (for example, in SM04)

• You should not work in the source client either during the copy.

Clean Up

If you want to use SAP Query in the new client, you must do some postprocessing. For further information, see SAP Query.

Restrictions

• You cannot access archived data in the target client if the target client number is not the same as the source client number.

• Change documents (tables CDHDR, PCDHDR, CDPOS, and PCDPOS): Change documents from user administration and logs from the generic log repository (application log tables BAL*) are not copied.