IBM Support

DFH5287E RC=2 and Error PORT is blank when running DFH0IPCC migration utility

Question & Answer


Question

I am using DFHCSDUP to invoke the DFH0IPCC migration utility to convert existing APPC and MRO connections to IPIC. I am following the procedure within topic Migrating APPC and MRO connections to IPIC. Part of the procedure is to create an APPLID table that will supply attributes such as APPLID, PORT number, and TCPIPSERVICE name. I continuously receive message:

DFH5287 E EXTRACT TERMINATED AT USER'S REQUEST RC=2.

The job ends with a return code 8 and the Logfile produces a complaint about the PORT being blank:
Error: PORT is blank

Here is an example Logfile produced for a single Connection and Sessions pair:

DSN=CICSDSN.LOGFILE:
Group GRPNAME has been started
Processing CONNECTION CONN
Processing SESSIONS CONNSESS
Group GRPNAME has been processed
Loading default values
Processing CONNECTION CONN in GRPNAME
Processing SESSIONS for CONNECTION CONN
Migrating attributes for CONNECTION CONN
Error: PORT is blank

My APPLID table is supplying a port number as follows:

DSN=CICSDSN.APPLID.TABLE:

    .DEFAULT|CICSA     |5555 |TCPIPSERVICE=SERV
     CONN   |          |5555 |CICS.LUVCICS.COM  

Excerpt of Connection, Sessions, and TCPIPSERVICE definitions:

 DEFINE CONNECTION(CONN) GROUP(GRPNAME) 
 DESCRIPTION(CONN FUNCTION SHIP REQUEST) 
        NETNAME(CICSNET) ACCESSMETHOD(XM) SINGLESESS(NO) 
 DEFINE SESSIONS(CONNSESS) GROUP(GRPNAME) 
 DESCRIPTION(CONN FUNCTION SHIP REQUEST) 
        CONNECTION(CONN) PROTOCOL(LU61) MAXIMUM(0,0) RECEIVEPFX(R) 
 DEFINE TCPIPSERVICE(SERV) GROUP(GRPNAME)  
        URM(DFHISAIP) PORTNUMBER(5555) STATUS(OPEN) PROTOCOL(IPIC)

Complete messages from the DFHCSDUP job are as follow:

EXTRACT GR(GRPNAME) USERPROGRAM(DFH0IPCC) OBJECTS
DFH5120 I PRIMARY CSD OPENED; DDNAME: DFHCSD - DSNAME: CICS.LUVCICS.DFHCSD
DFH5103 I ERROR(S) OCCURRED WHILE PROCESSING EXTRACT COMMAND.
DFH5104 W SUBSEQUENT COMMANDS (EXCEPT LIST) ARE NOT EXECUTED BECAUSE OF ERROR(S) ABOVE.
DFH5123 I PRIMARY CSD CLOSED; DDNAME: DFHCSD - DSNAME: CICS.LUVCICS.DFHCSD
DFH5107 I COMMANDS EXECUTED SUCCESSFULLY: 0 COMMANDS GIVING WARNING(S): 0 COMMANDS IN ERROR: 1
DFH5108 I COMMANDS NOT EXECUTED AFTER ERROR(S): 0
DFH5109 I END OF DFHCSDUP UTILITY JOB. HIGHEST RETURN CODE WAS: 8

Answer

Message DFH5287E RC(2) with "Error: PORT is blank" are a result of the applid parameter within the APPLID table not matching the NETNAME on a CONNECTION definition. The directions for this migration do not explain that the APPLID within the APPLID table should be coded to match the NETNAME of a CONNECTION being migrated.

See section IPCONN attribute mapping in topic The DFH0IPCC migration utility of the CICS Transaction Server for z/OS (CICS TS) documentation which explains the mapping better.

Using the NETNAME "CICSNET" from the CONNECTION definition within the question above, the APPLID table should look similar to this:

DSN=CICSDSN.APPLID.TABLE:

 .DEFAULT|CICSA |5555 |TCPIPSERVICE=SERV
  CICSNET|      |5555 |CICS.LUVCICS.COM

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"IPIC","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICS/TS CICSTS CICS TS CICS Transaction Server

Document Information

Modified date:
01 November 2017

UID

dwa1410221