BDCWAIT - USAP Command
Description
The BDCWAIT command allows USAP to reconnect to a started batch input processing job and monitor it, and all its generated session processing jobs, through completion.
Command Line Syntax
The following figure illustrates the command line syntax of the BDCWAIT command, using the command line, long form of its configuration options.
-bdcwait-jobname jobname -jobid jobid [-poll seconds] [-job_stat_check option] [-job_stat_check_interval seconds] [-joblog {yes|no}] [-applog {yes|no}] [-printapprc {yes|no}] [-useapprc {yes|no}] [-transtab translation_table] [-purge] [-purge_bdc_map {yes|no}] [-syslog {yes|no} [-syslogpre seconds] [-syslogpost seconds] [-terminatedec exitcode] [-finishedec exitcode] [-maxspoolsizeexceededec exitcode] [-qtobecreatedec exitcode] [-qunprocessedec exitcode] [-qinbackgroundec exitcode] [-qfinishedec exitcode] [-qerrorec exitcode] [-bdcjobnameptrn pattern] [-bdcjobidptrn pattern] [-bdcqidptrn pattern]
Configuration Options
The following table describes all BDCWAIT configuration options and provides the command line, long form of each option illustrated in the BDCWAIT command line syntax, above.
Configuration | Command Line | Description |
---|---|---|
-bdcwait | Causes USAP to perform batch input monitoring for the job being started. | |
-job_stat_check | Specification to enable or disable calls to SAP function module BAPI_XBP_JOB_STATUS_CHECK, which are used to synchronize the actual job status with the R/3 stored status. | |
-finishedec | USAP exit code for the SAP job finished status. | |
-terminatedec | USAP exit code for the SAP job terminated status. | |
-maxspoolsizeexceededec | Minimum exit code that will be set if an attempt is made to return a spool list that exceeds the maximum size for job logs as specified by the MAX_SPOOL_LIST_SIZE USAP configuration option. | |
-qinbackgroundec | USAP exit code for the SAP queue state 'S' (in background). | |
-qtobecreatedec | USAP exit code for the SAP queue state 'C' (to be created). | |
-qerrorec | USAP exit code for the SAP queue state 'E' (error). | |
-qfinishedec | USAP exit code for the SAP queue state 'F' (finished). | |
-qunprocessedec | USAP exit code for the SAP queue state ' ' (unprocessed). | |
-jobid | Job ID of an existing SAP job to use as a model for the new job definition. | |
-jobname | Name of an existing SAP job to use as a model for the new job definition. | |
-bdcjobidptrn | Locates the header record and determines the offset of the job ID in the RSBDCSUB batch input processing report. | |
-bdcjobnameptrn | Locates the header record and determines the offset of the job name in the RSBDCSUB batch input processing report. | |
-purge_bdc_map | Specification for whether or not to delete BDC Batch input session queues that have been processed successfully. | |
-purge | Purge job that has completed processing from SAP system. | |
-bdcqidptrn | Locates the header record and determines the offset of the queue ID in the RSBDCSUB batch input processing report. | |
-applog | Specification for whether or not the job's application log is returned. | |
-printapprc | Specification for whether or not the job's application return codes are returned. | |
-joblog | Specification for whether or not the job's joblog is returned. | |
-job_stat_check_interval | Length of time that can elapse, without a change in job status, before a call will be made to synchronize the actual job status with the SAP stored status. | |
-syslog | Specification for whether or not a syslog report is generated on standard error if the job does not complete successfully. | |
-syslogpost | Length of time to add to the job end time when calculating the to time for the syslog report. | |
-syslogpre | Length of time to subtract from the job release time when calculating the from time for the syslog report. | |
-transtab | Spoollist translation table file to use for formatting returned spoollists. | |
-poll | Length of time to wait between job status calls to the SAP system. | |
-useapprc | Specification for whether or not the job's application return codes are used to determine the exit code of the USAP job. |