These topics provide some tips on troubleshooting and on preparing batch report input and coding sysoutpdf jobs to avoid problems.
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
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.
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.
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).