TPX Batch receiving errors REQUIRED PARAMETER LIST MISSING and UNKNOWN COMMAND.

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

Description:

When TPX Batch SYSIN looks correct yet the job is failing with these errors, check that the JCL does not have numbers in columns 72-80.

Solution:

TPX batch is flexible in allowing your batch command input to be spread over several input lines.

If your JCL member has NUMBER ON, the numbers in columns 72-80 will be read in as part of the SYSIN commands and fail with errors.

For example:

This batch job looks OK

//BATCHADM EXEC TPX,VNODE='*BATCH*'         
//EXTFIL1  DD UNIT=SYSDA,SPACE=(CYL,(1,1)),DISP=(MOD)        
//RPTFIL1  DD SYSOUT=*                                     
//SYSIN DD *                                                 
EXTRACT GIVING(EXTFIL1) PROFILE AND MATCHING SESSIONS        
    (PENTOPTI(Y))                                            
SET RTITLE1 ' Profile   SessionID  ApplID    Invisible '     
SET RTITLE2 ' ========  =========  ========  =========   '   
REPORT GIVING(RPTFIL1) USING(EXTFIL1)                        
    ((' &PIDXNAME' ' &PENTUSER' '  &PENTAPPL' ' &PENTOPTI' ))
/*                                                           
//                                                           
 

But fails with the following output:

TPBL1000 09/10/10.253 15:37:53.35 EXTRACT GIVING(EXTFIL1) PROFILE AND MATCHING SESSIONS                   00220001
TPBL1012 09/10/10.253 15:37:53.35 REQUIRED PARAMETER LIST MISSING               
TPBL1000 09/10/10.253 15:37:53.35     (PENTOPTI(Y))                                                       00221001
TPBL1011 09/10/10.253 15:37:53.35 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.35 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.35 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.35 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.35 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.35 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.35 UNKNOWN COMMAND                               
TPBL1000 09/10/10.253 15:37:53.35 SET RTITLE1 ' Profile   SessionID  ApplID    Invisible '                00222001
TPBL1011 09/10/10.253 15:37:53.35 UNKNOWN COMMAND                               
TPBL1000 09/10/10.253 15:37:53.35 SET RTITLE2 ' ========  =========  ========  =========   '              00231001
TPBL1011 09/10/10.253 15:37:53.35 UNKNOWN COMMAND                               
TPBL1000 09/10/10.253 15:37:53.35 REPORT GIVING(RPTFIL1) USING(EXTFIL1)                                   00241001
TPBL1009 09/10/10.253 15:37:53.36          0 Records read USING (EXTFIL1 )      
TPBL1012 09/10/10.253 15:37:53.36 REQUIRED PARAMETER LIST MISSING               
TPBL1000 09/10/10.253 15:37:53.36     ((' &PIDXNAME' ' &PENTUSER' '  &PENTAPPL' ' &PENTOPTI' ))           00260001
TPBL1011 09/10/10.253 15:37:53.36 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.36 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.36 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.36 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.36 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.36 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.36 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.36 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.36 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.36 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.36 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.36 UNKNOWN COMMAND                               
TPBL1011 09/10/10.253 15:37:53.36 UNKNOWN COMMAND                               
TPBL1009 09/10/10.253 15:37:53.36          6 records read from SYSIN            
 

In your JCL member, enter command PROF to see the profile values, and line command COLS to show the columns:

=PROF> ....CNTL (FIXED - 80)....RECOVERY OFF WARN....NUMBER ON STD.............
=PROF> ....CAPS OFF....HEX OFF....NULLS ON STD....TABS OFF.....................
=PROF> ....AUTOSAVE ON....AUTONUM OFF....AUTOLIST OFF....STATS ON..............
=PROF> ....PROFILE UNLOCK....IMACRO NONE....PACK OFF....NOTE ON................
=PROF> ....HILITE OFF CURSOR FIND..............................................
002100 //SYSIN DD *                                                            
=COLS> ----+----1----+----2----+----3----+----4----+----5----+----6----+----7--
002200 EXTRACT GIVING(EXTFIL1) PROFILE AND MATCHING SESSIONS                   
002210     (PENTOPTI(Y))                                                       
002220 SET RTITLE1 ' Profile   SessionID  ApplID    Invisible '                
002310 SET RTITLE2 ' ========  =========  ========  =========   '              
002410 REPORT GIVING(RPTFIL1) USING(EXTFIL1)                                   
002600     ((' &PIDXNAME' ' &PENTUSER' '  &PENTAPPL' ' &PENTOPTI' ))           
002700 /*                                                                      
002800 //                                                                      
 

Scrolling right shows the numbers hidden in columns 72-80:

=PROF> ....CNTL (FIXED - 80)....RECOVERY OFF WARN....NUMBER ON STD.............
=PROF> ....CAPS OFF....HEX OFF....NULLS ON STD....TABS OFF.....................
=PROF> ....AUTOSAVE ON....AUTONUM OFF....AUTOLIST OFF....STATS ON..............
=PROF> ....PROFILE UNLOCK....IMACRO NONE....PACK OFF....NOTE ON................
=PROF> ....HILITE OFF CURSOR FIND..............................................
002100 DD *                                                            00210001
=COLS> -1----+----2----+----3----+----4----+----5----+----6----+----7----+----8
002200 GIVING(EXTFIL1) PROFILE AND MATCHING SESSIONS                   00220001
002210 TOPTI(Y))                                                       00221001
002220 LE1 ' Profile   SessionID  ApplID    Invisible '                00222001
002310 LE2 ' ========  =========  ========  =========   '              00231001
002410 IVING(RPTFIL1) USING(EXTFIL1)                                   00241001
002600 &PIDXNAME' ' &PENTUSER' '  &PENTAPPL' ' &PENTOPTI' ))           00260001
002700                                                                 00270001
002800                                                                 00280001
 

Command UNNUM will change this to NUM OFF and deleting the offending numbers will resolve the problem.