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

Products

• Spool

Issue/Introduction

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

 

Resolution

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 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 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

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

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

 

1. 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 Spool task.
      
      DEFNODE TCPIP,TCPIP,GROUP=1,CLASS=A123,ACQUIRE=WORK,RELEASE=NOWORK,SEP=0
      NODE STD1,TCPIP,TCPDRIV=LPR