PDF documentation
Summary of changes
About this document
These topics provide information needed to plan for, customize, maintain, and diagnose problems with IBM® File Manager for z/OS®.
Customizing File Manager
- Preparing to customize File Manager
- Customizing the operating environment for File Manager
  - Enable/Register File Manager
  - Modifying the ISPF environment
    To make it easy to start File Manager under ISPF, configure your ISPF environment as described in the following sections.
  - Enabling File Manager to work with certain products
    - File Manager supported software environments
    - Enabling WebSphere® MQ support
      To access WebSphere® MQ queue managers and queue contents on the local z/OS® system where File Manager is running, the WebSphere MQ libraries must be made available to File Manager and users must be granted read and update access.
    - Customizing for processing COBOL copybooks
      To use the view, edit, copy, print, or data create functions with a COBOL copybook, you need to make a COBOL compiler available to File Manager.
    - Customizing for processing PL/I include books
      - Using a licensed site PL/I compiler
    - Customizing for processing HLASM copybooks
    - Customizing to use DFSORT to improve File Manager performance
      File Manager can use DFSORT to improve the performance of the Data Set Copy and Data Set Print functions under ISPF and in batch.
    - Binding Db2® to use File Manager object access method (OAM) functions
  - Disabling Websphere MQ feature by system name
  - Running File Manager with APF-authorization
  - Language Environment® considerations
- Customizing File Manager
- Customizing the File Manager security environment
  File Manager provides security for system-oriented functions through RACF® (or an equivalent security product).
- Customizing File Manager to write audit records to SMF
- Customizing the File Manager audit facility for the File Manager Base component
- Customizing File Manager for national languages
  You can customize File Manager for national languages other than English.
- Customizing File Manager Service Provider for z/OS® Connect
  File Manager Service Provider for IBM® z/OS® Connect Enterprise Edition enables client applications to access IBM Z data sources using z/OS Connect.
- Customizing File Manager to use library management system libraries
- Customizing File Manager to use the Optim™ Data Privacy Provider API
- Customizing File Manager to use an I/O exit
- Customizing File Manager to use a scrambling exit
- Verifying the customization of File Manager
  After you have completed the initial installation and customization of File Manager Base function, you can perform the following steps to verify your customization.
Customizing File Manager Db2® Component
Customizing File Manager IMS™ Component
Customizing File Manager CICS® Component
File Manager on VS Code
IBM File Manager for z/OS is a host component that supports various interfaces such as Eclipse and Microsoft Visual Studio Code IDEs.
File Manager on Eclipse
File Manager plug-in for Eclipse, when used with an Eclipse-based platform such as IBM® Explorer for z/OS® or IBM Developer for z/OS, provides easy access through a graphical user interface (GUI) on the workstation to IBM File Manager for z/OS.
Preparing for File Manager Remote Services
Customizing ADFz Common Components server
File Manager options
FM/Db2 options
FM/IMS options
File Manager options specified in PARMLIB members
The library management system exit
File Manager audit records
Support resources
Notices

Customizing for processing PL/I include books

File Manager provides a choice of two internal PL/I compilers that are used in any addition to external PL/I compiler previously installed.

The File Manager internal PL/I compiler to be used is selected with the ALTPLI option. See ALTPLI.

The SHOWPLI command can be used to display the PL/I compiler being used.

File Manager uses its internal PL/I compilers instead of the licensed site compiler. Use the ALTPLI option to select the version of the internal compiler. For more information, see the Available COBOL compilers for details.

For information about using a licensed site PL/I compiler, see Using a licensed site COBOL compiler. For information about using the File Manager internal PL/I compiler, see Using the File Manager COBOL compiler.

If you want to use File Manager view, edit, copy, print, or data create functions with a PL/I include book, you must use the Language Environment® runtime library.

To ensure that you use the correct Language Environment® runtime, either add the Language Environment® runtime library, SCEERUN, to your LINKLIST, or add it to the STEPLIB DD statement in your TSO logon procedure.

Table 1. PL/I compiler order of precedence
	Option	Version	PL/I Module	Notes
FMNPL/I	DD DUMMY	Internal	FM provided	Allocated in JCL or TSO command
FMNPL/I	DSN=library	External	IBM®PL/I	Allocated in JCL or TSO command
RACROUTE	ATUS=ACCESS FACILITY Class PROFILE FILEM.PLI.EXTERN AL CONTROL access or higher	External	IBM®PL/I	Force File Manager to use an external PL/I compiler
If none of the above		Internal		Default. See ALTPLI.

SHOWPLI command

The SHOWPLI command displays the level of the internal PL/I compiler or if the usage of external PL/I compiler is in effect.

In batch, submit a File Manager batch job with the following control statement:

$$FILEM SHOWPLI

If a licensed PL/I compiler is available, the output includes the following message: FMNB920I The Customer Licensed PL/I Compiler will be used.

If the File Manager supplied PL/I compiler is used, the output includes the following message: FMNB925I The File Manager supplied PL/I Compiler will be used.

Under ISPF, enter SHOWPLI on any File Manager command line alternatively the following messages, according to the PL/I complier in use.

Using FM PL/I V61
The File Manager supplied Vxx PL/I Compiler will be used

Or

FMNPLI is allocated
The licensed PL/I Compiler in library dataset name allocated via FMNPLI will be used.