The SETUNI command modifies the z/OS Unicode environment. The functions are:

1. Add a conversion to the z/OS Unicode environment (SETUNI ADD)
2. Remove conversions from the z/OS Unicode environment (SETUNI DELETE)
3. Replace conversions in the z/OS Unicode environment (SETUNI REPLACE)
4. Compact the z/OS Unicode environment, to reclaim storage used by deleted conversions (SETUNI DELETE,INACTIVE)
5. Limit the amount of page-fixed storage available to the z/OS Unicode environment (SETUNI REALSTORAGE)
6. Load a z/OS Unicode image (SETUNI ADD,IMAGE)

For more information, see &ieag100t;.

The effect of each of these SETUNI commands is:

SETUNI ADD

Adds conversions to the z/OS Unicode environment. It locates the appropriate conversion tables in data set SYS1.SCUNTBL (or case conversion data in data set SYS1.SCUNLOCL). For character conversions, it also consults the knowledge base which contains information about each supported CCSID. Then it copies the required conversion data into the Unicode environment for use by the conversion services. This command has the same effect as dynamically loading a conversion into the Unicode environment. Multiple conversions may be added, one per technique letter. CCSID 01200 is handled by converting it to specific UTF-16 CCSIDs (13488, 17584, etc.).

Conversions loaded by iconv requests will not show any Syslog messages when they are loaded.

SETUNI DELETE

Removes conversions from the z/OS Unicode environment. Note however, that dynamic loading may very quickly load a new copy of the conversion. It is sometimes recommended that you delete conversions when installing service without IPL, but it is usually not necessary to delete conversions.

SETUNI REPLACE

Refreshes specific conversions by deleting and then reloading them. It is rarely necessary to replace conversions. It is sometimes recommended that you replace conversions when installing service without IPL, but it is usually not necessary to replace conversions.

SETUNI DELETE,INACTIVE

Reclaims storage from deleted conversions. It does this by re-arranging the existing conversions within the z/OS Unicode environment so that the space that had been used by deleted conversions can be used again. It is rarely necessary to delete inactive conversions.

SETUNI REALSTORAGE

Sets a maximum limit on the amount of page-fixed storage the z/OS Unicode environment is allowed to use. See the REALSTORAGE topic below for more information. As of z/OS release 1.8, conversions are not loaded into page-fixed storage by default. Use of SETUNI REALSTORAGE is not recommended.

SETUNI ADD,IMAGE

Loads all conversions contained within the specified Unicode image into the z/OS Unicode environment. As of z/OS release 1.7, Unicode images are no longer needed, but are still supported. Use of conversion images is not recommended. Use dynamic loading instead.

Some of these functions take a FORCE=YES parameter. This is to remind the operator that the function can disrupt z/OS Unicode Services callers by invalidating handles and the underlying conversion data.