Previous Topic: Monitor the Agent SystemNext Topic: Application Exploitation


XPJOB Conversion Utility for Agents

The conversion utility converts existing XPJOB jobs that run on UNIX or Windows operating environments to agent jobs. The utility provides a semi-automatic mechanism for changing your XPJOB jobs to agent jobs. The utility maintains any schedules, triggers, and requirements associated with the original XPJOB definition.

The conversion process has a number of conditions and rules so that the conversion from an XPJOB to an AGJOB completes successfully.

Note: For more information about XPJOB conversion, see the CA WA CA 7 Edition Interface Reference Guide.

The following is an overview of the conversion process:

Note: For more information, see the CA WA CA 7 Edition Interface Reference Guide.

The conversion utility does not handle jobs going to UJMA adapters such as SAP. Convert these jobs to an appropriate job type, such as SAP_JOB.

For example, a CA7TOUNI or XPJOB executing the SUBFILE/XP EXEC sapjob has PARMnn coded to specify the SAP job name, report parameters, variants, and so forth. The CA WA agent job type is SAP_JOB. The parameters you may see coded include the following:

UJMA Adapter Parameter

Agent Keyword Parameter

REPORT=<report>

ARCREPORT

VARIANT=<variant>

VARIANT

EXTPGM_NAME=<command>

 

EXTPGM_PARAM=<parm>

 

JOBCLASS=<jobclass>

SAPJOBCLASS

JOBUSER=<userid>

SAPUSER

JOBNAME=<jobname>

SAPJOBNAME

JOBCOUNT=<instance>

(for SAP Copy) JOBCOPY

START={I|A|C}

STARTMODE

DEFINE=YES

 

BDC=YES

 

SPOOL=YES

PRINTSPOOLNAME

CANCEL=YES

 

COPY=YES

SAP_JOB with JOBCOPY

STEPNUMBER=<step>

ABAPNAME

For CA7TOUNI or XPJOB jobs executing SUBFILE sapipkg (SAP InfoPackage), the job type is BWIP_JOB (Business Warehouse InfoPackage) and the parameters include the following:

UJMA Adapter Parameter

Agent Keyword Parameter

DATATARGET={E|C|P}

 

EXTSYSTYPE={A|C}

 

DATAFILENAME=<name>

 

DATAFILETYPE={A|E}

 

NAME=<ipkgname>

INFOPACK

POSTDATA={Y|N}

 

TECHNAME=<ipkgtechname>

 

BATCHWAIT={Y|N}

 

PRINTDETAIL={Y|N}

 

JOBNAME=<jobname>

SAPJOBNAME

IMMEDIATE=Y

 

For CA WA Agents, a PARAM control language keyword lets you specify various options.

For SAP Process Chains capchain, the job type is BWPC_JOB (Business Warehouse Process Chain) and the parameters include the following:

UJMA Adapter Parameter

Agent Keyword Parameter

IGNOREFAIL={Y|N}

 

LISTJOBLOG={B|E}

 

CHAINID=<chained>

CHAIN

LOGID=<logid|AUTO>

SAPUSER

START={A|R|S}

 

TIMEOUTSEC=<number>

 

TRACESAVE=Y

 

 

SAPJOBNAME (Required)

For SAP casapvar, update or create variants, no conversion is available.