Fonction SAP VSCAN_RFC_RELOAD - Administration of Scan Instances of Virus Scan Servers

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
IF_ADAPTER_NAME VSCAN_SERVER_NAME C 32 X Virus Scan Adapter Name
IF_INIT_INSTANCES CHAR1 C 1 X Single-Character Flag
IF_SCANNER_GROUP VSCAN_SERVER_GROUP C 10 X Scanner Group
IF_SERVER_NAME VSCAN_SERVER_NAME C 32 X Name of the Virus Scan Server
IF_STOP_INSTANCES CHAR1 C 1 X Single-Character Flag

Exception Description
CONFIGURATION_ERROR Error in the configuration of the virus scan servers
INITIALIZATION_FAILED Initialization Failed
IN_PROGRESS Stop request not yet fully executed
NOT_AUTHORIZED No Authorization
PARAMETER_ERROR Incorrect call

Functionality
This function module is used to administer the instance pools ofvirus scan servers.
Only vendors of virus scan adapters certified for the SAP virus scaninterface can use it, to be able to perform an update of the virusscan signature files.

Example
To be able to update the signature files of all virus scan server ofthe scanner group GROUP_A, follow the procedure below:

  • Call VSCAN_RFC_RELOAD with IF_SCANNER_GROUP = GROUP_A and the parameter
    • IF_STOP_INSTANCES = X. If you receive the exception IN_PROGRESS,you must repeat the call after an appropriate wait time. Any otherexception must lead to an error.
    • If the module is completed without an exception, all instances of the
      • virus scan servers are inactive with regard to the scan engine; that is,the drivers have been unloaded.
      • Update the Signature Files

      • Call VSCAN_RFC_RELOAD with IF_SCANNER_GROUP = GROUP_A and the parameter
        • IF_INIT_INSTANCES = X. Any exceptions must lead to errors.
        • If the module is completed without exceptions, the virus scan servers
          • have been initialized again.

          Notes
          This module affects only virus scan servers that are available at thetime of the call. Non-availability is not an error situation and doesnot result in an exception. Note: If the virus scan server is notaccessible, the operating system process is not active, and thereforecannot be using the virus scan signature files, meaning that they canbe accessed to be updated.
          Caution: If this module was called with the parameterIF_STOP_INSTANCES, the virus scan servers concerned are in a statusin which no additional scan requests can be accepted. The subsequentcall with the parameter IF_INIT_INSTANCES is mandatory.

          Description
          Specifies whether the scan instances of the specified virus scan serverare to be initialized.

          Value range
          X: The scan instances are initialized.
          : The scan instances are not initialized.

          Description
          Name of the scanner group that contains the virus scan servers forwhich the operation is to be performed.

          Value range
          The name of a scanner group.

          Default
          If this parameter is filled, you must not use IF_SERVER_NAME.

          Description
          Name of a single virus scan server to be processed.

          Default
          If this parameter is set, you must not use IF_SCANNER_GROUP.

          Description
          Specifies whether the instance pool is to be stopped for the virusscan servers to be processed.

          Value range
          X: The instance pool is to be stopped.
          : The instance pool is not to be stopped.