Extractor Service

This document covers the following topics:


Introduction

The extractor service

  • provides access to PDS data sets and CA Librarian DA master files defined within the z/OS catalog

  • provides access to security-protected data sets (protected e.g. by RACF, CA ACF2, CA Top Secret)

  • is a built-in service of the RPC server, which can be enabled/disabled by RPC server configuration settings

  • depending on the platform where the broker is running, usage can be restricted to certain users or group of users, using EntireX Security; see Authorization of Client and Server.

graphics/extractorService.png

Scope

The extractor service is a prerequisite for the

The extractor service uses the same class and server names as defined for the RPC server, and "EXTRACTOR" as the service name, resulting in class/server/EXTRACTOR as the broker service. Please note "EXTRACTOR" is a service name reserved by Software AG. See SERVICE under Broker Attributes.

CA Librarian Support

  • Supported Features:

    • Traditional CA Librarian DA master files are supported.

    • Extraction from multiple CA Librarian data sets is possible.

    • CA Librarian archive levels (history) are supported for the COBOL (main) source where the extraction starts.

    • Security RACROUTE is supported.

    • PDS data sets and CA Librarian data sets can be mixed, that is:

      • the COBOL source can reside in a PDS, and some copybooks in CA Librarian, and others in PDS

      • the COBOL source can reside in CA Librarian, and some copybooks in PDS and others in CA Librarian

      • -INC and COBOL COPY statements can be mixed in one source

Enabling the Extractor Service

Start of instruction setTo enable the extractor service

  1. Set the RPC Server for IMS parameter extractor=yes. See extractor under Configuring the RPC Server.

  2. Define in the broker attribute file, under the RPC service, an additional broker service with "EXTRACTOR" as the service name and values for class and server identical to those used for the RPC service. For example, if your RPC service is named

    CLASS = RPC    SERVER = SRV1    SERVICE = CALLNAT

    the extractor service requires the following additional service definition in the Broker attribute file:

    CLASS = RPC    SERVER = SRV1    SERVICE = EXTRACTOR
  3. Optional. If you need to restrict the use of the extractor service to a selected group of users, use EntireX Security and define security rules for the class/server/EXTRACTOR broker service. The service name EXTRACTOR is a constant.

  4. Optional. Use the impersonation feature of the RPC Server for IMS to enable access to security-protected data sets (protected e.g. by RACF, CA ACF2, CA Top Secret). See impersonation under Configuring the RPC Server.

Disabling the Extractor Service

Start of instruction setTo disable the extractor service

  • Set the RPC Server for IMS parameter extractor=no. See extractor under Configuring the RPC Server. The RPC Server for IMS will not register the extractor service in the broker.

Restrictions

The following restrictions apply to CA Librarian:

  • Filtering with programmer and type, as is done by the CA Librarian ELIPS (Extended Librarian Interactive Productivity Services) application, is not supported.

  • CA Librarian Wide Record Master Files (PDS/E - PO) are not supported.

  • CA Librarian MCD Security is not supported

  • CA Librarian member passwords (NOBYPP installations) are not supported

  • The optional syntax elements seq1, seq2 and ARC of the CA Librarian -INC module-name[,seq1[,seq2][,ARC={date | Lx | -y}]] statement are not supported. Therefore CA Librarian archive levels (history) are not supported for COBOL copybooks. It is always the most recent member (last update) that is delivered by the extractor service.

No access is provided to other data sets (e.g. CA Panvalet) or to data sets not defined in the z/OS catalog (e.g. defined in VTOC only).