CICS management client interface escape sequences

Certain characters are restricted in CICS management client interface 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 UTF-8 ASCII hexadecimal escape sequences.
Table 1. Restricted characters and their escape sequences
Character Escape sequence Character Escape sequence
SPACE %20 . (period) %2E
! %21 / %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
- (minus sign) %2D    

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.
Parent topic: CICS management client interface

clientapi_escape.html | Timestamp icon Last updated: Thursday, 27 June 2019