...
When Universal Connector is using pre-defined SAP jobs as template jobs (rather than Universal Connector job definition files), it may be necessary or desirable to replace the variants specified in the template job with variants more appropriate for the current job run. In this case, Universal Connector's target_variant option can be used to accomplish the variant substitution.
Panel |
---|
Html bobswift |
---|
<pre>
//USPVARSB JOB CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID
//*****************************************************************
//* Description
//* -----------
//* This sample demonstrates the use of USAP's target_variant
//* option to perform variant substitution when using pre-defined
//* SAP jobs as templates.
//*
//* NOTE: This job assumes (and requires) that a job already
//* exists on an the SAP system with:
//* Job Name: VARSBST1
//* Job ID: 12345678
//*
//* This sample will:
//* 1. Modify variants SBT1 and SBT2 with values required for this
//* job run.
//* 2. Submit a new job to the SAP system using a pre-existing SAP
//* job as a template.
//* 3. Perform variant substitution on the newly created job. The
//* newly created job will now use variants SBT1 and SBT2 for
//* steps 1 and 2 respectively (regardless of what variants
//* were defined in the template job).
//* 4. Wait for the job to complete.
//* 5. Return the job log.
//* 6. Return the spool list.
//*
// JCLLIB ORDER=#SHLQ.UNV.SUNVSAMP
//*
//*****************************************************************
//* Modify variant 'SBT1' for ABAP program RSUSR002
//*****************************************************************
//STEP1 EXEC USPPRC
//VARDEF DD *
/* Variant Header statement. */
VARIANT_NAME = "SBT1"
REPORT = "RSUSR002";
/* User */
SELNAME = "USER"
KIND = "S"
SIGN = "I"
OPTION = "CP"
LOW = "STONEBRANCH"
HIGH = "";
//SYSIN DD *
-dest CF5
-client 800
-userid sapuid
-pwd sappwd
-modify VARDEF
/*
//*****************************************************************
//* Modify variant 'SBT2' for ABAP program RSUSR002
//*****************************************************************
//STEP2 EXEC USPPRC
//VARDEF DD *
/* Variant Header statement. */
VARIANT_NAME = "SBT2"
REPORT = "RSUSR002";
/* User */
SELNAME = "USER"
KIND = "S"
SIGN = "I"
OPTION = "CP"
LOW = "STONEBRANCH1"
HIGH = "";
//SYSIN DD *
-dest CF5
-client 800
-userid sapuid
-pwd sappwd
-modify VARDEF
/*
//*****************************************************************
//* Run SAP job using a pre-defined SAP job as a template and
//* perform variant substitution.
//*
//* NOTE: This job assumes (and requires) that a job already
//* exists on an the SAP system with:
//* Job Name: VARSBST1
//* Job ID: 12345678
//*
//* The pre-defined job must have ABAP program RSUSR002 defined in
//* step one and step two.
//*****************************************************************
//STEP3 EXEC USPPRC
//SYSIN DD *
-dest CF5
-client 800
-userid sapuid
-pwd sappwd
-run
-jobname VARSBST1
-jobid 12345678
-target_variant 1,SBT1;2,SBT2
/*
</pre>
|
|
SYSIN Options
SYSIN options used in this example are:
HTML Table |
summary |
---|
cellspacing | 0 |
---|
style | text-align: left; width: 100%; |
---|
class | Table_with_Header |
---|
|
Table Row (tr) |
---|
Table Cell (td) |
---|
style | background-color: #F0F0F0; border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: middle; width: 108pt; |
---|
| Command Options |
Table Cell (td) |
---|
style | background-color: #F0F0F0; border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: middle; width: 324pt; |
---|
| Description |
|
Table Row (tr) |
---|
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| -dest |
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| Named set of connection parameters (destination) 'CF5'. These connection parameters are used for communications with the SAP system. The default file for destination parameters is #HLQ.UNV.USPRFC00. |
|
Table Row (tr) |
---|
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| -client |
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| SAP client number that Universal Connector will communicate with. |
|
Table Row (tr) |
---|
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| -userid |
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| Remote user ID with which to execute the command. |
|
Table Row (tr) |
---|
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| -pwd |
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| Password for the user ID. |
|
Table Row (tr) |
---|
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| -sub |
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| Specification that Universal Connector will issue the SUBMIT command. |
|
Table Row (tr) |
---|
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| -start |
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| Specification that Universal Connector will instruct the SAP system to start the submitted job. |
|
Table Row (tr) |
---|
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| -targetserver |
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| Target server for the SAP job to run on. |
|
Table Row (tr) |
---|
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| -wait |
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| Specification that Universal Connector will monitor the started job until it completes. |
|
Table Row (tr) |
---|
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| -joblog |
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| Specification that Universal Connector will return the SAP log for the started job. |
|
Table Row (tr) |
---|
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| -spoollist |
Table Cell (td) |
---|
style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
---|
| Specification that Universal Connector will return any spool lists created by the started job. |
|
|
...