This product is used to connect to cloud service providers or can be used to FTP between two IBMi systems. The product can be used as a stand alone product or with BRMS. The BRMS product uses it to send virtual tape images to and from the cloud. For basic setup and use contact the SR team For basic setup using BRMS contact the BRMS team For communication issues contact the COM team For SSL issues contact CTA team
Diagnosing The Problem
For interactive processing, when an action fails, an “ICC” message is sent and displays in the command entry screen, below the action. Have the customer position their cursor on the message and press F1 to display the message; provide us with the message ID. For example – an incorrect resource name was keyed on the CPYTOCLD command:
Command Entry ALTST5
Request level: 1
Previous commands and messages:
> CPYTOCLD RESOURCE(BADRSC) ASYNC(*NO) LOCALFILE('/home/debis/FTPTo/abc.txt
Resource name BADRSC could not be found.
Position the cursor on the message and press F1
Additional Message Information
Message ID . . . . . . : ICC0004 Severity . . . . . . . : 30 Message type . . . . . : Escape Date sent . . . . . . : 11/15/16 Time sent . . . . . . : 08:45:47
Message . . . . : Resource name BADRSC could not be found.
|If a message provides an additional error code or if the problem is not easily understood with the single message as in the above instance, ask the customer to recreate the problem using batch processing and collect the entire JOBLOG and the ICC Logs. For example, if a connection cannot be made to SoftLayer message ICC0022 may display:|
Display Formatted Message Text
Message ID . . . . . . . . . : ICC0022 Message file . . . . . . . . : QICCMSG Library . . . . . . . . . : QICC
Message . . . . : Unable to connect to SoftLayer.
A connection could not be established because of error code &1. The error code meanings follow:
1 -- A connection could not be established. 2 -- An error occurred reading data from a socket. 3 -- An error occurred writing data to a socket. 4 -- An error occurred parsing the header of a response from SoftLayer. 5 -- Unexpected HTTP response code from SoftLayer.
For interactive job errors, have the customer sign off their session using the SIGNOFF *LIST command. Then, send the joblog for the session to support.
For submitted copy to/copy from jobs, a joblog should have been created for the activity. The name of these jobs starts with an L followed by a 9 digit number. Send in the joblog.
It may take customers some time to remember that a fully qualified cloud file path includes the container value from a SoftLayer resource or the root directory value from an FTP resource. To assist with trouble shooting, ask the customer to provide screen shots of:
1. The copy from, copy to or delete command that was executed
2. A screen shot of the SoftLayer or FTP resource (DSPSLRICC or DSPFPRICC)
Exit Program Inputs
If a customer has defined an exit program to the QIBM_QICC_XFER_CLS exit point, providing the inputs to the exit program would be useful information.
An internal log ID number is assigned to each transaction and knowing the log ID at this juncture may be useful when asking for additional information from the database. In order to query the table for the log ID, the customer must find the job number for the transaction.
Go to the Work with ICC Status panel - WRKSTSICC STATUS(*ALL)
The job number is located in the number field on the display, make note of the number.
Go into SQL and enter this command:
SELECT * FROM QUSRICC/QICCLOG WHERE JOBNBR = nnnnnn
Replace the n’s with the job number from the Work With ICC Status panel.
The log ID is located in the first column. If the job had more than one segment created, there may be more than 1 log ID for the job, provide all log IDs for the job number.
Collecting Rocket Flight Recorders
To activate the "flight recorder" create this data area in the program library (QICC):
CRTDTAARA QICC/QICCDBGLOG TYPE(*CHAR) LEN(255) VALUE('/path/filename') where path is a location in the IFS where the file will be stored and the filename is the name of the log file. (Recommendation is to use qicclog.log. ie: CRTDTAARA QICC/QICCDBGLOG TYPE(*CHAR) LEN(255) VALUE('/tmp/qicclog.log').
To deactivate the "flight recorder", rename or delete the data area.
1) In order for the FRs to generate output when CPY jobs are run, they must be run in batch mode. You must do the following:
o STRSBS SBS(QICC/QICCSBS)
o CPYTOCLD RESOURCE(IBMCOS) ASYNC(*YES) LOCALFILE('/cloud/test.txt') CLOUDFILE(test.txt)
2) In conjunction with flight recorder it is necessary to collect complete joblogs for the submitted job as the job that submitted it.
Debugging SSL Connections to a remote host
The below example is of a outbound ftp connection to the remote cloud server on port 990.
The cl example shown is wrapped, should be on single line.
The trccnn output in pcap format should identify the ssl handshake, and if any certifcates were exchanged for authentication.
i5/os server side command;
TRCCNN SET(*ON) TRCTYPE(*IP) TRCTBL(TCPIP) SIZE(300 *MB) TCPDTA(*N ()
(990) *N '10.1.1.1')
<RECREATE ics ssl connection FAILURE>
TRCCNN SET(*OFF) TRCTBL(TCPIP) OUTPUT(*STMF) TOSTMF('/ifs_path/file.cap'
The output will be in the noted IFS path.
Customer can use iNav to drag/drop the file to www.ecurep.ibm.com/app/upload
Customer can use Qmgtools/FTP2IBMCMD utility to upload. Technote N1010370
It can also be very helpful to get a i5 system snapshot. Qmgtools/syssnap Technote N1010353.
Obtaining/Installing QMGTOOLS Technote N1011297
DCM Frequently Asked Questions Technote N1010356
How do I configure the ftp client for ssl?
17 June 2018