Deleting an instance

You can delete an instance if it is no longer needed.

Important: Be careful to verify that the instance user profile, which is named the same as the instance, does not own objects that will still be required after the instance is deleted. Use the Work with Objects by Owner (WRKOBJOWN) command, specifying the instance name for the user profile (USRPRF) parameter, to review objects owned by the instance user profile. For any object that is still required after the instance is deleted, you must change the object owner to a different user profile. Then move the object, if necessary, to a library other than the library which is named the same as the instance you are deleting. Objects that are owned by the instance user profile and objects in the instance library are deleted when the instance is deleted.

If there are any output queues in the instance library that contain spooled files, you must move or delete the spooled files before you run the program to delete the instance.

To delete an instance, issue the following command from an IBM i command line:
CALL QRDARS/QRLCDLTINS PARM([instance])
where [instance] is the name of the Content Manager OnDemand instance you want to delete.
This program performs the following actions:
  1. Ends the instance server job if the server for the instance is started.
  2. Deletes the instance library, which is named the same as the instance.
  3. Deletes data stored in cache, disk pools (auxiliary storage pools (ASPs) or independent auxiliary storage pools (IASPs)), and user-defined file systems (UDFSs).
  4. Deletes the instance directory that contains all data stored in cache and in disk pools. The data that is deleted is located in IFS down the /QIBM/UserData/OnDemand/[instance] path, where [instance] is the name of the instance being deleted. If the instance is located in an IASP, the data that is deleted is located down the /[IASP name]/QIBM/UserData/OnDemand/[instance] path, where [IASP name] is the name of the IASP and [instance] is the name of the instance.
  5. Deletes the instance definition within file ARS.INI in directory /QIBM/UserData/OnDemand/config.
  6. Deletes the instance authorization list.
  7. Deletes the instance record from the Content Manager OnDemand table if you have created an instance in an IASP.
  8. Deletes the instance user profile (which has a name that matches the instance name).

This program does not delete data stored in cloud storage, NFS disk pools, on optical, or on tape. Data stored on any of these media types is no longer accessible after the instance is deleted, but the data itself is not deleted due to the significant amount of time it might take to delete potentially high volumes of data. If you require the actual data residing in cloud storage or in NFS disk pools to be deleted, you should delete the Content Manager OnDemand application group(s) to which the data belongs prior to deleting the instance. Data residing on an optical or tape volume can simply be removed from the system by removing the volume from the library, or deleted by reinitializing the tape or optical volume if you are sure that none of the data on the volume is needed.

When you call the program, you might receive message OND1012 indicating that some objects could not be deleted during the deletion of the instance. See the job log for previously listed messages. Correct the errors and call the program again.