DFHRMCAL macro

Syntax

DFHRMCAL

>>-DFHRMCAL----TO=ename--+-------------------+--+-------------------+---><
                         |           .-YES-. |  |           .-NO--. |     
                         '-,RTNABND=-+-NO--+-'  '-,SUPPEDF=-+-YES-+-'     

Other parameters for this macro are for CICS® internal use only.

This macro cannot be invoked by an AMODE(64) application program.

Parameters

TO=ename

ename is the entry name of the task-related user exit program (TRUE) that you want to handle resource manager requests.

RTNABND={YES|NO}

Whether control returns to the application program when the task-related user exit program is unavailable, for example, because it is not enabled or started. Valid values are as follows:

YES

Control returns to the application program when the task-related user exit program is unavailable. This value is the default.

NO

Control does not return to the application program when the task-related user exit program is unavailable.

For assembler language application programs, a negative value in register 15 signals to the application program that control has returned because the exit is unavailable. The task-related user exit program can use positive values (including zero) in register 15 to pass resource manager response codes to the application program.

If RTNABND=NO is specified and the task-related user exit program is unavailable, the application program terminates abnormally with the abend code AEY9.

SUPPEDF={YES|NO}

Whether EDF screens that relate to the invocation of the TRUE by DFHRMCAL are suppressed. When a TRUE is invoked for a call to a non-CICS resource manager from an application that is being monitored by EDF, EDF can display About to Execute and Command Execution Complete screens that show parameters that are addressed by the parameter list that the DFHRMCAL macro passes. Valid values are as follows:

YES

Suppress EDF screens that relate to the invocation of the TRUE by DFHRMCAL.

NO

Display EDF screens that relate to the invocation of the TRUE by DFHRMCAL. This value is the default.