EZA1735I Return Code 19331 Error Code 00010 in xxx50CAR/xxx60RCH

Products

• Datacom
• Datacom/AD
• Datacom/DB
• Datacom/Server
• Common Components and Services for z/OS

Issue/Introduction

As part of the SMP/E install process for Broadcom mainframe products, batch FTP jobs to download CA RS details and HOLD data (SAMPJCL members xxx50CAR and xxx60RCH) can fail with this error message:

EZA1735I Std Return Code = 19331, Error Code = 00010

Running with debug mode (using the DEBUG command or the -d program parm) shows that the failure occurs immediately after entering the password, often accompanied by the message:

420 - Socket closed by remote partner

 

Environment

z/OS

Cause

When using the NETRC file to hold the user's login and password, it was not configured correctly.

Resolution

Using the NETRC file is a convenient and secure way to protect the FTP user's login details from being seen in the output spool files for a batch job. In order to successfully use this file, there are a few common errors that could lead to problems. Here are some guidelines to help you configure the NETRC correctly.

NETRC Configuration Guidelines

The NETRC data set provides auto-login credentials for FTP batch jobs. Below is the standard format for coding one or more host entries in this single member.                                    

Syntax (one line):

machine <host> login <userid> password <pwd>

Syntax (two lines):

machine <host>
        login <userid> password <pwd>

Note that the positioning is not column-specific, and the only requirement is one or more spaces between each of the tokens.

Guidelines for Coding (do not include the angle brackets in your values):

1. Keywords (machine, login, password) should be coded in lowercase to strictly align with IBM documentation.
2. Do not use comments. The z/OS NETRC parser does not support comments (e.g., ;, *, or //). Any text other than valid credentials will cause parsing errors.
3. <host> must match the exact host name or IP address used in your FTP OPEN command.
4. <userid> and <pwd> are the credentials for the remote server. These values are often case-sensitive based on the target OS.
5. Each machine entry should be kept on a single line if possible or with the machine on one line and login/password on the next.
6. Ensure there are no ISPF sequence numbers in columns 73-80, as these could cause authentication errors.

Additional Information

For more information on using the NETRC file, along with considerations for passwords with special characters, please see the IBM z/OS Communications Server: IP User's Guide, in the section titled Using FTP, and in the topic NETRC data set.

As always, please contact Broadcom support for your product if you have further questions.