mf.rts Properties

This component provides behavior of the run-time system.

The following table lists the properties of the mf.rts component and shows the event information that can be included in the trace for each property.

no property

Event Level	Event ID	Event Description
INFO	69	Command Line. This event applies to managed COBOL only.
INFO	70	Add Program Context. This event applies to managed COBOL only.
INFO	71	Delete Program Context. This event applies to managed COBOL only.
INFO	74	Version Info
INFO	128	Start of run-time system initialization. This event applies to native COBOL only.
INFO	129	End of run-time system initialization
INFO	130	Start of run-time system de-initialization
INFO	131	End of run-time system de-initialization
INFO	132	Entered a COBOL container. This event applies to native COBOL only.
INFO	133	Exited a COBOL container. This event applies to native COBOL only.
INFO	134	Link level entered. This event applies to .NET managed code only.
INFO	135	Link level exited. This event applies to .NET managed code only.
INFO	136	Memory validating. This event applies to native COBOL only.
INFO	137	Memory validated. This event applies to native COBOL only.
INFO	138	Run-Unit Created. This event applies to managed COBOL only.
INFO	139	Environment Exit. This event applies to managed COBOL only.
INFO	254	STOP RUN

ERROR	246	Shared memory error
ERROR	255	Run-time system error

ALL

Enables/disables all of the other properties.

API

This property is for .NET managed code only. API events:

Event Level	Event ID	Event Description
INFO	56	Entry to API. This event applies to native COBOL only..
INFO	57	Exit from API.

CONFIG

This property is for native COBOL only. Run-time configuration event:

Event Level	Event ID	Event Description
INFO	61	Run-time configuration operation (e.g. cobconfig file location and entries).

CONTAINER

This property is for native COBOL only. COBOL container events:

Event Level	Event ID	Event Description
DEBUG	40	Server initialization (start/finish)
DEBUG	41	Server de-initialization (start/finish)
DEBUG	42	Server context initialization (start/finish)
DEBUG	43	Server callback (start/finish)
DEBUG	49	Request handler function (start/finish)

INFO	9	Initializing environment for application running in the COBOL container (start/finish)
INFO	10	Invoking application in the COBOL container (start/finish)
INFO	11	Restoring initial state following the execution of an application in the COBOL container (start/finish)
INFO	25	Request handler trace event
INFO	46	Service lookup callback (start/finish)

ERROR	0	Request handler "start/next request" error
ERROR	1	Request handler "response" error
ERROR	2	Request handler "end processing" error
ERROR	3	Error loading the main program of the application identified by the request handler "start/next request"
ERROR	4	Error loading the package containing the application identified by the request handler "start/next request"
ERROR	5	Syncpoint failure
ERROR	12	Application termination due to exit from Debugger

ENV

This property applies to native COBOL only. Environment variable events:

Event Level	Event ID	Event Description
INFO and WARN	60	Environment variable operation

EXTERNAL

External data events.

Event Level	Event ID	Event Description
INFO	26	External data item created
INFO	27	External data item destroyed. This event applies to native COBOL only.

ERROR	28	External data item size mismatch

FSYS

This property is for native COBOL only. Low-level I/O level events:

Event Level	Event ID	Event Description
INFO	52	Entry to I/O function
INFO	53	Exit from I/O function
INFO	54	Specific I/O operation

JSEM

This property is for native COBOL only. MVS Job Step Execution Manager events:

Event Level	Event ID	Event Description
INFO	44	JSEM function entry
INFO	45	JSEM function exit
INFO	62	JSEM function

MEMORY

This property applies to native COBOL only. Memory allocation and de-allocation events:

Event Level	Event ID	Event Description
INFO	13	Memory allocated
INFO	14	Memory freed
INFO	15	Memory re-allocated (resized)
INFO	16	Re-allocated memory freed
INFO	17	Memory remaining allocated at RTS termination
INFO	67	Memory Strategy
INFO	68	Memory Info

ERROR	248	Memory allocation failure
ERROR	249	Memory corruption detected. (See table below.)

For the above event ID's, the memory types for memory allocated by a user application are as follows:

Memory type	Allocation method
51, 52	CBL_ALLOC_MEM (with `flags=0`), or CBL_ALLOC_DYN_MEM (with `flags=0`)
55, 56	CBL_ALLOC_MEM (with `flags=8`), or CBL_ALLOC_THREAD_MEM (with `flags=0`)
59, 60	CBL_ALLOC_MEM (with `flags=4`), CBL_ALLOC_DYN_MEM (with `flags=4`), or CICS GETMAIN
63, 64	CBL_ALLOC_MEM (with `flags=12`) or CBL_ALLOC_THREAD_MEM (with `flags=4`)

All other memory types are internal and used by the Micro Focus system.

In addition, for event ID 249, the stomp type is supplied, which is a category indicating how memory has been determined to be corrupted:

Stomp type	Reason	Description
0	Run-In (Header)	Leading check bytes before header overwritten
1	Run-Out (User Data)	Trailing check bytes after user data overwritten
2	Bad Header	Corruption of memory header detected
3	Freed Overwrite	Previously freed data has been overwritten
4	Bad Header	User Unable to determine header start address
5	Failed OS Check	Validation of OS memory heap failed
6	Run-In (User Data)	Leading check bytes before user data overwritten
7	Bad Track Data	Leading check bytes in track data overwritten
8	Bad Link	Corruption of keyed data link

MFENTMAP

This property applies to native COBOL only. Entry Point Mapper event:

Event Level	Event ID	Event Description
INFO	55	Entry Point Mapper function

MFPM

This property applies to native COBOL only. Mainframe Pointer Manager events (AMODE programs):

Event Level	Event ID	Event Description
INFO	29	Absolute memory registration
INFO	30	External data registration
INFO	31	Memory registration
INFO	32	Working-storage memory registration
INFO	33	External data de-registration
INFO	34	Memory de-registration
INFO	35	Working-storage memory de-registration
INFO	36	Local-storage memory registration
INFO	37	Local-storage memory de-registration

ERROR	250	MFPM error.

PGM

User program entry, exit, chain, and link events:

Event Level	Event ID	Event Description
INFO	6	Program entry
INFO	7	Program exit
INFO	8	Program chain. This event applies to native COBOL only.
INFO	18	Program link. This event applies to native COBOL only.
INFO	140	Section Entered
INFO	141	Section Exited

PGMLOAD

Program load events:

Event Level	Event ID	Event Description
DEBUG	50	Subsystem function. This event applies to native COBOL only.

INFO	19	.int or .gnt program load
INFO	20	Logical cancel
INFO	21	Physical cancel. This event applies to native COBOL only.
INFO	22	Logical canceled program made live again. This event applies to native COBOL only.
INFO	23	DLL or shared object load. This event applies to native COBOL only.
INFO	24	DLL or shared object unload. This event applies to native COBOL only.
INFO	38	.lbr load. This event applies to native COBOL only.
INFO	39	.lbr unload. This event applies to native COBOL only.

ERROR	251	Program load error. This event applies to native COBOL only.

PGMSEARCH

Program searcher events:

Event Level	Event ID	Event Description
DEBUG	58	Entry to program searcher.
DEBUG	59	Exit from program searcher.

PROCESS

Process events:

Event Level	Event ID	Event Description
INFO	63	Execute Process
INFO	64	Wait On Process

DEBUG	73	Run-Unit resource handling

SIGNAL

This property applies to native COBOL only. Signal handling events:

Event Level	Event ID	Event Description
INFO	247	Signal Signinfo

ERROR	252	Apply previously ‘held’ signal
ERROR	253	Signal caught

SYSPGM

System program entry, exit, chain, and link events:

Event Level	Event ID	Event Description
INFO	6	Program entry
INFO	7	Program exit
INFO	8	Program chain. This event applies to native COBOL only.
INFO	18	Program link. This event applies to native COBOL only.
INFO	140	Section entered
INFO	141	Section exited

THREAD

Threading and synchronization events:

Event Level	Event ID	Event Description
INFO	56	Entry to API (Threading and synchronization APIs)
INFO	57	Exit from API (Threading and synchronization APIs)
INFO	142	Thread status
INFO	143	Thread killed