Creating a Logical OMS

advertisement
Defining an Output Device for Printing with Output
Management Systems
Use
You want to make a output device that is served by an external output management system (OMS)
accessible for SAP printing and (optionally) faxing. To do this, you must create the corresponding
device definition in the SAP System.
This definition creates an output device that forwards the formatted print data to the OMS. The
OMS outputs the data independently of the SAP System.
Prerequisites

You require authorization to create output devices.

You must have already defined the external Output Management System (OMS) in the SAP spool system. The
definitions for the real OMS (ROMS) and logical OMS (LOMS) must already exist. For more information, see
Integrating the Spool System into an External Output Management System.

If you cannot already print from your host systems to your OMS output device, you must first install the output
device in the OMS.
Procedure
If you want to create an SAP output device definition for printing using an Output Management
System (OMS) follow the procedure below:
...
1. Call Spool Administration (transaction SPAD), and, on the Devices/Servers tab page, choose Output
Devices.
2.
3.
If you are not in change mode, switch to this mode by choosing
You can now do the following:
1. 
Change.
You can create a new device definition by choosing Output Device  Create.
2. 
4.
You can use an existing device definition as a template.
To do this, click the entry for the output device that is to be used as a template, and choose Output
Device  Create Using Template.
Specify the name of the output device and fill out the mandatory fields of the individual tab pages as follows:
Field
Input
Device
Attributes Tab Device Type
Page
Enter the device type defined in the SAP System for your printer
model.
For printing under Microsoft Windows, you can also use the
generic SWIN device type. This lets you use any device
supported by Microsoft Windows, even if the device type is not
defined in the SAP System.
For a list of the device types delivered, see SAP Note 8928 in
the SAP Service Marketplace.
Spool Server
Enter the name of the SAP spool server (application server with
the spool work process) that is to prepare the output for this
device.
Authorization
Group
To assign the output device to an authorization group, enter the
name here. For more information, see Authorization Groups for
Output Devices.
Host Spool
Access
Method
Access Method
Enter E, for printing using of an external output management
system.
Host Printer
Enter the name of the output device in the external OMS.
Logical OMS
Choose the LOMS to which this device should be assigned. A
LOMS specifies how the device is to be accessed in the
external output management system (OMS).
For more information, see Assigning OMS Output Devices to
Logical OMSs.
5. Optional: Classify the device. To do this, choose Edit  Classification and then the appropriate output type
classification for this device. Although classification of output devices is optional, it provides this advantage:
If you also classify your spool servers, the spool system checks that the device and server classifications match.
This helps to ensure an optimal output configuration.
6.
If you are preparing to assign a mass printer to a time-critical production server, then the spool system
warns you of this disparity.
Save the device definition and exit.
Result
The OMS output device is immediately available to SAP users and programs for printing ABAP lists
and SAPscript/Smart Form documents.
Integrating the Spool System into an External Output Management System
Purpose
External output management systems control printing operating in large, complex IT environments. You can
integrate the SAP spool system into an external output management system (OMS) of this type so that you
can use the functions of the OMS from your SAP System.
An example of a function of an external OMS: The OMS distributes a print request to 20 different printers.
You only need to define one output device in the SAP System that points to this OMS. If you print using
this output device, the request goes to the OMS, which then redirects it to the 20 printers. Without the
OMS, you would have to print 20 times in the SAP System.
Prerequisites

XOM Interface
You require the XOM application programming interface to be able to use your OMS for printing from an SAP
System.

Compatible OMS:
Your OMS must be compatible with the SAP System or you must implement the OMS interface yourself.
If you already have an OMS installed, then you must upgrade it so that it supports the XOM interface.
If you are buying an OMS, it should be one certified for the XOM interface.

Local Access
An OMS and all of the devices it serves must be "local" to all SAP spool servers. This means that the OMS
commands issued by SAP spool servers must be executable on the host system on which the corresponding
SAP spool server is running.
Explanation: An SAP R/3 spool server stores output data for an OMS device in a file on the host where the server
is running. This file is referenced in the OMS Submit command issued by the server, and the file must be
accessible to the OMS.
For more information about certified OMS products and implementing and certifying the OMS interface, see
http://www.sap.com/partners/software/.
Process Flow
Follow this procedure for each OMS you want to integrate into SAP output (if you have more than one OMS):
...
1. Define the OMS as a real OMS (ROMS).
The ROMS is the definition of the external OMS in your SAP System and specifies the properties of the external
OMS, such as whether the OMS is started using a command line or an RFC, or whether the status of the print
request is determined using polling (the SAP System queries the status) or callback (OMS informs the SAP
System about the status).
See: Defining a Real OMS (ROMS) in the SAP System
2. Optional: You can take an “inventory” of the output devices and if necessary assign your output devices to
different logical OMSs (LOMSs). In this way, you can categorize output devices that use the external OMS in the
same way and assign each category to a different group (LOMS).
Production printers should be traced using RFC callback, non-critical printers only using polling. You
should allow a LOM for each group. After you have defined this LOM (see step 3), you must assign the
devices to this LOM using the device definition.
Although classification into different LOMSs is optional, you must however create at least one LOMS. This is
because when you want to create an output device that forwards its print requests to an OMS (access method E),
you must assign it to an LOMS. It is not possible to assign devices directly to the real OMS.
See: Assigning Output Devices to Logical OMS (LOMS)
3. Define one or more logical OMSs (LOMS) in the SAP System. Only one is required.
See: Creating a Logical OMS
4. Define one or more sets of operating system specific commands.
You need at least one command set for each operating system on which your SAP R/3 servers are running.
See: Defining OMS Command Sets for LOMS
5. Make one or more of the OMS output devices available for use in SAP printing and faxing.
To do this, you must create the corresponding device definitions in the SAP System.
See: Defining an Output Device for Printing with Output Management Systems.
6. If you are working in a test system, replicate your OMS definitions in other SAP R/3 Systems.
See: Transporting OMS Definitions Between Systems.
7. During the production use of your OMS: If you are using RFC callback for reporting OMS job and device
status, you can force reconfiguration of the callback client.
This is an optional step. Usually the OMS callback client reconfigures itself.
See: Triggering OMS Reconfiguration
Defining a Real OMS (ROMS) in the SAP System
Use
To be able to integrate the SAP spool system into an external output management system (OMS), first define
the OMS as a real OMS (ROMS) in the spool system. The ROMS definition specifies the properties of the
external OMS to the SAP System. Not every OMS offers all of the operations that the OMS interface allows.
Therefore, when you create the real OMS in the SAP System, you should specify the options that are
supported by the OMS you are using.
Prerequisites

Your external OMS system should be installed and ready to run before you define it in the SAP System.

OMS manufacturers have the option of delivering a configuration file to you. If such a file is available, then
uploading it into the spool system creates the ROMS and operating system specific commands for you.
Before proceeding, check to see if such a file is available for your OMS.
Procedure
There are two ways to create a ROMS, depending on whether your OMS vendor provides a configuration file
or not.
If the OMS vendor provides a configuration file, you only need to upload the file. The ROMS is then
created for you. For more information about uploading, see Importing OMS Definitions.
If no configuration file is provided, create a ROMS definition in the SAP System as follows:
...
1. Call transaction SPAD, and choose Extended Administration or Full Administration.
2. Then, on the Output Management Systems tab page, choose Real Output Management Systems.
The list of defined ROMSs appears.
3.
4.


If you are not in change mode, switch to this mode by choosing
You can now do the following:
Change.
You can create a new ROMS definition by choosing Real OMS  Create.

You can use an existing ROMS definition as a template.
To do this, click the entry in the list of ROMSs for the ROMS to be used as a template, and choose
Real OMS  Create Using Template.

5. Enter the name of the ROMS and a description.
6. Fill out or edit the fields of the OMS Attributes subwindow using the OMS documentation.
In this subwindow, you select which function are implemented in the OMS, such as whether the vendor has
implemented OMS command line commands or RFC function modules that can be called from the SAP System.
7. You can enter an initialization instance in the SAP Configuration subwindow.
Generally, SAP expects that OMS commands can be issued from any SAP server. However, it is possible that an
OMS requires that the initialization command be issued at a particular host. In this case, you can use the
Initialization Instance field to meet this requirement.
8. Save the ROMS definition and exit the function.
9. If you are using callback (the job status is returned by the OMS), you must define the SAP user and the
password for the callback client.
The user name and password are used to log onto the SAP System if you are using callbacks. To define user
names and passwords, choose Tools  Administration  User Maintenance  Users. Note that the values
entered in the OMS are the same. For additional information, see the
User Maintenance Manual.
Create the user in the logon client of the callback client. To be able to log on to the CCMS XOM-API, the user
requires authorization for S_XMI_PROD (Authorization for external management interfaces (XMI)) with the value
XOM for the Interface ID field.
For example: S_XMI_ADMIN or S_XMI_XOM_A.
Result
Your ROMS definition for identifying an external OMS is finished. You can now define logical output
Management systems (LOMSs) and OMS printers that reference the ROMS.
Importing OMS Definitions
Use
You want to import an ROMS/LOMS definition from an OMS configuration file:

that has been provided by your OMS supplier

that you have exported yourself from a test or another SAP System.
If such a configuration file is available, then uploading it into the SAP spool system creates the ROMS/LOMS
and operating system specific commands for you. This means that you do not have to create the
ROMS/LOMS definition yourself in the SAP System.
Prerequisites
You must have copied the configuration file to one of the following directories:

A directory on your frontend PC or on your workstation

A directory that you can access from the servers of the SAP target system (the system into which you want to
import the file).
You can copy the file to the tmp directory of the SAP server at which you are logged on or to the global
work directory of the SAP System.
Procedure
...
1.
Log on to the SAP System into which the file is to be imported.
Choose Tools  CCMS  Spool  Spool Administration (transaction SPAD) and then Utilities  For output
management system  Import.
2. Specify the following on the selection screen:
–
In Export/Import file name field, enter the full path name of the configuration file.
–
file.
Select Server or Frontend computer depending upon where you have copied the configuration
–
Select Import, Execute import, and Generate log.
3. Run the report.
The report displays a list showing the ROMS and LOMS definitions that have been imported into the SAP R/3
System.
Result
You have imported ROMS and LOMS definitions into the SAP R/3 spool system.

If you have imported a configuration file that was provided by an OMS maker, then your SAP System now has
the starter set of definitions provided by the manufacturer.

If you have imported a file that you created yourself, then the OMS definitions that you exported have been
replicated in your current SAP System.
You can now make any changes necessary (such as altered server names) to the definitions.
Creating a Logical OMS
Use
After you have defined the real output management system (ROMS) during the integration of the SAP spool
system into an external output management system, you can define one or more logical OMS (LOMS) as the
next step.
However, you must certainly define at least one LOMS. This is because when you want to create an output
device that forwards its print requests to an OMS (access method E), you must assign it to an LOMS. It is not
possible to assign devices directly to the real OMS.
Defining additional LOMSs is optional. It is useful, if you want to combine your output devices into different
groups that use the external OMS in different ways. For more information about the LOMS concept and its
uses, see Organizing OMS Output Devices in Logical OMSs.
Prerequisites
You have defined the real OMS (ROMS) to which your LOMS definitions will refer.
Procedure
If you have imported a configuration file or a configuration file was delivered with your system, there is probably at least
one LOMS already defined for you. If this is not the case, or if you require additional LOMSs, you can create LOMSs as
follows in the SAP System:
...
1. Call transaction SPAD, and choose Extended Administration or Full Administration.
2. Then, on the Output Management Systems tab page, choose Logical Output Mgmt Systems.
The list of defined LOMSs appears.
3.
4.


Change.
You can create a new LOMS definition by choosing Logical OMS  Create.

You can use an existing LOMS definition as a template.
To do this, click the entry in the list of LOMS for the LOMS is to be used as a template, and choose
Logical OMS  Create Using Template.

5.


If you are not in change mode, switch to this mode by choosing
You can now do the following:


6.
Enter the most important attributes for the LOMS:
Name and description
ROMS that this LOMS uses
Choose
to copy the settings for the selected ROMS, which you can then edit if necessary.
You can also select an SAP server as a tasking target (on which the OMS runs) or as a callback target.
7. Select a command group, if any have been defined. Otherwise, enter a character to define a command
group.
Local commands: If you want to define commands only for this LOMS, then select Local as the command group.
When you define a command group, the commands will be used only for this LOMS. The command group cannot
be selected from other LOMSs.
8. If you are using callback (reports about job status by the OMS): Specify additional options and parameters
on the OMS Configuration tab page, if necessary.
If you want to adjust the message filtering, choose
9. Save the LOMS and exit the function.
.
Result
Your LOMS definition that specifies how SAP output devices are to access an external OMS is complete.
You can now define additional LOMSs or define the commands that are required by LOMSs.
Download