This document covers the following topics:
The Extractor Service provides access to PDS data sets and CA Librarian DA master files defined within the z/OS catalog.
The Extractor Service provides access to security-protected data sets (protected e.g. by RACF, CA ACF2, CA Top Secret).
It is a built-in service of the RPC Server for IMS and can be enabled/disabled by RPC server configuration settings.
Depending on the platform where the broker is running, you can restrict usage of the Extractor Service to certain users or group of users, using EntireX Security. See Authorization of Client and Server.
The Extractor Service is a prerequisite for the
IDL Extractor for COBOL
used together with a remote extractor environment, see Step 2: Select a COBOL Extractor Environment or Create a New One.
IDL Extractor for PL/I
used together with an RPC environment, see RPC Environment Manager in the IDL Extractor for PL/I documentation
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.
Note:EXTRACTOR is a service name reserved by Software AG.
See SERVICE under Service-specific Broker Attributes.
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
To enable the Extractor Service
Set the RPC Server for IMS parameter extractor=yes.
See extractor under Configuring the RPC Server.
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
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.
For a z/OS broker, see Resource Profiles in EntireX Security.
For a Linux or Windows broker, see Authorization Rules.
Not applicable to a BS2000 broker.
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.
To 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.
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).