System i: Programming Message Handling APIs - IBM

*PRINT Resets the job so the job log is written to a spooled file rather than an output file. When this
special value is used the remaining parameters on this API are ignored.
The API does not allow the primary file specification to be overridden by the use of the Override
Database File (OVRDBF) command. The primary file also cannot be overridden at job log production
time. The file object determined to be the primary file used by this API is the one used at job log
production time. If the file does not exist at job log production time, the job log is redirected to a spooled
file.
The primary file must be a local physical file; it cannot be a DDM file.
Qualified secondary file name. The name of the file into which the secondary job log information is
written. The parameter consists of two parts. The first 10 positions to contain the file name and the
second 10 positions contain the library name. A library name can be provided or the special values
*CURLIB and *LIBL can be used. QTEMP cannot be used for the library name.
If an output file by the specified name does not exist when the API is called, one is created by that name
in the specified library. If the library was specified as *LIBL, the file is created in the current library. If
*LIBL or *CURLIB was specified and there is no current library, the file is created in QGPL. The file
attributes MAXRCDS and MAXMBRS are set to *NOMAX.
The following special value can be used in this field:
*NONE No secondary file is provided. This special value prevents the generation of the secondary job log
information. When this special value is used, the secondary library and member names are
ignored.
The API does not allow the secondary file specification to be overridden by the use of the OVRDBF
command. The secondary file also cannot be overridden at job log production time. The file object
determined to be the secondary file by this API is used at job log production time. If the file does not
exist at job log production time, the job log automatically redirects to a spooled file.
The secondary file must be a local physical file; it cannot be a DDM file.
Reserved. This field must be set to binary zeros.
Secondary file member name. The name of the member within the secondary file used for the secondary
job log information.
If a member of the specified name does not exist, a member by that name is added to the secondary file.
If a member by the specified name does exist, the member is cleared if the Member replace option field
of this structure specifies replace. Otherwise, the member is not cleared. At job log production time, new
records are added to the member and any existing records are left unchanged.
The following special value can be used in this field:
*FIRST The first member in the file receives the output. If a member does not exist, one is created with
the same name as the file name.
CCSID Considerations
CCSID conversion is allowed on any field in the primary file with the exception of the field QMHMDT,
which contains the message data or immediate message text. The QMHMDT field is defined with a
Message Handling APIs 11