Statements/parameters for CUNUNIxx

ADD FROM(xxxxx) TO(yyyyy) [TECHNIQUE | TECH(zzzzzzzz)] [PAGEFIX(YES|NO)][DSNAME | DSN(dsname)][VOLSER | VOL(volser )]
Adds specific tables to the Unicode environment.
xxxxx
Specifies the source CCSID of the character conversion tables to be added. xxxxx is a 1- through 5-character name that identifies the tables.
yyyyy
Specifies the target CCSID of the character conversion tables to be added. yyyyy is a 1- through 5-character name that identifies the tables.
zzzzzzzz
Specifies the technique search order for the character conversion tables to be removed. zzzzzzzz is a 1- through 8-character alphanumeric field. Possible values are one or more of the following:
  • R - Roundtrip conversion
  • E - Enforced subset conversion
  • C - Customized conversion
  • L - Language Environment-Behavior conversion
  • Start of changeM - Modified for special use conversionEnd of change
  • 0-9 - User-defined conversions
Start of changeSee z/OS Unicode Services User's Guide and Reference for additional information on techniques.End of change

If no technique search order is specified, the default is RECLM.

Note: Start of changeYou may get different results for different orders of the techniques placed in the zzzzzzzz field.End of change
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must contain the same features as the official tables repository, for example, the SYS1.SCUNTBL. The size of the data set can be decided according to users' requirements. 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 1- through 6-characters.
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 contain the same features as the official tables repository, for example, the SYS1.SCUNTBL. The size of the data set can be decided according to users' requirements. 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 1- through 6-characters.
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
  • Start of changeUNI600End of change
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must contain the same features as the official tables repository, for example, the SYS1.SCUNTBL. The size of the data set can be decided according to users' requirements. 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 1- through 6-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 contain the same features as the official tables repository, for example, the SYS1.SCUNTBL. The size of the data set can be decided according to users' requirements. 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 1- through 6-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, where the image is a member of the parmlib concatenation. If the image specified already exists in storage, the tables are 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.

When an image is loaded with the ADD,IMAGE statement, the existing tables 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 contain the same features as the official tables repository, for example, the SYS1.SCUNTBL. The size of the data set can be decided according to users' requirements. 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 1- through 6-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 tables.

The specified dsname must contain the same features as the official tables repository, for example, the SYS1.SCUNTBL. The size of the data set can be decided according to users' requirements.

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 1- through 6-characters.
Start of changeADD BLDLOCALE|BLDLOC=locname[,CCSID(nnnnn)][,TECHNIQUE|TECH(zzzzzzzzz)] [,PAGEFIX(YES|No)][,DSNAME|DSN(dsname)][,VOLSER|VOL(volser)]]End of change
Start of changeAdds locales to the Unicode environment.
Start of changelocnameEnd of change
Start of changeSpecifies the locale name to be added. The locale name is case sensitive and is converted to uppercase unless it is specified inside single quotes.End of change
Start of changennnnnEnd of change
Start of changeSpecifies the CCSID of the locale to be added.End of change
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 Environment-Behavior conversion
  • Start of changeM - Modified for special use conversionEnd of change
  • 0-9 - User-defined conversions
Start of changeSee z/OS Unicode Services User's Guide and Reference for additional information on techniques.End of change
Note: Start of changeYou may get different results for different orders of the techniques placed in the zzzzzzzz field.End of change
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.
End of change
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 tables to be removed. xxxxx is a 1- through 5-character name that identifies the tables.
yyyyy
Specifies the target CCSID of the character conversion tables to be removed. yyyyy is a 1- through 5-character name that identifies the tables.
zzzzzzzz
Specifies the technique search order for the character conversion tables to be removed. zzzzzzzz is a 1- through 8-character alphanumeric field. Possible values are one or more of the following:
  • R - Roundtrip conversion
  • E - Enforced subset conversion
  • C - Customized conversion
  • L - Language Environment-Behavior conversion
  • Start of changeM - Modified for special use conversionEnd of change
  • 0-9 - User-defined conversions
Start of changeSee z/OS Unicode Services User's Guide and Reference for additional information on techniques.End of change

If no technique search order is specified, the default is RECLM.

Note: Start of changeYou may get different results for different orders of the techniques placed in the zzzzzzzz field.End of change
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 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 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 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
  • Start of changeUNI600End of change
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 COLLATE | COLL([UCAver])[[LOCALE(locale)] | [COLRULES(colrules)]], FORCE(YES)
Removes 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
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 tables.

The specified dsname must contain the same features as the official tables repository, for example, the SYS1.SCUNTBL. The size of the data set can be decided according to users' requirements. 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 1- through 6-characters.
Start of changeDELETE BLDLOCALE|BLDLOC=locname[,CCSID(nnnnn)][,TECHNIQUE|TECH(zzzzzzzzz)]End of change
Start of changeDeletes locales from the Unicode environment.
Start of changelocnameEnd of change
Start of changeSpecifies the locale name to be deleted.End of change
Start of changennnnnEnd of change
Start of changeSpecifies the CCSID of the locale to be deleted.End of change
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 Environment-Behavior conversion
  • Start of changeM - Modified for special use conversionEnd of change
  • 0-9 - User-defined conversions
Start of changeSee z/OS Unicode Services User's Guide and Reference for additional information on techniques.End of change
Note: Start of changeYou may get different results for different orders of the techniques placed in the zzzzzzzz field.End of change
End of change
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 character conversion tables to be replaced. xxxxx is a 1- through 5-character name that identifies the tables.
yyyyy
Specifies the target CCSID of the character conversion tables to be replaced. yyyyy is a 1- through 5-character name that identifies the tables.
zzzzzzzz
Specifies the technique search order for the character conversion tables to be removed. zzzzzzzz is a 1- through 8-character alphanumeric field. Possible values are one or more of the following:
  • R - Roundtrip conversion
  • E - Enforced subset conversion
  • C - Customized conversion
  • L - Language Environment-Behavior conversion
  • Start of changeM - Modified for special use conversionEnd of change
  • 0-9 - User-defined conversions
Start of changeSee z/OS Unicode Services User's Guide and Reference for additional information on techniques.End of change

If no technique search order is specified, the default is RECLM.

Note: Start of changeYou may get different results for different orders of the techniques placed in the zzzzzzzz field.End of change
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must contain the same features as the official tables repository, for example, the SYS1.SCUNTBL. The size of the data set can be decided according to users' requirements. 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 1- through 6-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. When FREE is not specified, the default is NO.
(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 contain the same features as the official tables repository, for example, the SYS1.SCUNTBL. The size of the data set can be decided according to users' requirements. 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 1- through 6-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. When FREE is not specified, the default is NO.
(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
  • Start of changeUNI600End of change
dsname
Specifies the name of the data set that contains the specific tables.

The specified dsname must contain the same features as the official tables repository, for example, the SYS1.SCUNTBL. The size of the data set can be decided according to users' requirements.

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 1- through 6-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. When FREE is not specified, the default is NO.
(YES,FORCE)
Release the storage associated with the table. The system does not check whether applications are currently using the tables.
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 contain the same features as the official tables repository, for example, the SYS1.SCUNTBL. The size of the data set can be decided according to users' requirements. 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 1- through 6-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. When FREE is not specified, the default is NO.
(YES,FORCE)
Release the storage associated with the table. The system does not check whether applications are currently using the tables.
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 tables.

The specified dsname must contain the same features as the official tables repository, for example, the SYS1.SCUNTBL. The size of the data set can be decided according to users' requirements. 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 1- through 6-characters.
Start of changeREPLACE BLDLOCALE|BLDLOC=locname[,CCSID(nnnnn)][,TECHNIQUE|TECH(zzzzzzzzz)] [,PAGEFIX(YES|No)][,DSNAME|DSN(dsname)][,VOLSER|VOL(volser)]]End of change
Start of changeReplaces locales in the Unicode environment.
Start of changelocnameEnd of change
Start of changeSpecifies the locale name to be replaced.End of change
Start of changennnnnEnd of change
Start of changeSpecifies the CCSID of the locale to be replaced.End of change
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 Environment-Behavior conversion
  • Start of changeM - Modified for special use conversionEnd of change
  • 0-9 - User-defined conversions
Start of changeSee z/OS Unicode Services User's Guide and Reference for additional information on techniques.End of change
Note: Start of changeYou may get different results for different orders of the techniques placed in the zzzzzzzz field.End of change
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.
End of change
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 is 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.
  3. The REALSTORAGE keyword is an optional parameter.
DELETE mode
Deletes partially or completely the Unicode environment.
Value Range:
INACTIVE
Delete all the unreferenced control entries within the current Unicode environment and reorganize the Unicode environment to eliminate storage gaps in it. Specify the string literal INACTIVE.

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
Delete the whole Unicode environment removing all control structures and tables from the environment. 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.
Parent topic: CUNUNIxx (Unicode Services environment)