Universal Connector for SAP for zOS


Introduction

This information is specific to Universal Connector for SAP (USAP) for the z/OS operating system.

Usage

Universal Connector for SAP for z/OS executes as a batch job.

Each batch job contains:

  1. JCL interface to the command line.
  2. Configuration options associated with the specified command.
  3. Configuration options (required and optional) not associated with any specific command.

Universal Connector for SAP performs an operation specified by the command. The configuration options describe the actions to take for that operation.

This section describes the JCL and command line syntax of Universal Connector for SAP for z/OS.

JCL Procedure

The following figure illustrates the Universal Connector for SAP for z/OS JCL procedure (USPPRC, located in the SUSPSAMP library) that is provided to simplify the execution JCL and future maintenance.
 

 
The parameter UPARM specifies EXEC PARM keyword values. The parameter CONFIG specifies the configuration member. The parameter SAPRFC specifies the SAP RFC configuration member. The parameter USAPPRE specifies the data set name prefix of USAP installation data sets.

DD Statements used in JCL Procedure

The following table describes the DD statements used in the Universal Connector for SAP for z/OS JCL procedure, above.
 

ddname

DCB Attributes *

Mode

Description

STEPLIB

DSORG=PO,
RECFM=U

input

Load library containing the program being executed.

UNVNLS

DSORG=PO,
RECFM=(F, FB, V, VB)

input

USAP national language support library. Contains message catalogs.

UNVRFC

DSORG=PS,
RECFM=(F, FB, V, VB)

input

SAP Remote Function Call (RFC) configuration member.

UNVTRACE

DSORG=PS,
RECFM=(F, FB, V, VB)

Output

USAP trace output.

SYSPRINT

DSORG=PS,
RECFM=(F, FB, V, VB)

output

Standard output file for the USAP program.

SYSOUT

DSORG=PS,
RECFM=(F, FB, V, VB)

output

Standard error file for the USAP program.

* The C runtime library determines the default DCB attributes. Refer to the IBM manual OS/390 C/C++ Programming Guide for details on default DCB attributes for stream I/O.

JCL

The following figure illustrates the Universal Connector for SAP for z/OS JCL using the USPPRC JCL procedure, above.
 

 
Job step STEP1 executes the procedure USAPPRC.

The command options are specified on the SYSIN DD.

Command Line Syntax

The following figure illustrates the command line syntax of Universal Connector for SAP for z/OS.
 

{RUN
SUBMIT
MODIFY
START
WAIT
ABORT
DISPLAY
GENERATE
PURGE
CRITERIA MANAGEMENT

PROCESS CHAIN

INFO PACKAGES
SYNTAX
RAISE EVENT}

HOST

USER
CFT
EVENT
INFORMATIONAL
LOCAL
MESSAGE
RFC
COMMAND FILE

 
Names enclosed in {BRACES} identify command groups. For each execution, a single command is specified from one of these groups. One or more configuration options associated with each command also can be used to specify additional information / actions for the execution. See Universal Connector for SAP Commands for detailed information on the commands, and their associated configuration options, in each command group.

Names enclosed in [BRACKETS] identify categories of configuration options that are not associated with specific commands and from which options are not required.

Names not enclosed in {BRACES} or [BRACKETS] identify categories of configuration options that are not associated with specific commands but from which one or more options are required.

See Universal Connector for SAP Configuration Options for Program Execution for detailed information on configuration options not associated with one or more commands.

Example

The following is an example of a command line syntax executing Universal Connector for SAP:
 

-sub
-immediate
-client
-dest
-userid
-pwd
-lang
-level