When you cause a wrapper to display from your RAMP script like this:
SHOW_CURRENT_FORM(true, "MYWRAPPER" );
what you are really saying is
SHOW_CURRENT_FORM(true, "MYWRAPPER=ONLY" );
You may have noticed the defaulted "=ONLY" suffix in traces. This is because the wrapper identifier passed to SHOW_CURRENT_FORM is in the form CLASS=INSTANCE IDENTIFIER, where CLASS is the id of your Visual LANSA reusable part that contains your wrapper code. If you leave out the =INSTANCE IDENTIFIER part =ONLY is appended by default.
The reason that this feature exists is to allow you to do this in your code:
SHOW_CURRENT_FORM(true, ("MYWRAPPER=" + sMyInstanceIdentifier ) );
You might do this in situations where MYWRAPPER is a generic wrapper that you want to use from multiple RAMP scripts within a 5250 session, but you need to avoid reusing the single MYWRAPPER=ONLY instance in all of them.
This feature allows you to, for example, create new instances based on the form name.
Wrapper instances are generally based within a session within a command handler's container pane. When you close the command handler pane the wrappers are normally terminated.
A wrapper can get its full identifier from property #COM_OWNER.avWrapperInstanceIdentifier.
The maximum length of a CLASS=INSTANCE IDENTIFIER name is 256.