Configure Output from SAP Spool¶

The printer is configured for BC-XOM in the SAP system. The BC-XOM interface from SEAL Systems accepts the job and transmits it via IPP or IPPS to the PLOSSYS 5 server. PLOSSYS 5 processes the job and returns the job status to the SAP system via RFC callback.

sap

Requirement on RHEL Prior to Version 8¶

If you use PLOSSYS 5 on RHEL prior to version 8 and you want to send replies to SAP, you have to install the /lib64/libstdc++.so.6 library explicitly. For more information, refer to https://launchpad.support.sap.com/#/notes/2338763.

Install SAP NetWeaver RFC¶

Open SAP Launchpad in a Web browser: https://launchpad.support.sap.com/
Log on with your SAP user name and password.
In SAP Launchpad, search for the OSS number 2573790.
Follow the download link for SAP NW RFC SDK 7.50 and save the current version.
Unpack SAP NW RFC SDK:
```
unzip nwrfc750P_6-70002752.zip
```
Copy the directory tree from nwrfcsdk into the following directory:
```
/usr/local/
```

Configure SAP NetWeaver RFC with an Application Server¶

Create /etc/ld.so.conf.d/saprfc.conf with the following content:
```
/usr/local/nwrfcsdk/lib
```
Execute the following command:
```
sudo ldconfig
```
Create the following directory unless it already exists:
```
sudo mkdir -p /opt/seal/etc
```
If the connection to the SAP system is established via an application server, specify the SAP connections settings in the SAP configuration file /opt/seal/etc/sapnwrfc.ini:
```
ASHOST=<ip_address>
SYSNR=<number>
```
Example - SAP configuration file sapnwrfc.ini
```
DEST=W74
ASHOST=10.100.100.100
TRACE=0
USER=sapuser
PASSWD=sappassword
CLIENT=310
SYSNR=01
```
The sapnwrfc.ini configuration file has the same syntax as saprfc.ini.

Literature - saprfc.ini

The saprfc.ini file is described in SAP Basis Configuration - Server.
Restart the following service:
- seal-job-notifier

Configure SAP NetWeaver RFC with a Message Server¶

Create /etc/ld.so.conf.d/saprfc.conf with the following content:
```
/usr/local/nwrfcsdk/lib
```
Execute the following command:
```
sudo ldconfig
```
Create the following directory unless it already exists:
```
sudo mkdir -p /opt/seal/etc
```
Enter the connection data of the SAP system into /opt/seal/etc/sapnwrfc.ini:
```
MSHOST=<hostname>
GROUP=<goupname>
```
Example - SAP configuration file sapnwrfc.ini
```
DEST=W74
MSHOST=10.100.100.100
GROUP=PUBLIC
CLIENT=000
USER=rfctest
PASSWD=ides1234567
TRACE=0
```
Example - SAP configuration file sapnwrfc.ini with R3NAME
```
DEST=WMS
R3NAME=W74
GROUP=PUBLIC
MSHOST=10.100.100.100
CLIENT=000
USER=rfctest
PASSWD=ides1234567
TRACE=0
```
The sapnwrfc.ini configuration file has the same syntax as saprfc.ini.

Literature - saprfc.ini

The saprfc.ini file is described in SAP Basis Configuration - Server.
Specify the port of the SAP system in the following file:
```
/etc/services
```
Restart the following service:
- seal-job-notifier

Configure BC-XOM in SAP¶

Literature - BC-XOM

The configuration of BC-XOM in SAP is described in BC-XOM - OMS Connection.

Hint - supported

PLOSSYS 5 only supports OMS Server or OMS Submit and the transmission via IPP.

Configure the SAP Spool Output on the OMS Server¶

The OMS Server checks whether the format of the SAP output job is SAPGOF. If this is the case, the OMS Server creates the SAP_OMS_FILE_FORMAT=OTF header parameter and PLOSSYS 5 converts the SAP output job. Otherwise, PLOSSYS 5 spools the SAP output job.

For configuring the check, edit the following file:

server/sapserv/conf/oms-submit.cfg

and specify the following setting:

[OMS_SUBMIT]
CHECK_FORMAT Y

Configure the SAPGOF Converter on the PLOSSYS 5 Server¶

Literature - SAPGOF Converter

For further information about how to configure the SAPGOF Converter, refer to the SAPGOF Converter documentation.

By default, the SAPGOF Converter uses the following configuration files:

/opt/seal/seal-convert-sapgof/lib/config/CONFIG
/opt/seal/seal-convert-sapgof/lib/config/GRIBS74_PDF_DB

For using another configuration, specify the following Consul keys:

CONFIG: Customized content of the CONFIG configuration file
GRIBS74_PDF_DB: Customized content of the GRIBS74_PDF_DB configuration file

Import the `CONFIG` File with PLOSSYS CLI ¶

Copy /opt/seal/seal-convert-sapgof/lib/config/CONFIG to config_tmp.yml.
Adjust config_tmp.yml according to the YAML format by indenting each line by four blanks and inserting the following lines at the beginning of the file:
```
convert-sapgof:
  CONFIG:
```
Hint - syntax

The data consists of multiple lines. For preserving the line endings, store the value in literal style, indicated by a |. You have to indent all lines of the text. The leading spaces will not be part of the data retrieved by the service.
Example - literal style
```
convert-sapgof:
  CONFIG: |
    This is a
    multiline
    value.
```
Customize the settings in config_tmp.yml and save the file.
Import the file to Consul:
```
plossys config import config_tmp.yml`
```
Restart the following service:
- seal-convert-sapgof

Import the `GRIBS74_PDF_DB` File with PLOSSYS CLI ¶

Copy /opt/seal/seal-convert-sapgof/lib/config/GRIBS74_PDF_DB to gribs_tmp.yml.
Adjust gribs_tmp.yml according to the YAML format by indenting each line by four blanks and inserting the following lines at the beginning of the file:
```
convert-sapgof:
  GRIBS74_PDF_DB:
```
Customize the settings in gribs_tmp.yml and save the file.
Import the file to Consul:
```
plossys config import gribs_tmp.yml
```
Restart the following service:
- seal-convert-sapgof

Advanced Configuration¶

The following keys influence the behavior of the output from SAP:

MAX_INSTANCES: Maximum of parallel conversions
TIMEOUT: Time interval after which a conversion is aborted if it has not generated any new data

For how to configure the stamping of SAP output jobs, refer to Configure Stamps from SAP Output Jobs.