Coding tips for sysoutpdf jobs

These topics provide some tips on troubleshooting and on preparing batch report input and coding sysoutpdf jobs to avoid problems.

STDPARM cannot have sequence numbers

If you use the ISPF editor to create the STDPARM file or STDPARM inline statements, set sequence numbers off by entering NUMBER OFF on the command line before you begin typing the data. If sequence numbers already exist, enter UNNUM to remove them and set number mode off. Otherwise, you will get an error such as the following in the STDERR job output data set (where nnnnnnnn is a line sequence number):

... sysout2pdf: Input file not found: nnnnnnnn

Use REGION=0M to allocate memory to the JVM

Note the REGION=0M parameter on the EXEC statement for the BPXBATCH step. You can also specify this on the JOB statement. This parameter ensures that the Java Virtual Machine (JVM) has enough memory. If you omit REGION=0M, or you specify a REGION size that is too small, you will get errors similar to the following:

In the STDOUT job output data set:

<JIT: fatal error, failed to allocate 8192 Kb data cache>

In the STDERR job output data set:

JVMJ9VM015W Initialization error for library ... : cannot initialize JIT
Could not create the Java virtual machine.

If your report contains null (\0) characters, specify the -nulltospace option

Some reporting applications generate reports that contain null characters instead of spaces. This can be problematic.

sysout2pdf uses the z/OS UNIX shell command sed to manipulate report text. If sed detects a null character in its input file, it issues the following message in the STDERR job output data set, and then stops:

FSUM9201 input file "[standard input]" is binary

To overcome this error, specify the -nulltospace option, which causes sysout2pdf to translate nulls to spaces before calling sed.

Configure SMTP to accept maximum report size

If an email containing a requested report is not received and there is no error message from sysout2pdf, the problem may be in your sendmail configuration.

sysout2pdf uses the z/OS UNIX command sendmail to send email. sendmail uses the z/OS SMTP server. If an email exceeds the maximum number of bytes that the SMTP server accepts, the SMTP server discards the email, and writes the following error message to the MVS system log (SYSLOG):

EZA5501I Mail file too large. Data from username@example.com was discarded.

To overcome this error, ask your z/OS system administrator to increase the value specified by the MAXMAILBYTES statement in the SMTP configuration data set (supplied member name SMTPCONF).


Information Information

Feedback


Timestamp icon Last updated: Thursday, 7 November 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//common/cpa99sys2p-tips.htm