Mainframe Call Generator (MCG) Refresh - Micro Focus

Mainframe Call Generator (MCG) Refresh - Micro Focus Mainframe Call Generator (MCG) Refresh - Micro Focus

01.05.2013 Views

Mainframe Call Generator Refresh The solution is to manage the execution of each active MCG process in a subordinate z/OS task. This new MCG task is dedicated to one user’s MCG activity, but only for the duration of the user’s MFE-to-MFA Server MCG connection. The MCG user program executes as a separate z/OS work unit where program loops, excessive CPU consumption, long waits, etc. have little or no effect on other user activity. This also isolates the IBM COBOL runtime environment and/or DB2 attachment for the user in that same task. Subordinate z/OS tasks are created on demand, one for each concurrent MCG user. When MCG activity for a user is completed, the subtask remains active, but waiting, to service the next MCG requester. This new design allows Mainframe Access Server Version 3 to support all of the MCG processing previously possible in Mainframe Access Version 2. In addition to merely supporting the old functionality, Version 3’s new design also improves the MCG feature with selectable DB2 attachment, termination of looping and waiting MCG programs, improved diagnostic messaging, and detailed tracing of MCG activity. The FixPack maintenance description for this change summarizes the above discussion: Mainframe Call Generator (MCG) refresh (RPI 1054397) -------------------------------------------------------------------- The Mainframe Call Generator (MCG) feature is corrected and enhanced with the following changes: - Maintaining a mainframe COBOL runtime environment across multiple remote calls to, possibly, multiple program load modules - Execution of MCG programs under a separate z/OS Task Control Block - Formatted dumping to SYSUDUMP/SYSMDUMP for user program failures - Termination for user programs that may be looping or stuck in a WAIT that cannot be satisfied. - Ability to perform detailed tracing of MCG program activity - Ability to select either Call Attach Facility (CAF) or the Recoverable Resource Attachment Facility (RRSAF) as the DB2 connection type for SQL processing. *** SPECIAL NOTE *** The new parameter MFA_MCG_DB2CONNECTION can be used to explicitly select the DB2 connection type for SQL processing. The valid values for this parameter are RRSAF or CAF. The default value is RRSAF. *** SPECIAL NOTE *** You will need to add a SYSUDUMP or SYSMDUMP DD statement to each of your Mainframe Access Server started task JCL procedures to enable the dumping support for user program ABENDs. The remainder of this document describes the MCG refresh in detail. Appendix B provides a handy checklist for MCG program preparation. The annotated sample trace in Appendix C contains excellent tutorial information that may be useful to technical support and customer personnel. Confidential - 4 - December 2004 Randy Witek Micro Focus Development

Mainframe Call Generator Refresh MCG operation The following diagram depicts the MFA Server z/OS task structure for MCG processing. The message flow on the left summarizes the client-server exchanges for a simple MCG remote program execution. The description that follows is keyed to the numbering of the client-server requests in this diagram. The same request sequence and numbering is used in the annotated sample trace of a MCG session. Figure 2 - MFA Server task structure for MCG operation Confidential - 5 - December 2004 Randy Witek Micro Focus Development XDBMFADM task XDBMFADM task 1 - MFA connect (“logon”) 2 - LSC logon with authentication 3 - LSC RPC request 4 - RPC send parameters 5 - RPC execute ATTACH 6 - RPC fetch parameters 7 - LSC RPC request 8 - RPC send parameters 9 - RPC execute (with CLEANUP flag) MFARPC00 module parameter data MD@MCGEX module inter-task messaging MCGEXEC task MCGEXEC task MCGEXEC task MCGEXEC module user program load module BASSM

<strong>Mainframe</strong> <strong>Call</strong> <strong>Generator</strong> <strong>Refresh</strong><br />

The solution is to manage the execution of each active <strong>MCG</strong> process in a subordinate z/OS task.<br />

This new <strong>MCG</strong> task is dedicated to one user’s <strong>MCG</strong> activity, but only for the duration of the user’s<br />

MFE-to-MFA Server <strong>MCG</strong> connection. The <strong>MCG</strong> user program executes as a separate z/OS<br />

work unit where program loops, excessive CPU consumption, long waits, etc. have little or no<br />

effect on other user activity. This also isolates the IBM COBOL runtime environment and/or DB2<br />

attachment for the user in that same task. Subordinate z/OS tasks are created on demand, one<br />

for each concurrent <strong>MCG</strong> user. When <strong>MCG</strong> activity for a user is completed, the subtask remains<br />

active, but waiting, to service the next <strong>MCG</strong> requester.<br />

This new design allows <strong>Mainframe</strong> Access Server Version 3 to support all of the <strong>MCG</strong> processing<br />

previously possible in <strong>Mainframe</strong> Access Version 2. In addition to merely supporting the old<br />

functionality, Version 3’s new design also improves the <strong>MCG</strong> feature with selectable DB2<br />

attachment, termination of looping and waiting <strong>MCG</strong> programs, improved diagnostic messaging,<br />

and detailed tracing of <strong>MCG</strong> activity. The FixPack maintenance description for this change<br />

summarizes the above discussion:<br />

<strong>Mainframe</strong> <strong>Call</strong> <strong>Generator</strong> (<strong>MCG</strong>) refresh (RPI 1054397)<br />

--------------------------------------------------------------------<br />

The <strong>Mainframe</strong> <strong>Call</strong> <strong>Generator</strong> (<strong>MCG</strong>) feature is corrected and enhanced<br />

with the following changes:<br />

- Maintaining a mainframe COBOL runtime environment across multiple<br />

remote calls to, possibly, multiple program load modules<br />

- Execution of <strong>MCG</strong> programs under a separate z/OS Task Control Block<br />

- Formatted dumping to SYSUDUMP/SYSMDUMP for user program failures<br />

- Termination for user programs that may be looping or stuck in<br />

a WAIT that cannot be satisfied.<br />

- Ability to perform detailed tracing of <strong>MCG</strong> program activity<br />

- Ability to select either <strong>Call</strong> Attach Facility (CAF) or the<br />

Recoverable Resource Attachment Facility (RRSAF) as the<br />

DB2 connection type for SQL processing.<br />

*** SPECIAL NOTE ***<br />

The new parameter MFA_<strong>MCG</strong>_DB2CONNECTION can be used to explicitly<br />

select the DB2 connection type for SQL processing. The valid<br />

values for this parameter are RRSAF or CAF. The default value<br />

is RRSAF.<br />

*** SPECIAL NOTE ***<br />

You will need to add a SYSUDUMP or SYSMDUMP DD statement to each of<br />

your <strong>Mainframe</strong> Access Server started task JCL procedures to enable<br />

the dumping support for user program ABENDs.<br />

The remainder of this document describes the <strong>MCG</strong> refresh in detail. Appendix B provides a<br />

handy checklist for <strong>MCG</strong> program preparation. The annotated sample trace in Appendix C<br />

contains excellent tutorial information that may be useful to technical support and customer<br />

personnel.<br />

Confidential - 4 - December 2004<br />

Randy Witek<br />

<strong>Micro</strong> <strong>Focus</strong> Development

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!