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.
Ā 

//USPPRC   PROC UPARM=,               -- USAP options
//             SAPRFC=USPRFC00,       -- SAP RFC member
//             USAPPRE=#SHLQ.UNV,
//             USAPPRD=#PHLQ.UNV
//*
//PS1      EXEC PGM=USAP,PARM='ENVAR(TZ=EST5EDT)/&UPARM'
//STEPLIB  DD  DISP=SHR,DSN=&USAPPRE..SUNVLOAD
//*
//UNVNLS   DD  DISP=SHR,DSN=&USAPPRE..SUNVNLS
//UNVRFC   DD  DISP=SHR,DSN=&USAPPRD..UNVCONF(&SAPRFC)
//UNVTRACE DD  SYSOUT=*
//*
//SYSPRINT DD  SYSOUT=*
//SYSOUT   DD  SYSOUT=*
//CEEDUMP  DD  SYSOUT=*

Ā 
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.
Ā 

//jobname  JOB CLASS=A,MSGCLASS=X
//STEP1    EXEC USPPRC
//SYSIN    DD  *
  -dest BIN_45 -client 850 -userid user -pwd password  
  -run
  -jobname SAMPLE1   
  -jobid 13203001  
  . . .
/*

Ā 
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.
Ā 

usap Ā  Ā  Ā {RUNĀ |Ā SUBMITĀ | MODIFYĀ | STARTĀ |Ā WAITĀ |Ā ABORTĀ |Ā DISPLAYĀ |Ā GENERATEĀ |Ā PURGEĀ |Ā CRITERIA MANAGEMENTĀ |Ā PROCESS CHAINĀ |Ā INFO PACKAGESĀ |Ā SYNTAXĀ |Ā RAISE EVENT}

HOSTUSERĀ [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:
Ā 

usapĀ -subĀ file.uspĀ -immediate-clientĀ  987Ā -destĀ BIN_HS0092Ā -useridĀ 123Ā -pwdĀ ABCĀ -Ā langĀ englishĀ -levelĀ info