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
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
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
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
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
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.
- 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.
- 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.
- 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.
- 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
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:- 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.
- 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.