FLMTMMI Interface to DFSUNUB0 (phase 2 of MFSUTL and MFSTEST)

Purpose

This translator invokes DFSUNUB0 via the TSO Service Facility. At completion, a return code is passed to the calling program in register 15. Ddname substitution lists are not supported in this translator.

FLMTMMI invokes DFSUNUB0 using the TSO service facility IKJEFTSR with link flags of hexadecimal '00000002'. These flags direct the TSO service facility to invoke DFSUNUB0 from an authorized environment. DFSUNUB0 may be invoked directly as the value of the COMPILE keyword parameter for FLMTRNSL if COMPRESS is not in the OPTION list.

Note: DFSUNUB0 can not be directly invoked from SCLM when using the COMPRESS option. The COMPRESS option causes IEBCOPY to execute, which would then result in an abnormal termination because the SCLM address space is not an authorized environment.

DFSUPAA0 (phase 1 of MFSUTL and MFSTEST) is invoked directly by the IMS™ MFS language definitions. You might need to change the options list for DFSUPAA0 based on your installation.

Parameters

The parameters in the options list are passed directly to the DFSUNUB0. For CSP/370AD map groups, the parameters should match those found in the CSP/370AD-generated preparation JCL. For other IMS applications these parameters can be changed as required.

This translator produces multiple outputs. The outputs are stored outside of the control of SCLM.

Currently, the options list that is included with the IMS MFS language definitions for the FLMTMMI translator contains the following parameters:

FLM@MVTS: The following option list is required for MFSTEST: TEST,DEVCHAR=C
FLM@MVUT: The following option list is required for MFSUTIL: COMPRESS,NOCOMPREND,UPDATE,DEVCHAR=C

Verify the value assigned to DEVCHAR to ensure that it matches the value used for the target IMS region. Check with your IMS system programmer to determine the correct value.

Return codes

This translator passes back the return code from DFSUNUB0. For more information on these return codes, refer to IBM Information Management Software for z/OS Solutions Information Center.