UNICODE command - Revision history

Dme: /* Display forms of UNICODE */

2018-12-03T14:02:48Z

Display forms of UNICODE

← Older revision		Revision as of 14:02, 3 December 2018
Line 40:		Line 40:

	For <var>UNICODE</var> examples and more information about Unicode support, see the [[Unicode]] page.		For <var>UNICODE</var> examples and more information about Unicode support, see the [[Unicode]] page.

			==Common command:UNICODE Table Standard Base Codepage xxxx==
			One common choice made by a customer is which Unicode codepage to use for their Model 204 onlines. This is achieved by a form of the <var>UNICODE</var> command that specifies the <var>[[#baseCpg\|Base Codepage]]</var>.
			===Default Base Codepage shipped with Model 204: 1047===
			If the <var>UNICODE Table Standard Base Codepage</var> <i>xxxx</i> command has not been specified in the online, the codpage used is 1047.

	==Display forms of UNICODE==		==Display forms of UNICODE==

Dme: /* Update forms of UNICODE */

2018-12-03T14:01:08Z

Update forms of UNICODE

← Older revision		Revision as of 14:01, 3 December 2018
Line 98:		Line 98:
	<var>UNICODE</var> command follow:		<var>UNICODE</var> command follow:
	<dl>		<dl>
	<dt>Base Codepage name		<dt id="baseCpg">Base Codepage name
	<dd>Replace the current translation tables with those derived from the		<dd>Replace the current translation tables with those derived from the
	named codepage.		named codepage.
			<p>If the <var>UNICODE Table Standard Base Codepage</var> <i>xxxx</i> command has not been specified in the online, the codpage used is 1047.</p>

	<dt>Trans E=h2 To U=hex4		<dt>Trans E=h2 To U=hex4

JAL: misc cleanup

2016-05-26T23:29:02Z

misc cleanup

Show changes

Dme at 15:58, 14 August 2014

2014-08-14T15:58:54Z

← Older revision		Revision as of 15:58, 14 August 2014
Line 1:		Line 1:
	<p class="note"><b>Note:</b> This is a <var class="product">[[Sirius Mods]]</var>-only command prior to ~~Version~~ 7.5 of <var class="product">[[Model 204]]</var>.</p>		<p class="note"><b>Note:</b> This is a <var class="product">[[Sirius Mods]]</var>-only command prior to version 7.5 of <var class="product">[[Model 204]]</var>.</p>

	The <var>UNICODE</var> command is used to manage the Unicode tables,		The <var>UNICODE</var> command is used to manage the Unicode tables,
	which specify translations between EBCDIC and Unicode/ASCII.		which specify translations between EBCDIC and Unicode/ASCII - a key facet of the [[Unicode\|Unicode feature]] of <var class="product">Model 204</var>.

	The command also lets you		The command also lets you
	replace individual Unicode characters by designated character strings,		replace individual Unicode characters by designated character strings,

Dme at 15:56, 14 August 2014

2014-08-14T15:56:45Z

← Older revision		Revision as of 15:56, 14 August 2014
Line 1:		Line 1:
	<p class="note"><b>Note:</b> This is a <var class="product">[[Sirius Mods]]</var>-only command prior to Version 7.5 of <var class="product">[[Model 204]]</var>.</p>		<p class="note"><b>Note:</b> This is a <var class="product">[[Sirius Mods]]</var>-only command prior to Version 7.5 of <var class="product">[[Model 204]]</var>.</p>

	The UNICODE command is used to manage the Unicode tables,		The <var>UNICODE</var> command is used to manage the Unicode tables,
	which specify translations between EBCDIC and Unicode/ASCII.		which specify translations between EBCDIC and Unicode/ASCII.
	The command also lets you		The command also lets you

Dme at 15:56, 14 August 2014

2014-08-14T15:56:13Z

← Older revision		Revision as of 15:56, 14 August 2014
Line 9:		Line 9:
	you have specified.		you have specified.

			__TOC__

	==Syntax==		==Syntax==
	The general form of the UNICODE command is:		The general form of the UNICODE command is:
Line 155:		Line 157:
	<dd>Specify that there is no replacement string for any Unicode point.		<dd>Specify that there is no replacement string for any Unicode point.
	</dl>		</dl>

			==Use of codepages in the CharacterToUnicodeMap class==
			In addition to establishing the standard codepage using the <code>UNICODE Table Standard Base Codepage <i>name</i></code> command, any of the codepages may be used to establish a <var>[[CharacterToUnicodeMap class\|CharacterToUnicodeMap]]</var> object, using the <var>[[NewFromEbcdicCodepage (CharacterToUnicodeMap function)\|NewFromEbcdicCodepage]]</var> function.

	[[Category:System administrator commands]]		[[Category:System administrator commands]]
	[[Category:Commands]]		[[Category:Commands]]

Dme: /* Display forms of UNICODE */

2013-08-12T22:28:03Z

Display forms of UNICODE

← Older revision		Revision as of 22:28, 12 August 2013
Line 66:		Line 66:
	maps (see the ''''Map'''' update subcommand in		maps (see the ''''Map'''' update subcommand in
	[[#Update forms of UNICODE\|"Update forms of UNICODE"]])		[[#Update forms of UNICODE\|"Update forms of UNICODE"]])
	of the specified ~~codepage~~.		of the codepage specified by <i>name</i>.
	<dt>UNICODE Display Table Standard		<dt>UNICODE Display Table Standard
	<dd>Obtains, in command form, a display of any		<dd>Obtains, in command form, a display of any

JAL at 22:50, 4 March 2013

2013-03-04T22:50:56Z

← Older revision		Revision as of 22:50, 4 March 2013
Line 1:		Line 1:
			<p class="note"><b>Note:</b> This is a <var class="product">[[Sirius Mods]]</var>-only command prior to Version 7.5 of <var class="product">[[Model 204]]</var>.</p>

	The UNICODE command is used to manage the Unicode tables,		The UNICODE command is used to manage the Unicode tables,
	which specify translations between EBCDIC and Unicode/ASCII.		which specify translations between EBCDIC and Unicode/ASCII.
Line 7:		Line 9:
	you have specified.		you have specified.

			==Syntax==
	The general form of the UNICODE command is:		The general form of the UNICODE command is:
	=~~==UNICODE command~~ syntax~~===~~		<p class="syntax">UNICODE subcommand operands </p>
	UNICODE subcommand operands
	where		where
	<dl>		<dl>
	<dt>subcommand		<dt>subcommand
	<dd>A term that indicates which operation is being performed.		<dd>A term that indicates which operation is being performed.
	~~''''~~List~~''''~~, ~~''''~~Difference~~''''~~, and ~~''''~~Display~~''''~~ are		<var>List</var>, <var>Difference</var>, and <var>Display</var> are
	subcommands that only produce an information display; ~~''''~~Table~~''''~~ produces		subcommands that only produce an information display; <var>Table</var> produces
	a character translation update.		a character translation update.
	<dt>operands		<dt>operands
Line 23:		Line 25:
	The UNICODE subcommands are described below in separate sections according		The UNICODE subcommands are described below in separate sections according
	to type (display or update).		to type (display or update).
	Only the		Only the [[#Update forms of UNICODE\|update forms]]
	[[#Update forms of UNICODE\|update forms]]
	of UNICODE require System Administrator (or User 0) privileges.		of UNICODE require System Administrator (or User 0) privileges.

Line 39:		Line 40:
	For UNICODE examples and		For UNICODE examples and
	more information about Sirius Unicode support, see the [[Unicode]] page.		more information about Sirius Unicode support, see the [[Unicode]] page.

	==Display forms of UNICODE==		==Display forms of UNICODE==
	The UNICODE subcommands that produce information displays are described below.		The UNICODE subcommands that produce information displays are described below.
Line 72:		Line 74:
	that differ from the base.		that differ from the base.
	</dl>		</dl>

	==Update forms of UNICODE==		==Update forms of UNICODE==
	The updating forms of the UNICODE command begin with the		The updating forms of the UNICODE command begin with the
	keyword ''''Table'''' and have the following format:		keyword ''''Table'''' and have the following format:
	<~~pre~~>		<p class="code">UNICODE Table Standard subcommand
	UNICODE Table Standard subcommand		</p>
	</~~pre~~>

	The ''subcommand'' values are described below.		The ''subcommand'' values are described below.
Line 96:		Line 98:
	<dd>Replace the current translation tables with those derived from the		<dd>Replace the current translation tables with those derived from the
	named codepage.		named codepage.

	<dt>Trans E=h2 To U=hex4		<dt>Trans E=h2 To U=hex4
	<dd>Specify one-way translation from EBCDIC point ''h2'' to		<dd>Specify one-way translation from EBCDIC point ''h2'' to
	Unicode point ''hex4''.		Unicode point ''hex4''.

	<dt>Trans E=h2 Invalid		<dt>Trans E=h2 Invalid
	<dd>Specify that the given EBCDIC point is not translatable to Unicode.		<dd>Specify that the given EBCDIC point is not translatable to Unicode.

	<dt>Trans E=h2 Base		<dt>Trans E=h2 Base
	<dd>Remove any customized translation or		<dd>Remove any customized translation or
	mapping specified for the given EBCDIC point,		mapping specified for the given EBCDIC point,
	thus returning to the base codepage translation for the point.		thus returning to the base codepage translation for the point.

	<dt>Trans U=hex4 To E=h2		<dt>Trans U=hex4 To E=h2
	<dd>Specify one-way translation from Unicode point ''hex4''		<dd>Specify one-way translation from Unicode point ''hex4''
	to EBCDIC point ''h2''.		to EBCDIC point ''h2''.

	<dt>Trans U=hex4 Invalid		<dt>Trans U=hex4 Invalid
	<dd>Specify that the given Unicode point is not translatable to EBCDIC.		<dd>Specify that the given Unicode point is not translatable to EBCDIC.

	<dt>Trans U=hex4 Base		<dt>Trans U=hex4 Base
	<dd>Remove any customized translation or		<dd>Remove any customized translation or
	mapping specified for the given Unicode point,		mapping specified for the given Unicode point,
	thus returning to the base codepage translation for the point.		thus returning to the base codepage translation for the point.

	<dt>Trans All Base		<dt>Trans All Base
	<dd>Remove any customized translation or mapping specified from all		<dd>Remove any customized translation or mapping specified from all
	Unicode and EBCDIC points.		Unicode and EBCDIC points.
	<dt>~~Map~~ E=h2 Is U=hex4		<dt>M
			ap E=h2 Is U=hex4
	<dd>Specify mapping from EBCDIC point ''h2'' to Unicode point		<dd>Specify mapping from EBCDIC point ''h2'' to Unicode point
	''hex4'', and from Unicode point ''hex4'' to EBCDIC point ''h2''.		''hex4'', and from Unicode point ''hex4'' to EBCDIC point ''h2''.

	<dt>Map U=hex4 Is E=h2		<dt>Map U=hex4 Is E=h2
	<dd>Same as ''''Map E=h2 Is U=hex4''''.		<dd>Same as ''''Map E=h2 Is U=hex4''''.

	<dt>Rep U=hex4 'str'		<dt>Rep U=hex4 'str'
	<dd>Specify replacement for Unicode point ''hex4'' by the Unicode		<dd>Specify replacement for Unicode point ''hex4'' by the Unicode
Line 128:		Line 140:
	<ul>		<ul>
	<li>Non-ampersand EBCDIC characters (which must be translatable to Unicode)		<li>Non-ampersand EBCDIC characters (which must be translatable to Unicode)
	<li>~~''''~~&amp~~.''''~~ (for an ampersand)		<li><code>&amp;</code> (for an ampersand)
	<li>A character reference of the form &#~~xhhhh~~;		<li>A character reference of the form <code>&#x<i>hhhh</i>;</code>
	</ul>		</ul>

Line 135:		Line 147:
	127 characters.		127 characters.
	No character in the replacement string		No character in the replacement string
	may be the ~~''''~~U=hex4~~''''~~ value in any Rep subcommand.		may be the <code>U=hex4</code> value in any Rep subcommand.

	<dt>Norep U=hex4		<dt>Norep U=hex4
	<dd>Specify that there is no replacement string for Unicode point ''hex4''.		<dd>Specify that there is no replacement string for Unicode point ''hex4''.

	<dt>Norep All		<dt>Norep All
	<dd>Specify that there is no replacement string for any Unicode point.		<dd>Specify that there is no replacement string for any Unicode point.

Dme at 17:16, 17 February 2012

2012-02-17T17:16:49Z

New page

The UNICODE command is used to manage the Unicode tables,
which specify translations between EBCDIC and Unicode/ASCII.
The command also lets you
replace individual Unicode characters by designated character strings,
and it has varied options for displaying translation table codepages
and code point mappings, as well as displaying any translation customizations
you have specified.

The general form of the UNICODE command is:
===UNICODE command syntax===
UNICODE subcommand operands
where
<dl>
<dt>subcommand
<dd>A term that indicates which operation is being performed.
''''List'''', ''''Difference'''', and ''''Display'''' are
subcommands that only produce an information display; ''''Table'''' produces
a character translation update.
<dt>operands
<dd>The operands specific to the operation.
</dl>

The UNICODE subcommands are described below in separate sections according
to type (display or update).
Only the
[[#Update forms of UNICODE|update forms]]
of UNICODE require System Administrator (or User 0) privileges.

Subcommand and operand keywords of the UNICODE command may be entered in any
combination of uppercase or lowercase letters.
The term <code>UNICODE</code> that starts the
command must be entered entirely in uppercase letters.

The command descriptions that follow use an initial capital letter to indicate
a keyword, and they use all-lowercase letters to indicate a term that is
substituted for a particular value in the command.

The UNICODE command is available as of <var class="product">Sirius Mods</var> version 7.3.
For UNICODE examples and
more information about Sirius Unicode support, see the [[Unicode]] page.
==Display forms of UNICODE==
The UNICODE subcommands that produce information displays are described below.
In the descriptions:
<ul>
<li>''h2'' is two hexadecimal digits.
<li>''hex4'' is four hexadecimal digits, excluding FFFE, FFFF,
and the surrogate areas (D800 through and including DFFF).
</ul>

The display forms of the UNICODE command are:
<dl>
<dt>UNICODE List Codepages
<dd>Obtains a list of all codepages.
<dt>UNICODE Difference Codepages name1 And name2 [Range E=h2 To E=h2]
<dd>Obtains a list of the differences
between two codepages for the EBCDIC range specified.
The default range is 00 to FF.
<dt>UNICODE Difference Xtab name1 And Codepage name2 [Range E=h2 To E=h2]
<dd>Obtains a list of the differences
between a JANUS XTAB table and a codepage for the EBCDIC range specified.
The default range is 00 to FF.
<dt>UNICODE Display Codepage name
<dd>Obtains, in commented form, the
maps (see the ''''Map'''' update subcommand in
[[#Update forms of UNICODE|"Update forms of UNICODE"]])
of the specified codepage.
<dt>UNICODE Display Table Standard
<dd>Obtains, in command form, a display of any
current replacements and current maps and/or translations
(see the ''''Trans'''' update subcommands in
[[#Update forms of UNICODE|"Update forms of UNICODE"]])
that differ from the base.
</dl>
==Update forms of UNICODE==
The updating forms of the UNICODE command begin with the
keyword ''''Table'''' and have the following format:
<pre>
UNICODE Table Standard subcommand
</pre>

The ''subcommand'' values are described below.

For the updating subcommands:
<ul>
<li>The user must be a System Administrator (or user 0).
<li>These commands should only be invoked during <var class="product">Model 204</var> initialization,
because other users running at the same time as the change may
obtain inconsistent results, including the results
of ''''UNICODE Display'''' (described in the previous section).
</ul>

The ''subcommand'' values of the updating form of the
UNICODE command follow:
<dl>
<dt>Base Codepage name
<dd>Replace the current translation tables with those derived from the
named codepage.
<dt>Trans E=h2 To U=hex4
<dd>Specify one-way translation from EBCDIC point ''h2'' to
Unicode point ''hex4''.
<dt>Trans E=h2 Invalid
<dd>Specify that the given EBCDIC point is not translatable to Unicode.
<dt>Trans E=h2 Base
<dd>Remove any customized translation or
mapping specified for the given EBCDIC point,
thus returning to the base codepage translation for the point.
<dt>Trans U=hex4 To E=h2
<dd>Specify one-way translation from Unicode point ''hex4''
to EBCDIC point ''h2''.
<dt>Trans U=hex4 Invalid
<dd>Specify that the given Unicode point is not translatable to EBCDIC.
<dt>Trans U=hex4 Base
<dd>Remove any customized translation or
mapping specified for the given Unicode point,
thus returning to the base codepage translation for the point.
<dt>Trans All Base
<dd>Remove any customized translation or mapping specified from all
Unicode and EBCDIC points.
<dt>Map E=h2 Is U=hex4
<dd>Specify mapping from EBCDIC point ''h2'' to Unicode point
''hex4'', and from Unicode point ''hex4'' to EBCDIC point ''h2''.
<dt>Map U=hex4 Is E=h2
<dd>Same as ''''Map E=h2 Is U=hex4''''.
<dt>Rep U=hex4 'str'
<dd>Specify replacement for Unicode point ''hex4'' by the Unicode
string ''str''.
''str'' may be a series of the following:
<ul>
<li>Non-ampersand EBCDIC characters (which must be translatable to Unicode)
<li>''''&amp.'''' (for an ampersand)
<li>A character reference of the form &#xhhhh;
</ul>

The length of the resulting Unicode replacement string is limited to
127 characters.
No character in the replacement string
may be the ''''U=hex4'''' value in any Rep subcommand.
<dt>Norep U=hex4
<dd>Specify that there is no replacement string for Unicode point ''hex4''.
<dt>Norep All
<dd>Specify that there is no replacement string for any Unicode point.
</dl>

[[Category:System administrator commands]]
[[Category:Commands]]