SAP ABAP IMG Activity EHS_SR_220_30 (Set Up Generation Server As a Windows Service)
Hierarchy
☛ EA-APPL (Software Component) SAP Enterprise Extension PLM, SCM, Financials
   ⤷ EHS (Application Component) Environment, Health and Safety
     ⤷ CBIMG1 (Package) EH&S: IMG Migration
IMG Activity
ID EHS_SR_220_30 Set Up Generation Server As a Windows Service  
Transaction Code S_SH8_72001005   IMG Activity: EHS_SR_220_30 
Created on 20010307    
Customizing Attributes EHS_SR_220_30   Install WWI Generation Server as Service 
Customizing Activity    
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name EHS_SR_220_30    

Use

In this Customizing activity, you set up the WWI generation server that is used to print reports and labels.

Requirements

  • You have installed a supported version of Microsoft Windows. For more information about supported versions, see SAP Note 568302.
  • You have already executed the WWI setup for installing a WWI generation server on your PC.
  • You have set up a WWI generation server for a specific RFC destination. The example below uses the destination DEST_GENSV1.

Standard settings

The WWI generation server as a Windows service comprises the WWISVC.EXE (WWISVCU.EXE for WWI in Unicode mode) file that is copied automatically to the WWI directory during WWI setup. The WWI directory should also contain the following three files:

  • The administration program SVCADMIN.EXE, which can be used to install, configure, and check services
  • The program library WIN32SVC.DLL
  • The EHSSTART.EXE file to automatically start and monitor the WWI generation server or EH&S Expert server as a Windows service

Activities

  1. Log on to the PC with administrator rights.
  2. Start the SVCADMIN.EXE program from the WWI directory.
  3. Choose Install a service.
  4. Fill out the parameters in the installation dialog box to install a WWI generation server as a service.

    General tab page

    • Host parameter: Enter the name of the local computer on which the service is to be installed.
    • Name parameter: Enter the unique internal name of the service, for example, WWI (max. 256 characters). The configuration data for the service is saved in the registry under the key HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<Name >.
    • Display Name parameter: Enter a freely definable name that is used by service administration programs for display purposes (max. 256 characters), for example, WWI generation server.
    • Executable Path parameter: Enter the path to the program file WWISVC.EXE (or WWISVCU.EXE for WWI in Unicode mode) of the service, for example, C:\WWI\WWISVC.EXE. It is possible to install a number of services that all use the same program file.
    • Service Arguments parameter: Enter the destination and the trace level of the WWI generation server. The syntax is: -D<Destination> -T<Level>, for example, -DDEST_GENSV1 -T2. The destination in our example is DEST_GENSV1. The trace level (TLEVEL) can be selected from 0 (minimum) to 5 (maximum). This is used to control the log output that you see in the event viewer during a generation run.

    Value    Description

    0    Information on the RFC registration

        Serious errors

        Generation requests are not logged

    1    More information on the RFC registration process

        Generation requests with expiration time

        Exact information on RFC errors

        Errors controlling Word

    2    Information on calls of internal functions

    3    Information on internal work steps and return values of

        internal functions

    4    Detailed information on internal work steps

    5    Very detailed information on internal work steps

The higher trace levels include all the lower levels. Parameters that are greater than 5 are reset to 5. TLEVEL = 3 is shipped with the standard system.
  • Since WWI requires user-specific data such as the Microsoft Word template directory, the option Run Service in Local System Account must be deactivated. Enter the Windows user and password under which WWI was configured (see previous IMG activity). The name is entered in the form <NT domain>\<NT user>, for example, MyDomain\MyUser.

    Service Attributes tab page

  • Service Type parameter: Choose the option Own Process.
  • Deactivate the option Allow Service to interact with desktop.
  • Start Type parameter: Choose the option Automatically for the service to start automatically each time the computer is started up.
  • Set the Error Control parameter to the option Normal.

    Event Logging tab page

  • Activate the switch Use Windows event logging.
  • Accept the option Application Logfile as the log file and the proposed event types Information, Warning, and Error.
  • Message Files parameter: Insert the path to the program file WWISVC.EXE (or WWISVCU.EXE for WWI in Unicode mode) of the service, for example, C:\Program Files\WWI\Bin\WWISVC.EXE.

  1. Install the service by choosing OK.
  2. Configure the Microsoft Windows application log.
    1. Start the Microsoft Windows event viewer (EVENTVWR.EXE).
    2. Change the setting for the application log via Log -> Log Settings to the option Overwrite Events as Needed to prevent an overflow in the event viewer.
  3. Test the service.
    1. Start and stop the WWI generation server service using the SVCADMIN.EXE program or the services control in Microsoft Windows.
    2. Call the WWI generation server from the SAP system.
    3. Use the event viewer to check whether the respective commands in the application log file have been logged and whether the language-dependent texts for the events are displayed in the detail view.
    4. Check whether the service was started automatically on system startup by rebooting the PC and calling the WWI generation server from the SAP system after a short delay.

Uninstalling a Service

To remove an installed service, proceed as follows:

  1. Log on to the PC with administrator rights.
  2. Start the service administration program SVCADMIN.EXE from the WWI directory.
  3. If necessary, close the current service using the Control and configure services function.
  4. Remove the service using the Uninstall services function.

Changing the Service Configuration

To change the configuration of a service, for example, the trace level of a WWI generation server, proceed as follows:

  1. Log on to the PC with administrator rights.
  2. Start the service administration program SVCADMIN.EXE from the WWI directory.
  3. Choose the Control and configure services function, select the required service, and call the option dialog box using the Options button to change the service properties.

Monitoring a WWI Generation Server

To monitor a service-based EH&S Expert server or WWI generation server using EHSSTART.EXE, proceed as follows (prerequisite: you have configured EHSSTART.EXE as a service as described under Set Up EhsStart As a Service):

  1. Start the service administration program SVCADMIN.EXE from the bin directory of the WWI installation.
    1. Choose the Control and configure services function.
    2. Select the respective EH&S Expert server service or WWI generation server service.
    3. To open the options dialog box, choose Options.
    4. Choose the Service Attributes tab.
    5. Set the Start Type parameter to the option Manually.
    6. Add the internal service name (for example, EhsStart) to the Service Dependency dialog box using the Add Dependency button.
    7. Confirm the changes by choosing OK.
  2. Close the EhsStart service and the service that you have just configured if necessary.
  3. Start the EhsStart service. After a short delay, this should start the service that you have just configured and monitor it. The principle here is that EhsStart starts and monitors all services that are dependent on it.

Example

Business Attributes
ASAP Roadmap ID 201   Make global settings 
Mandatory / Optional 2   Optional activity 
Critical / Non-Critical 2   Non-critical 
Country-Dependency A   Valid for all countries 
Assigned Application Components
Documentation Object Class Documentation Object Name Current line number Application Component Application Component Name
SIMG EHS_SR_220_30 0 ALR0000062 Report Definition 
Maintenance Objects
Maintenance object type    
History
Last changed by/on SAP  20030611 
SAP Release Created in 46C