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:
- JCL interface to the command line.
- Configuration options associated with the specified command.
- 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, | input | Load library containing the program being executed. |
UNVNLS | DSORG=PO, | input | USAP national language support library. Contains message catalogs. |
UNVRFC | DSORG=PS, | input | SAP Remote Function Call (RFC) configuration member. |
UNVTRACE | DSORG=PS, | Output | USAP trace output. |
SYSPRINT | DSORG=PS, | output | Standard output file for the USAP program. |
SYSOUT | DSORG=PS, | 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: