Parameters

The parameters are:

ADD,FROM(xxxxx),TO(yyyyy)[,TECHNIQUE | TECH(zzzzzzzz)] [,PAGEFIX(YES|NO)][,DSNAME | DSN(dsname)][,VOLSER | VOL(volser )]
Adds specific conversion resources to the Unicode environment.
xxxxx
Specifies the source CCSID of the character conversion table to be added. xxxxx is a five-character name that identifies the table.
yyyyy
Specifies the target CCSID of the character conversion table to be added. yyyyy is a five-character name that identifies the table.
zzzzzzzz
Specifies the technique search order for the character conversion table to be added. zzzzzzzz is an eight-character alphanumeric field. Possible values are one or more of the following:
R
Roundtrip conversion
E
Enforced subset conversion
C
Customized conversion
L
Language Element-behavior conversion
M
Modified for special use conversion
0-9
User-defined conversions
See z/OS Unicode Services User's Guide and Reference for additional information on techniques.
Note: You may get different results for different orders of the techniques placed in the zzzzzzzz field.
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
Example:
SETUNI ADD,FROM=1200,TO=37,TECH=ER,DSN=SYS1.SCUNTBL,VOL=XLAD01
ADD,CASE([LOCAL | SPECIAL | NORMAL])[,UNIVER(univer)][,PAGEFIX(YES|NO)][,DSNAME | DSN(dsname)][,VOLSER | VOL(volser )]
Adds the character case conversion tables to the Unicode environment. Local, Special, and Normal are optional and can be defined in the same statement only once.
univer
Specifies the Unicode standard version to be loaded. Valid values are:
  • UNI300
  • UNI301
  • UNI320
  • UNI401
  • UNI410
  • UNI500
  • UNI600
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
Example:
SETUNI ADD,CASE,DSN=SYS1.SCUNTBL,VOL=XLAD01
ADD,NORMALIZE | NORM ([normver])[,PAGEFIX(YES|NO)][,DSNAME | DSN(dsname)][,VOLSER | VOL(volser )]
Adds the normalization tables to the Unicode environment.
normver
Specifies the Unicode standard table version to be loaded. Possible values are one of the following:
  • UNI301
  • UNI320
  • UNI401
  • UNI410
  • UNI600
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
ADD,COLLATE | COLL([UCAver])[,PAGEFIX(YES|NO)][,DSNAME | DSN(dsname)] [,VOLSER | VOL(volser )] [[,LOCALE(locale)[,DSNAME(dsname)] [,VOLUME|VOL(volser)]] | [,COLRULES(colrules) [,DSNAME(dsname)] [,VOLUME|VOL(volser)]]]
Adds the collation tables to the Unicode environment.
UCAver
Specifies the Unicode Collation Algorithm (UCA) versions . Possible values are one or more of the following:
  • UCA301
  • UCA400R1
  • UCA410
  • UCA600
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
locale
Specifies the local member name where collation rules are to be loaded.
colrules
Specifies the User Collation Rules (UCR) member name where collation rules are to be loaded.
ADD,IMAGE=zzzzzzzz[,PAGEFIX(YES|NO)][,DSNAME | DSN(dsname)][,VOLSER | VOL(volser )]
Adds an image to the Unicode environment, whether the image is a member of the parmlib concatenation. If the image specified already exists in storage, the table is not added.
zzzzzzzz
Specifies the name of the conversion image to be added. The image member specified must be present in SYS1.PARMLIB or in another data set in the logical parmlib concatenation.zzzzzzzz is an eight-character alphanumeric field.

Value Range: any valid z/OS® member name

Example: IMAGE=CUNUNI01

Note: When an image is loaded with the IMAGE statement, the existing table in the Unicode environment are not replaced; only those tables that are not currently available in the Unicode environment are loaded from the Image.
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
ADD,STRPROFILE=NAME[,PAGEFIX(YES|NO)][,DSNAME | DSN(dsname)] [,VOLSER | VOL(volser)]
Adds the profile to the Unicode environment.
dsname
Specifies the name of the data set that contains the specific locale source file.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
ADD,BLDLOCALE|BLDLOC=locname[,CCSID(nnnnn)][,TECHNIQUE|TECH(zzzzzzzz)] [,PAGEFIX(YES|No)][,DSNAME|DSN(dsname)][,VOLSER|VOL(volser)]]
Adds locales to the Unicode environment.
locname
Specifies the locale name to be added. The locale name is case sensitive and is converted to uppercase unless it is specified inside single quotes, as in the following example:
SETUNI ADD,BLDLOC='en_US'
nnnnn
Specifies the CCSID of the locale to be added.
zzzzzzzz
Specifies the technique search order for the character conversion table to be added. zzzzzzzz is an eight-character alphanumeric field. Possible values are one or more of the following:
R
Roundtrip conversion
E
Enforced subset conversion
C
Customized conversion
L
Language Element-behavior conversion
M
Modified for special use conversion
0-9
User-defined conversions
See z/OS Unicode Services User's Guide and Reference for additional information on techniques.
Note: You may get different results for different orders of the techniques placed in the zzzzzzzz field.
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
DELETE,FROM(xxxxx),TO(yyyyy)[,TECHNIQUE | TECH(zzzzzzzz)],FORCE(YES)
Remove specific tables from the Unicode environment.
xxxxx
Specifies the source CCSID of the character conversion table to be removed. xxxxx is a five-character name that identifies the table to be removed.
yyyyy
Specifies the target CCSID of the character conversion table to be removed. yyyyy is a five-character name that identifies the table to be removed.
zzzzzzzz
Specifies the technique search order for the character conversion table to be removed. zzzzzzzz is an eight-character alphanumeric field. Possible values are one or more of the following:
R
Roundtrip conversion
E
Enforced subset conversion
C
Customized conversion
L
Language Element-behavior conversion
M
Modified for special use conversion
0-9
User-defined conversions
See z/OS Unicode Services User's Guide and Reference for additional information on techniques.
If no technique search order is specified, the default is RECLM.
Note: You may get different results for different orders of the techniques placed in the zzzzzzzz field.
FORCE(YES)
Specifies that the system will not check whether applications are currently using the tables. The storage occupied by the tables will be returned to the system.

FORCE(YES) is a required parameter.

DELETE,CASE([LOCAL|SPECIAL|NORMAL])[,UNIVER(univer)],FORCE(YES)
Removes the character case conversion tables from the Unicode environment. Local, Special, and Normal are optional and can be defined in the same statement only once.
univer
Specifies the Unicode standard version to be loaded. Valid values are:
  • UNI300
  • UNI301
  • UNI320
  • UNI401
  • UNI410
  • UNI500
  • UNI600
FORCE(YES)
Specifies that the system will not check whether applications are currently using the tables. The storage occupied by the tables will be returned to the system.

FORCE(YES) is a required parameter.

DELETE,NORMALIZE|NORM([normver]),FORCE(YES)
Removes the normalization tables from the Unicode environment.
normver
Specifies the Unicode standard table version to be deleted. Possible values are one of the following:
  • UNI301
  • UNI320
  • UNI401
  • UNI410
  • UNI600
FORCE(YES)
Specifies that the system will not check whether applications are currently using the tables. The storage occupied by the tables will be returned to the system.

FORCE(YES) is a required parameter.

DELETE,COLLATE|COLL([UCAver]) [[,LOCALE(locale)]|[,COLRULES(colrules)]],FORCE(YES)
Removes the collation tables from the Unicode environment.
UCAver
Specifies the Unicode Collation Algorithm (UCA) versions . Possible values are one or more of the following:
  • UCA301
  • UCA400R1
  • UCA410
  • UCA600
locale
Specifies the local member name where collation rules are to be loaded.
colrules
Specifies the User Collation Rules (UCR) member name where collation rules are to be loaded.
FORCE(YES)
Specifies that the system does not check whether applications are currently using the tables. The storage occupied by the tables is returned to the system.

FORCE(YES) is a required parameter.

DELETE,STRPROFILE=NAME[,DSNAME|DSN(dsname)][,VOLSER|VOL(volser)]
Removes the profile from the Unicode environment.
dsname
Specifies the name of the data set that contains the specific locale source file.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
DELETE,BLDLOCALE|BLDLOC=locname[,CCSID(nnnnn)][,TECHNIQUE|TECH(zzzzzzzz)]
Deletes locales from the Unicode environment.
locname
Specifies the locale name to be deleted.
nnnnn
Specifies the CCSID of the locale to be deleted.
zzzzzzzz
Specifies the technique search order for the character conversion table to be deleted. zzzzzzzz is an eight-character alphanumeric field. Possible values are one or more of the following:
R
Roundtrip conversion
E
Enforced subset conversion
C
Customized conversion
L
Language Element-behavior conversion
M
Modified for special use conversion
0-9
User-defined conversions
See z/OS Unicode Services User's Guide and Reference for additional information on techniques.
Note: You may get different results for different orders of the techniques placed in the zzzzzzzz field.
REPLACE,FROM(xxxxx),TO(yyyyy)[,TECHNIQUE|TECH(zzzzzzzz)] [,PAGEFIX(YES|NO)][,DSNAME|DSN(dsname)] [,VOLSER|VOL(volser)][,FREE(NO|YES,FORCE)]
Replaces specific tables that might be currently in the Unicode environment. If a table to be replaced is not in storage, the system adds the table.
xxxxx
Specifies the source CCSID of the conversion table to be replaced. xxxxx is a five-character name that identifies the conversion table.
yyyyy
Specifies the target CCSID of the conversion table to be replaced. yyyyy is a five-character name that identifies the conversion table.
zzzzzzzz
Specifies the technique search order for the conversion table to be replaced. zzzzzzzz is an eight-character alphanumeric field. Possible values are one or more of the following:
R
Roundtrip conversion
E
Enforced subset conversion
C
Customized conversion
L
Language Element-behavior conversion
M
Modified for special use conversion
0-9
User-defined conversions
See z/OS Unicode Services User's Guide and Reference for additional information on techniques.
If no technique search order is specified, the default is RECLM.
Note: You may get different results for different orders of the techniques placed in the zzzzzzzz field.
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
FREE
Specifies whether the storage associated with the table is to be released.
NO
Unicode will not release the storage associated with the table.
YES,FORCE
Release the storage associated with the table. The system does not check whether applications are currently using the tables.
When FREE is not specified, the default is NO.
REPLACE,CASE([LOCAL|SPECIAL|NORMAL])[,UNIVER(univer)][,PAGEFIX(YES|NO)] [,DSNAME|DSN(dsname)][,VOLSER|VOL(volser)] [,FREE(NO|YES,FORCE)]
Replaces the character case conversion tables currently in the Unicode environment. Local, Special, and Normal are optional and can be defined in the same statement only once.
univer
Specifies the Unicode standard version to be loaded. Valid values are:
  • UNI300
  • UNI301
  • UNI320
  • UNI401
  • UNI410
  • UNI500
  • UNI600
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
FREE
Specifies whether the storage associated with the table is to be released.
NO
Unicode will not release the storage associated with the table.
YES,FORCE
Release the storage associated with the table. The system does not check whether applications are currently using the tables.
When FREE is not specified, the default is NO.
REPLACE,NORMALIZE|NORM([normver])[,PAGEFIX(YES|NO)][,DSNAME|DSN(dsname)] [,VOLSER|VOL(volser)][,FREE(NO|YES,FORCE)]
Replaces the normalization tables currently in the Unicode environment.
normver
Specifies the Unicode standard table version to be replaced. Possible values are one of the following:
  • UNI301
  • UNI320
  • UNI401
  • UNI410
  • UNI600
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
FREE
Specifies whether the storage associated with the table is to be released.
NO
Unicode will not release the storage associated with the table.
YES,FORCE
Release the storage associated with the table.
When FREE is not specified, the default is NO.
REPLACE,COLLATE|COLL([UCAver])[,PAGEFIX(YES|NO)][,DSNAME|DSN(dsname)] [,VOLSER|VOL(volser )][[,LOCALE(locale)[,DSNAME(dsname)] [,VOLUME|VOL(volser)]] | [,COLRULES(colrules)[,DSNAME(dsname)] [,VOLUME|VOL(volser)]]] [,FREE(NO|YES,FORCE)]
Replaces the collation tables currently in the Unicode environment.
UCAver
Specifies the Unicode Collation Algorithm (UCA) versions . Possible values are one or more of the following:
  • UCA301
  • UCA400R1
  • UCA410
  • UCA600
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
locale
Specifies the local member name where collation rules are to be loaded.
colrules
Specifies the User Collation Rules (UCR) member name where collation rules are to be loaded.
FREE
Specifies whether the storage associated with the table is to be released.
NO
Unicode will not release the storage associated with the table.
YES,FORCE
Release the storage associated with the table.
When FREE is not specified, the default is NO.
REPLACE,STRPROFILE=NAME[,PAGEFIX(YES|NO)][,DSNAME|DSN(dsname)] [,VOLSER|VOL(volser)]
Replaces the current profile in the Unicode environment.
dsname
Specifies the name of the data set that contains the specific locale source file.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
REPLACE,BLDLOCALE|BLDLOC=locname[,CCSID(nnnnn)][,TECHNIQUE|TECH(zzzzzzzz)] [,PAGEFIX(YES|No)][,DSNAME|DSN(dsname)][,VOLSER|VOL(volser)]]
Replaces locales in the Unicode environment.
locname
Specifies the locale name to be replaced.
nnnnn
Specifies the CCSID of the locale to be replaced.
zzzzzzzz
Specifies the technique search order for the character conversion table to be replaced. zzzzzzzz is an eight-character alphanumeric field. Possible values are one or more of the following:
R
Roundtrip conversion
E
Enforced subset conversion
C
Customized conversion
L
Language Element-behavior conversion
M
Modified for special use conversion
0-9
User-defined conversions
See z/OS Unicode Services User's Guide and Reference for additional information on techniques.
Note: You may get different results for different orders of the techniques placed in the zzzzzzzz field.
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must have similar characteristics as the SYS1.SCUNTBL data set provided. The size of the data set can be unequal.

If no dsname is specified, SYS1.SCUNTBL is used as the default.

volser
Specifies the volume serial number of the device on which the tables are to be loaded. volser can be from one- to six-characters.
REALSTORAGE nnnnnn[K | M | G] [;]
Defines the upper storage limit, in pages, to be used by the conversion environment. For information about the amount of storage required for a conversion environment, see z/OS Unicode Services User's Guide and Reference .

Value Range: 0 to 524287

Example:
REALSTORAGE 0;      /* no explicit limit */
REALSTORAGE 12800;  /* 50 MB limit */
Note:
  1. The request to load a new conversion environment will be rejected when the value of the REALSTORAGE keyword is lower than the amount of storage needed.
  2. The selection of '0' results in no limit (=524287).
DELETE mode
Deletes partially or completely the Unicode environment.
INACTIVE
Deletes all the unreferenced control entries within the current Unicode environment and reorganizes the Unicode environment to eliminate storage gaps in it.

The string literal INACTIVE must be specified.

Note: Unreferenced control entries are entities that contain data of the current supported tables and can be obtained while replacing or deleting tables from the Unicode environment.
ALL
Deletes the whole Unicode environment. This deletes all control structures and resources. In addition, the ENQ of SYS1.SCUNTBL and SYS1.SCUNLOCL will also be released, if they were enqueued.
Note: FORCE(YES) is required for this keyword.
FORCE(YES)
Specifies that the system will not check whether applications are currently using the tables. The storage occupied by the tables will be returned to the system.

FORCE(YES) is a required parameter.

Example 1: 
DELETE INACTIVE;
Example 2: 
DELETE ALL,FORCE(YES)
Note: DELETE mode commands are intended for Unicode environment maintenance only. No Unicode calls should be running in the Unicode environment during the execution of these commands.
Parent topic: SETUNI command