The meaning and use of each of the output parameter fields are
described below. The exit places data into these fields in response
to the function call.
- DEXMRO_RC
- This field contains the return code for this function call.
The Sampling Engine reports it and the reason code in a message if
this value is eight or higher. This message is displayed with a message
ID of: CAZ4880E in the REQ#nnnn SYSOUT dataset of the Application Performance Analyzer Started
Task. nnnn is the observation request number
associated with the error.
A return code of DEXMRO_RCSevr or higher
causes the Sampling Engine to stop calling the exit for Module Resolution
functions. The Sampling Engine only calls the exit again at the end
of sampling to perform the Last function call.
- DEXMRO_RSN
- This field contains the reason code for this function call.
The reason code provides details on the cause of the error.
- DEXMRO_Flag1
- This field contains some flag bits.
- DEXMRO_F1_MOD indicates that the module information returned is
an MVS module.
- DEXMRO_F1_PTH indicate that the module information returned is
a USS exec.
- DEXMRO_ModData
- This label denotes the start of an overlay point. The data at
this location either contains MVS module information or USS exec information.
Refer to the DEXMRO_Flag1 in Output Parameter Fields for more information.
If bit DEXMRO_F1_MOD
is on, then DEXMRO_ModName, DEXMRO_ModDDN, and DEXMRO_ModDSN contain
MVS module information. If bit DEXMRO_F1_PTH is on, then DEXMRO_ModPTH@
points to the address of a pathname length prefix.
- DEXMRO_ModName
- This field contains the resolved MVS module name in which the
instruction at PSW address in DEXMRI_Address was executing.
- DEXMRO_ModDDN
- This field can contain nulls or the DDName of the load library
from which the MVS module was loaded.
- DEXMRO_ModDSN
- This field can contain nulls or the DSName of the load library
from which the MVS module was loaded. This field is required if the
module's CSECT information is to be resolved by Application Performance Analyzer.
- DEXMRO_ModPTH@
- This field can contain nulls or a pointer to the length prefix
of the full pathname of the path from which the USS exec was executed.
The length is that of the name only.
- DEXMRO_MStart@
- This field contains the starting address (load point address)
of either the MVS module or USS exec described by the data in DEXMRO_ModData.
- DEXMRO_MLen
- This field contains the length of either the MVS module or USS
exec described by the data in DEXMRO_ModData.
- DEXMRO_UTkn
- This field contains nulls or an 8-byte token to uniquely identify
this instance of an MVS module or USS exec. This token provides an
indication of whether or not the module or exec has been loaded and
deleted multiple times such that the starting and ending addresses
have changed.
- DEXMRO_MsgL
- This field contains nulls or the length of a message provided
in DEXMRO_Msg. This field is ignored for all return codes less than
or equal to four.
- DEXMRO_Msg
- This field contains nulls or the message text. This field is
ignored for all return codes less than or equal to four. The message
is displayed with a message ID of: CAZ4881I in the REQ#nnnn SYSOUT
dataset of the Application Performance Analyzer Started Task. nnnn is
the observation request number associated with the error.
[ Top of Page | Previous Page | Next Page | Contents | Index ]