IBM Support

EZZ0059I VARY TCPIP,,EXPORTPROF COMMAND FAILED: JSON FUNCTION HWTJCREN FAILED : RC = 207, RSN = 000000E4

Question & Answer


Question

After issuing the VARY TCPIP,,EXPORTPROF command, we see the following message:

 EZZ0059I VARY TCPIP,,EXPORTPROF COMMAND FAILED:  JSON FUNCTION HWTJCREN  FAILED : RC = 207, RSN =  000000E4

The export file is not created.

We issued the following command to verify for syntax errors but none were found: .

    V TCPIP,,SYNTAXCHECK,tcpip_profile


Answer

The HWTJCREN return codes are described under topic "HWTJCREN -- Create JSON entry" in the MVS Programming: Callable Services for High-Level Languages manual: .

The explanation for your RC=207 is as follows: .

    HWTJ_CREN_ENTRYVALUE_INV 
 . 
     Meaning: Program error. The caller specified an entry value, which contains a syntax error. (This is a valid return code for entryValueType parameter values HWTJ_STRINGVALUETYPE and       HWTJ_NUMVALUETYPE.) 
 . 
     Action: Check for a probable coding error. Consult Introducing JSON or other JSON specifications to determine the correct syntax of a string or number value in a name or value pair. 
 . 
     Note: The z/OS JSON parser adds the beginning and ending double quotation marks to all entry values with a type of HWTJ_STRINGVALUETYPE. Any quotation marks contained in the entry value buffer is flagged with this error. 
 

The reason for the error is that the TCPIP profile contained characters that were not entered in code page IBM-1047. We have defined this code page restriction for the TCPIP profiles in the last bullet under topic "Statement syntax for configuration statements" in the z/OS CS IP Configuration Reference as follows: .

    * All characters must be entered in code page IBM®-1047. 

. Ref: https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.2.0/com .ibm.zos.v2r2.halz001/stmntsynforconfigstatements.htm .

The VARY TCPIP,,SYNTAXCHECK command did not catch this issue because we do not process comments during the syntax check. However, due to a requirement for retaining comments within imported profiles in Configuration Assistant, we do pass the comments to an external function (HWTJCREN) when VARY TCPIP,,EXPORTPROF is executed that also requires all characters to be entered in code page IBM-1047.

.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSSN3L","label":"z\/OS Communications Server"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

ZOSCS COMMSERVER

Document Information

Modified date:
12 October 2017

UID

dwa1406667