CMCI escape sequences

Certain characters are restricted in CMCI URIs. For these characters, you must substitute an escape sequence consisting of the percent character (%) followed by a hexadecimal value.

The following table lists the restricted characters and their hexadecimal escape sequences.

Table 1. Restricted characters and their escape sequences
Character	Escape sequence	Character	Escape sequence
SPACE	%20	- (minus sign)	%2D
!	%21	. (period)	%2E
6.3 " (double quote)	%22	/	%2F
#	%23	: (colon)	%3A
$	%24	; (semicolon)	%3B
%	%25	<	%3C
&	%26	=	%3D
' (single quote)	%27	>	%3E
(	%28	?	%3F
)	%29	@	%40
*	%2A	[	%5B
+	%2B	]	%5D
, (comma)	%2C	¬ (not)	%AC

Examples

The following example shows a criteria string from a CICS® management client interface URI before and after encoding with escape characters:

Before:

CRITERIA=(TRANID=P* AND PROGRAM=PAY* AND STATUS=ENABLED) AND
((USECOUNT>0 AND STGVCNT>0) OR NOT RESTARTCNT=0)

After:

CRITERIA=%28TRANID%3DP%2A%20AND%20PROGRAM%3DPAY%2A%20AND%20STATUS%3DENABLED%29%20AND%20
%28%28USECOUNT%3E0%20AND%20STGVCNT%3E0%29%20OR%20NOT%20RESTARTCNT%3D0%29

The following example shows a parameter string from a CICS management client interface URI before and after encoding with escape characters:

Before:

PARAMETER=STARTDATE(07/17/2006) STARTTIME(17:00) INTERVAL(300)

After:

PARAMETER=STARTDATE%2807%2F17%2F2006%29%20STARTTIME%2817%3A00%29%20INTERVAL%28300%29

The interface also supports an optional period (%2E) at the end of criteria and parameter strings.