STRMTWTR
command starts a remote writer
on a specified output-queue. The output-queue itself must be
configured
as a remote output queue. A remote writer
will only send a spooled-file to PDFing, when the file is at status
RDY
and is queued
on the output queue being serviced by this
remote writer. In general, a remote writer will behave in exactly the
same way as any other
print-writer. If you have configured OS400 correctly and started the
remote-writer,
you should see the status of each spooled-file change to SND
as it is sent to PDFing. After each spooled-file is sent, it will be
deleted or
its status will change to SAV
.
Here the remote writer job will send any RDY spooled-files on output queue
STRRMTWTR OUTQ(PDFING)
PDFING
until the remote
writer job is ended. The name of the batch job running the
remote-writer
is also PDFING
.
WRKWTR PDFING
ENDWTR WTR(PDFING)
Please note that command
STRRMTWTR OUTQ(PDFING) AUTOEND(*YES *NORDYF)
STRRMTWTR
only needs to be executed
once. The writer job will continue to run until either OS400 shuts down
or the
ENDWTR WTR(PDFING)
command is executed
SNDTCPSPLF
command can send one spooled-file
to PDFing per command execution. Execution of this command continues
until the
spooled-file is received by PDFing. The spooled-file can be on any
output-queue
and the output-queue does not need any
specific configuration.
The spooled-file remains in the same state after execution of
SNDTCPSPLF
. When
the spooled-file is sentle to PDFing, the user-defined-text is not
sent.
However, you may specify the same tags in the DESTOPT()
parameter of the command, these "tag" strings must be URL encoded.
DSPLIBL *PRINT
.
To send the spooled-file
to PDFing, execute:
SNDTCPSPLF RMTSYS(*INTNETADR) PRTQ('PDFING') FILE(QPRTLIBL) JOB(*) SPLNBR(*LAST) +where nnn.nnn.nnn.nnn is the internet address of the PC running PDFing. Do not key in any leading zeros in the addresss.
DESTTYP(*AS400) TRANSFORM(*NO) +
INTNETADR('nnn.nnn.nnn.nnn')
TRANSFORM(*YES)
and
MFRTYPMDL(*HP4)
parameter values.
SNDTCPSPLF RMTSYS(*INTNETADR) PRTQ('PDFING') FILE(QPRTLIBL) JOB(*) SPLNBR(*LAST) +This command specifies that the spooled-file data will be transformed by OS400 into PCL (Hewlett-Packard printer-control-language) before being sent to PDFing.
DESTTYP(*OTHER) TRANSFORM(*YES) MFRTYPMDL(*HP4) +
INTNETADR('nnn.nnn.nnn.nnn')
SNDTCPSPLF RMTSYS(*INTNETADR) PRTQ('PDFING') FILE(QPRTLIBL) JOB(*) SPLNBR(*LAST) +This command specifies that all the spooled-file attributes will be sent to PDFing but only *AFPDS spooled-files will be transformed to PCL.
DESTTYP(*OTHER) TRANSFORM(*NO) MFRTYPMDL(*HP4) +
USRDTATFM(PDFING/PDFING) INTNETADR('nnn.nnn.nnn.nnn')
AUTOSTRWTR
parameter of the CRTOUTQ
and
CHGOUTQ
commands.
PDFING
in library
QGPL
, you must enter the following command:
CRTOUTQ OUTQ(QGPL/PDFING) DESTTYPE(*OS400) TRANSFORM(*NO) DESTOPT(*USRDFNTXT)
*USRDFNTXT
should be spelled exactly
as shown here!
You must then change queue PDFING
so that it can
supply the remote writer with the information it needs to write the
spooled-files on this output-queue. In the following example we assume
that
the PC running PDFing is named in the Domain-Name-Server for your
network. Enter command:
CHGOUTQ OUTQ(PDFING) RMTSYS('PDF.your.com') RMTPRTQ('PDFING') CNNTYPE(*IP)Here
RMTSYS(PDF.your.Com)
specifies the IP host name of the Windows PC.
CHGOUTQ OUTQ(PDFING) RMTSYS(*INTNETADR) RMTPRTQ('PDFING') CNNTYPE(*IP) +Here
INTNETADR('172.16.100.101')
RMTSYS(*INTNETADR)
specifies that
an IP address must be supplied and
INTNETADR('172.16.100.101')
specifies the Internet address of the PC running the PDFing program.
Please note that
*INTNETADR
should
be spelled exactly as shown here!
CHGOUTQ OUTQ(PDFING) DESTTYPE(*OTHER) TRANSFORM(*YES) MFRTYPMDL(*HP4)Here
TRANSFORM(*YES)
specifies that
host print transform will be performed by OS400, before the
spooled-file is sent to PDFing.
CHGOUTQ OUTQ(PDFING) DESTTYPE(*OTHER) TRANSFORM(*NO) MFRTYPMDL(*HP4) +We strongly recommend that you either use this transform exit-program or set up two output-queues, one for *AFPDS and one for normal (*SCS) spooled-files. This is because the transformation of *SCS spooled-files is not required by PDFing and uses OS400 resources unnecessarily. This program may not be able to convert "complex" *AFPDS spooled-files, in case of errors, see our F.A.Q.
USRDTATFM(PDFING/PDFING)
DSPDTA()
,"Authority to Check"
AUTCHK()
and "Operator Control"
OPRCTL()
to override the basic object authorities. These parameters control
which
users can display, move or change spooled-files on the output queue.
DSPDTA(*NO)
is set, then only the owner of the spooled-file can display or move the
spooled-files, unless: AUTCHK(*DTAAUT)
is set. AUTCHK(*OWNER)
is set.
DSPDTA(*YES)
is set, then any user with *READ authority to the output queue can
display or move the spooled-file.
DSPDTA(*OWNER)
is set, then only the owner of the spooled-file can display or move the
spooled-files, unless: OPRCTL(*YES)
is set. AUTCHK(*OWNER)
is set, then only the owner of the spooled-file can change or delete
the spooled-files.
If the output queue parameter AUTCHK(*DTAAUT)
is set, then any user with *READ *ADD and *DLT authorities to the
output queue can change or delete the spooled-files.
OPRCTL(*YES)
is set, then any user with *JOBCTL special authority can perform any
operation on the spooled-files, provided that the output queue
parameter DSPDTA(*OWNER)
is not set. SPLFOWN()
parameter when
creating, changing or overriding the printer device-file that creates
a spooled-file.
CRTDEVPRT DEVD(yourname) DEVCLS(*VRT) TYPE(3812) MODEL(1) FONT(011)As well as creating the printer-device named
yourname
,
this command will also create a new output-queue named:
yourname
in
library: QUSRSYS
QUSRSYS/yourname
as a "remote"
output-queue with the same parameter values as any other PDFing queue.
After configuration, you must execute command STRRMTWTR
to start a remote-writer on this queue.