Customization › Subsystem Name › Started Task

Started Task

The CA Spool system runs as a started task, which is initiated from an MVS console. This requires that a procedure is available in a procedure library known to the primary JES system.

The following is a sample procedure:

//CAIQPOOL PROC MEMBER=CAIQPARM,              * Initialization Parms      
//         LOADLIB='CAI.SPOOL.CBQ4LOAD',      * CA Spool Load Library     
//*        LOADLBC='CAI.SPOOL.CE0CLOAD',      * CA Spool C Transformers   
//         SASCLIB='CAI.CSARLOAD',            * SAS/C Runtime Library     
//         PARMLIB='CAI.CBQ4PARM',            * Parmlib library           
//         OPTION=WARM                        * Start options             
//*********************************************************************   
//*                                                                   *   
//*                     CA Spool V12.0                                *   
//*                                                                   *   
//*  Tailor the Proc as required by your setup                        *   
//*                                                                   *   
//*  Copyright (c) 2014 CA. All rights reserved.                      *   
//*********************************************************************   
//IEFPROC EXEC PGM=ESFMAIN,TIME=1440,REGION=0M,PARM=&OPTION               
//STEPLIB  DD  DISP=SHR,DSN=CEE.SCEERUN       * LE run-time library       
//         DD  DISP=SHR,DSN=&LOADLIB          * CA Spool Load Library     
//*        DD  DISP=SHR,DSN=&LOADLBC          * CA Spool C Transformers   
//         DD  DISP=SHR,DSN=&SASCLIB          * SAS/C Load Library        
//*        DD  DISP=SHR,DSN=CAI.VIEW.CBRMLOAD * CA View Load Library      
//*        DD  DISP=SHR,DSN=CAI.XCOM.CBGXLOAD * CA XCOM Load Library      
//*        DD  DISP=SHR,DSN=$CD.LINKLIB       * Connect:Direct Load Lib 

//ESFPARM  DD  DISP=SHR,DSN=&PARMLIB(&MEMBER) * Initialization Parms  
//ESFLIST  DD  SYSOUT=*,OUTLIM=0                                      
//SYSPRINT DD  SYSOUT=*                                               
//SYSTERM  DD  DUMMY                                                  
//SYMDUMP  DD  DUMMY                                                  
//*NJESNAP  DD  SYSOUT=*                      * NJE trace              
//*SAPISNAP DD  SYSOUT=*                      * SAPI trace             
//*SECUSNAP DD  SYSOUT=*                      * SAF trace              
//*-------------------------------------------------------------------*
//*  Local IMAGELIB libraries.                                        *
//*-------------------------------------------------------------------*
//IMAGELIB DD  DISP=SHR,DSN=SYS1.IMAGELIB                              
//*        DD  DISP=SHR,DSN=**YOUR**.IMAGELIB                          
//*-------------------------------------------------------------------*
//*  Local TCPIP.DATA file.                                           *
//*-------------------------------------------------------------------*
//*SYSTCPD  DD  DISP=SHR,DSN=**YOUR**.TCPIP.DATA.FILE                  
//*-------------------------------------------------------------------*
//*  CA Spool Print formatting resource libraries.                    *
//*-------------------------------------------------------------------* 
//*PJLLIB   DD  DISP=SHR,DSN=**YOUR**.PJL.RESOURCE.LIBRARY            
//*PCLLIB   DD  DISP=SHR,DSN=**YOUR**.PCL.RESOURCE.LIBRARY            
//*BINLIB   DD  DISP=SHR,DSN=**YOUR**.BIN.RESOURCE.LIBRARY            
//*OVLYLIB  DD  DISP=SHR,DSN=**YOUR**.OVLY.RESOURCE.LIBRARY           
//*HTMLIB   DD  DISP=SHR,DSN=**YOUR**.HTML.RESOURCE.LIBRARY
//*MAILLIB  DD  DISP=SHR,DSN=**YOUR**.MAILBOOK.RESOURCE.LIBRARY    
//*-------------------------------------------------------------------*
//*  CA Spool AFP Transformer libraries.                              *
//*-------------------------------------------------------------------*
//*A2PCPARM DD  DISP=SHR,DSN=CAI.CE0CGEN(A2PCPARM)              
//*A2PCFCOR DD  DISP=SHR,DSN=**YOUR**.A2PCFCT <= FONT CORRELATION TABLE                       
//*A2PCREPT DD  SYSOUT=*                                              
//*A2PSPARM DD  DISP=SHR,DSN=CAI.CE0CGEN(A2PSPARM)              
//*AFPMFCT  DD  DISP=SHR,DSN=CAI.CE0CGEN(AFPMFCT)              
//*A2PSREPT DD  SYSOUT=*                                              
//*A2PDPARM DD  DISP=SHR,DSN=CAI.CE0CGEN(A2PDPARM)              
//*A2PDREPT DD  SYSOUT=*                                              
//*PSEGPDS  DD  DISP=SHR,DSN=**PSF**.PSEGLIB                          
//*FDEFPDS  DD  DISP=SHR,DSN=**PSF**.FDEFLIB                          
//*PDEFPDS  DD  DISP=SHR,DSN=**PSF**.PDEFLIB                          
//*OVLYPDS  DD  DISP=SHR,DSN=**PSF**.OVERLIB                          
//*FONTPDS  DD  DISP=SHR,DSN=**PSF**.FONTLIB                          
//*FONTPDS3 DD  DISP=SHR,DSN=**PSF**.FONT300                          
//*-------------------------------------------------------------------*
//*  Common FTP, CA XCOM and Connect:Direct userid/password file      *
//*-------------------------------------------------------------------*
//*NETRC	     DD  DISP=SHR,DSN=&PARMLIB(IQNETRC)                        
//*-------------------------------------------------------------------*
//*  CA XCOM libraries.                                               *
//*-------------------------------------------------------------------*
//*XCOMCNTL DD  DISP=SHR,DSN=CAI.XCOM.CBXGPARM                        
//*XCOMSYSI DD  DISP=SHR,DSN=&PARMLIB(IQXCOMPR)                       
//*SYSIN01  DD  DSN=&SYSIN01,UNIT=SYSDA,SPACE=(TRK,(1,1))             
//*LCLDS01  DD  DSN=&LCLDS01,UNIT=SYSDA,SPACE=(CYL,(10,10))           
//*-------------------------------------------------------------------*
//*  Connect:Direct libraries.                                        *
//*-------------------------------------------------------------------*
//*DMNETMAP DD  DISP=SHR,DSN=$CD.NETMAP                               
//*DMPUBLIB DD  DISP=SHR,DSN=$CD.PROCESS                              
//*DMMSGFIL DD  DISP=SHR,DSN=$CD.MSG                                  
//*DMPRINT  DD  SYSOUT=*                                              
//*                                         

The following statements are mandatory:

• The PROC statement is required.
• The EXEC statement is required and must execute the CA Spool main load‑module, which is normally assigned the name ESFMAIN.
  • The TIME and REGION parameters are optional system-dependent parameters; specify according to the site standards.
  • Information on how to estimate the CA Spool REGION size is found in the Appendix Storage Estimates.
• The PARM parameter is optional. For more information about the parameter, see the topic Initialization Options in the chapter Initialization of this guide.
• The STEPLIB DD statement points to the CA Spool load library, the LE run-time library and the SAS/C runtime library. If you are not using the STEPLIB DD statement, these libraries must be in linklist and APF authorized.
  • If you use the C Transformers, include the CE0CLOAD loadlib in the STEPLIB or in linklist.
  • If you use the following interfaces or drivers, include the load libraries from their products in the STEPLIB or in linklist:
    • Direct interface to CA View
    • CA Roscoe menu interface
    • CA XCOM print drivers
    • Connect:Direct print drivers
  • Verify that all loadlibs that CA Spool uses are APF-authorized.
• The ESFPARM DD statement is required and must point to a sequential file (optionally, a member of a PO data set) containing the CA Spool initialization-parameter statements. This file is accessed using the QSAM access method.
• The ESFLIST DD statement is only required if the LIST option is specified during CA Spool start-up.
• The SYSTERM DD statement provides SAS/C error messages. Activate this DD when necessary for debugging.
• The SYMDUMP DD statement is used in conjunction with the CA SymDump System for abend debugging.
• The NJESNAP DD statement is optional. If an NJE statement in startup parameters has TRACE specified, a trace is printed using this statement.
• The SAPISNAP DD statement is optional. If it is present, this statement is used to write a trace of all SAPI calls. We recommend that you do not include this statement, except for debugging purposes.
• The SECUSNAP DD statement is optional. If SECUEXT=SAF is specified and the statement is present in the startup procedure, a trace of all security calls is written using this statement. We recommend that you do not include this statement, unless for debugging purposes.
• The IMAGELIB DD statement is an optional statement, which is used to define an alternate FCB imagelib data set, which must be used instead of the standard SYS1.IMAGELIB. CA Spool uses this when loading FCBs and modules for the Advanced Laser Printer Interface. For more information, see the section Advanced Laser Printer Interface.
• The SYSTCPD DD statement points to the optional TCPIP.DATA file.

  Note: The use of DCB=BUFNO=n, where n is any number, is not recommended. This can cause increase in storage use and can result in storage abends.

• The PJLLIB DD statement points to the PJL resource library.
• The PCLLIB DD statement points to the PCL resource library.
• The BINLIB DD statement points to the binary resource library.
• The OVLYLIB DD statement points to the OVLY resource library.
• The HTMLIB DD statement points to the HTML resource library.
• The MAILLIB DD statement points to the email MAILBOOK resource library.