Running Job on SAP Using SAP Job - zOS

Owned by
Stonebranch
Feb 06, 2023
3 min read

Running a Job on an SAP System Using a Pre-existing SAP Job - z/OS

This example illustrates running a job on an SAP system using a pre-existing SAP job.


//USPRUN1  JOB CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID                     
//*****************************************************************
//* Description
//* -----------
//* This sample will:
//* 1. Submit a new job to an SAP system using a pre-existing SAP 
//*    job as a template.
//* 2. Start the newly created job.
//* 3. Wait for the job to complete.
//* 4. Return the job log.
//* 5. Return the spool list.
//* 6. The SAP job completion status will be mapped to an exit 
//*    code.  USAP will exit with the mapped exit code. 
//* 
//* NOTE: This job assumes (and requires) that a job already 
//* exists on the SAP system with:
//* Job Name: USPRUN1
//* Job ID:   12345678
//*
//         JCLLIB ORDER=#SHLQ.UNV.SUNVSAMP                           
//*                                                                  
//STEP1    EXEC USPPRC                                               
//SYSIN    DD  *                                                     
   -dest      CF5 
   -client    800 
   -userid    sapuid 
   -pwd       sappwd      
   -sub  
   -jobname   USPRUN1 
   -jobid     12345678
   -start
   -wait
   -joblog    yes
   -spoollist yes
/*

SYSIN Options

SYSIN options used in this example are:

Command Options

Description

-dest

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.

-client

SAP client number that the Universal Connector will communicate with.

-userid

Remote user ID with which to execute the command.

-pwd

Password for the user ID.

-sub

Specification that Universal Connector will issue the SUBMIT command.

-jobnameJob name of the SAP job that will be used as a template.
-jobidJob ID of the SAP job that will be used as a template.
-startSpecification that Universal Connector will instruct the SAP system to start the submitted job.
-waitSpecification that Universal Connector will monitor the started job until it completes.
-joblogSpecification that Universal Connector will return the SAP log for the started job.
-spoollistSpecification that Universal Connector will return any spool lists created by the started job.

Components

Universal Connector for z/OS