How to transfer files from the JES queue to CA Spool by a specific sysout Form that have a destination attribute not defined in CA Spool?

Document ID : KB000054849
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

I have files in the JES queue with different Form values. The Destination is not defined in CA Spool and we do not want to define the destination in CA Spool. Can these files be transferred by the FORM name?

Solution:

XFERDEST provides the ability to transfer files by destination. Any value other than NO will turn on the transfer by destination interface for all printers(nodes) and alias printer names. Normally you would transfer files from JES to CA Spool by the destination attribute assigned to the sysout file and using either YES, FORCE, DEST or WRITER as the XFERDEST statement value. See below descriptions.

  • XFERDEST=NO
The interface is not turned on.
  • XFERDEST=YES
The interface will only transfer from dests known to JES.
  • XFERDEST=FORCE
The interface will transfer from all printers(nodes) and printer alias names without checking if those dests are defined to JES.
  • XFERDEST=DEST
The interface asks for output files with destination name equal to all defined printers(nodes) and printer names without checking if defined in JES.
  • XFERDEST=WRITER
The interface will ask for output files with a writer name equal to all defined printers(nodes) and printer alias names without checking if defined in JES.

Some customers only use a destination of LOCAL for all sysout files created in JES, but also specify a specific FORM name. We strongly suggest against defining a Dest of LOCAL to CA Spool. To transfer files by the FORM attribute you can add XFEROPT=14.

Using the SAPI interface, with the addition of XFEROPT=14 you can change how the XFER interface works. XFEROPT=14 changes or customizes how XFEROPT=6 works and will allow file selection to be performed when the file's form attribute (DD statement) or FORMS attribute (Output statement) matches a printer node name. This also requires statements XFERCLAS=n and XFERDEST=WRITER. Inclusion of XFERCLAS=n with any other selection criteria is turned on by XFEROPT=6

  1. Example of statements if you want to select files by form. These statement changes done in the CAIQPARM member require a recycle of the CA Spool task.

    • XFER=YES or XFER=JESTOESF
    • XFERDEST=WRITER
    • XFERCLAS=A123
    • XFERSAPI=YES
    • XFEROPT=14
    • XFEROPT=6

    1. Example of JCL.

      //JOBCARD
      //OUT1 OUTPUT FORM=STD1
      //STEP10 EXEC PGM=IEBGENER
      //SYSIN DD DUMMY
      //SYSUT1 DD DSN=esf.ppoption(caiqparm),DISP=SHR
      //SYSUT2 DD SYSOUT=A,DEST=LOCAL,OUPUT=*.OUT1

    2. Example of DEFNODE/NODE statement definition. These statement changes/additions only require a REINIT command issued to the CA Spool task.

      DEFNODE TCPIP,TCPIP,GROUP=1,CLASS=A123,ACQUIRE=WORK,RELEASE=NOWORK,SEP=0
      NODE STD1,TCPIP,TCPDRIV=LPR

  2. To restrict file selection from JES to CA Spool even further using Node parameter XFERNODE, please refer to Knowledge Document TEC432036.