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
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.
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 in the IDL Extractor for COBOL documentation.
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. Please note "EXTRACTOR" is a
service name reserved by Software AG. See SERVICE under 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 IMS RPC Server 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 UNIX or Windows broker, see Administering Authorization Rules using System Management Hub under UNIX | Windows.
Not applicable to a BS2000/OSD broker.
Optional. Use the impersonation feature of the IMS RPC Server 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 IMS RPC Server parameter extractor=no.
See extractor under Configuring the RPC Server. The IMS RPC Server 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 supprted
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).
