Skip to main content

Running Job on SAP Using 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.

-jobname

Job name of the SAP job that will be used as a template.

-jobid

Job ID of the SAP job that will be used as a template.

-start

Specification that Universal Connector will instruct the SAP system to start the submitted job.

-wait

Specification that Universal Connector will monitor the started job until it completes.

-joblog

Specification that Universal Connector will return the SAP log for the started job.

-spoollist

Specification that Universal Connector will return any spool lists created by the started job.

Components

Universal Connector for z/OS