Fast/Unload invocation: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
 
m (move ID)
 
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<!-- Page name: Fast/Unload invocation-->
==<b id="invkmvs"></b>Invoking Fast/Unload under z/OS==
For versions of <var class="product">Fast/Unload</var> through 4.7, the product is installed as a standalone z/OS program. As of the next version after 4.7, <i>numbered 7.7</i> to associate it to Model&nbsp;204 version 7.7, the product is integrated with the Model&nbsp;204 Online load module and invoked as part of the integrated load module.
<div id="invkmvs"></div>
 
==Invoking Fast/Unload as a standalone z/OS program==
Regardless of product version, <var class="product">Fast/Unload</var> is invoked with the EXEC JCL card, and its
<!--Caution: <div> above-->
program name as distributed is <code>FUNLOAD</code>:
   
<p class="code">// EXEC PGM=FUNLOAD </p>
<p></p>
 
<var class="product">Fast/Unload</var> is simply invoked via the EXEC JCL card.
===DD names===
The program name
The following DD names are used by <var class="product">Fast/Unload</var>:
of <var class="product">Fast/Unload</var> as distributed is FUNLOAD.
<ul>
The following DDNAMEs are used
<li><b>FUNIN</b> &mdash; This DD contains the statements used to describe the unload.
by <var class="product">Fast/Unload</var>:
<code>FUNIN</code> must be composed of fixed-length, 80-byte records. </li>
 
<li><b>FUNPRINT</b> &mdash; This DD is used as a log file and for reporting errors.
This DD is referred to as the <b>report data set</b>. No DCB information is required, but if supplied:
<ul>
<li><code>RECFM</code> may be <var class="term">x</var>[B][A], where <var class="term">x</var> is <code>F</code> or <code>V</code>.  If not specified, it defaults to <code>VBA</code>.  ASCII carriage control (the <code>A</code> suffix) is always used. </li>
 
<li><code>LRECL</code> defaults to either 133 (for <code>RECFM F</code>) or 137 (for <code>RECFM V</code>) </li>
 
<li><code>BLKSIZE</code> defaults to 8192 (for RECFM F) or 8196 (for RECFM V) </li>
</ul>
</li>
 
<li><b><i>destination</i></b> &mdash;
A DD is required for each of the sequential data sets (which must be unique) declared as an output stream to which records are to be unloaded.
<code>FUNOUT</code> is the default output stream for FUEL programs written for versions prior to 4.1. </li>
 
<li><b><i>input</i></b> &mdash;
A DD statement is required for the input <var class="product">Model&nbsp;204</var> data file.
The DD statement for the <var class="product">Model&nbsp;204</var> file <b>must</b> match the internal name of the data file.
In addition, if a <var class="product">Model 204</var> data file is made up of multiple physical files, DD cards must be provided for all physical
files making up the logical file. </li>
 
<li id="ccadd"><b>SYSUDUMP</b> or <b>SYSMDUMP</b>
<ul>
<li>Prior to version 7.7:
<p>
It is recommended that you allocate either <code>SYSUDUMP</code> or <code>SYSMDUMP</code> to the <var class="product">Fast/Unload</var> job step. </p></li>
 
<li>As of version 7.7:
<p>
<i>Do not use <code>SYSUDUMP</code></i>. <code>SYSMDUMP</code> is still useful. </p></li>
</ul></li>
</ul>
 
As of the version 7.7 integration of Fast/Unload with the Online load module, these additional DD names can be used with PGM=FUNLOAD for possible problem diagnosis by Rocket Technical Support. They are not required.
<ul>
<ul>
<li>FUNIN &mdash; This DD contains the statements used to describe the unload.
<li><b>CCASNAP </b> &mdash;  
FUNIN
If Fast/Unload encounters an abend, a Model&nbsp;204 snap is created and sent to the <code>CCASNAP</code> DD. Since this is key to diagnosing many problems, Fast/Unload ensures that the DD name is allocated (to <code>SYSOUT=A</code>) if it has not been provided. </li>
must be composed of fixed length, 80 byte records.
 
<li>FUNPRINT &mdash; This DD will be used as a log file and for reporting errors.
<li><b>CCAAUDIT</b> &mdash;  
This DD will also be referred to as the <b>report data set</b>.
You can capture the normal Model&nbsp;204 audit trail if you provide a <code>CCAAUDIT</code> DD. This is a small file (generally less than 100 records) and the information is usually not important, but it might be helpful for problem diagnosis.
<li><i>destination</i> &mdash;
 
A DD is required for each of the sequential data sets (which must be unique)
<li><b>CCAPRINT</b> &mdash;  
declared as an output stream to which records are to be unloaded.
You can capture the normal Model&nbsp;204 file for initialization
FUNOUT is the default output stream for FUEL programs written for
if you provide a <code>CCAPRINT</code> DD. This is a small file (generally less than 50 records) and the information is usually not important, but it might be helpful for problem diagnosis. You should be able to define this as a SYSOUT file.
versions prior to 4.1.
</ul>
</ul>
<p></p>
 
A DD statement is also required for the input <var class="product">Model 204</var> data file.
===Sample JCL===
The DD
The following is an example of JCL that runs pre-7.7 <var class="product">Fast/Unload</var> as a standalone program in a z/OS environment:
statement for the <var class="product">Model 204</var> file <b>must</b> match the internal
name of the data file.
In addition, if a <var class="product">Model 204</var> data file is made up
of multiple physical files, DD cards must be provided for all physical
files making up the logical file.
<p></p>
It is also recommended that you allocate either a SYSUDUMP or SYSMDUMP
file to the <var class="product">Fast/Unload</var> job step.
<p></p>
<p></p>
The following is an example of JCL that runs <var class="product">Fast/Unload</var> in a z/OS
environment.
<p class="code"><nowiki>//FUNLOAD  JOB (0),CLASS=C,MSGCLASS=A,NOTIFY=HOMER
<p class="code"><nowiki>//FUNLOAD  JOB (0),CLASS=C,MSGCLASS=A,NOTIFY=HOMER
//FUNLOAD  EXEC PGM=FUNLOAD,REGION=1024K
//FUNLOAD  EXEC PGM=FUNLOAD,REGION=1024K
Line 56: Line 78:
//
//
</nowiki></p>
</nowiki></p>
 
<div id="invkcms"></div>
The same JCL can be used for version 7.7 and later, except:
==Invoking Fast/Unload as a standalone CMS program==
<ul>
<!--Caution: <div> above-->
<li>Change the load library. Use something like the following to reference the integrated Model&nbsp;204 library:
<p class="code">//STEPLIB DD DISP=SHR,DSN=M204.V77.LOADLIB
<p></p>
</p></li>
<var class="product">Fast/Unload</var> must be invoked by the <var class="product">Model 204</var> CMS interface because
 
<li>Consider using the additional [[#ccadd|optional 7.7 DD statements]]. </li>
</ul>
 
==<b id="invkcms"></b>Invoking Fast/Unload as a standalone CMS program==
<var class="product">Fast/Unload</var> must be invoked by the <var class="product">Model&nbsp;204</var> CMS interface because
it uses the CMS interface's EXCP and BSAM simulation.
it uses the CMS interface's EXCP and BSAM simulation.
The program name
The program name
of <var class="product">Fast/Unload</var> as distributed is FUNLOAD.
of <var class="product">Fast/Unload</var> as distributed is <code>FUNLOAD</code>.
A FILEDEF must be provided for any DD to be used by <var class="product">Fast/Unload</var>.
A FILEDEF must be provided for any DD to be used by <var class="product">Fast/Unload</var>.
Note that
<p class="note"><b>Note:</b> Because <var class="product">Fast/Unload</var> uses the <var class="product">Model&nbsp;204</var> CMS interface, any file
because <var class="product">Fast/Unload</var> uses the <var class="product">Model 204</var> CMS interface, any file
can be on an OS format minidisk.  
can be on an OS format minidisk.
</p>
The following DDNAMEs are used by <var class="product">Fast/Unload</var>:
The following DDNAMEs are used by <var class="product">Fast/Unload</var>:
<ul>
<ul>
<li>FUNIN - This DD contains the FUEL used to describe the unload.
<li><code>FUNIN</code> &mdash; This DD contains the FUEL used to describe the unload.
FUNIN must
<code>FUNIN</code> must
be composed of fixed length, 80 byte records.
be composed of fixed length, 80 byte records.</li>
<li>FUNPRINT - This DD will be used as a log file and for reporting errors.
 
This DD will also be referred to as the <b>report data set</b>.
<li><code>FUNPRINT</code> &mdash; This DD will be used as a log file and for reporting errors.
<li><i>destination</i> -
This DD will also be referred to as the <b>report data set</b>. </li>
 
<li><i>destination</i> &mdash;
A DD is required for each of the sequential data sets (which must be unique)
A DD is required for each of the sequential data sets (which must be unique)
declared as an output stream to which records are to be unloaded.
declared as an output stream to which records are to be unloaded.
FUNOUT is the default output stream for FUEL programs written for
<code>FUNOUT</code> is the default output stream for FUEL programs written for
versions prior to 4.1.
versions prior to 4.1.
</ul>
</ul>
<p></p>
 
A FILEDEF statement is also required for the input <var class="product">Model 204</var> data file.
A FILEDEF statement is also required for the input <var class="product">Model 204</var> data file.
The
The
Line 91: Line 120:
of multiple physical files, FILEDEF commands must be provided for all physical
of multiple physical files, FILEDEF commands must be provided for all physical
files making up the logical file.
files making up the logical file.
<p></p>
 
<p></p>
The following is an example of an EXEC that runs <var class="product">Fast/Unload</var> in a CMS
The following is an example of an EXEC that runs <var class="product">Fast/Unload</var> in a CMS
environment.
environment.
Note that while REXX is used here, the EXEC could
Note that while REXX is used here, the EXEC could
be written in EXEC or EXEC2.
be written in EXEC or EXEC2.
<p class="code"><nowiki>/* Exec to run <var class="product">Fast/Unload</var> */
<p class="code"><nowiki>/* Exec to run Fast/Unload */
Address command;
Address command;
'FILEDEF * CLEAR';
'FILEDEF * CLEAR';
Line 108: Line 136:
Exit rc;
Exit rc;
</nowiki></p>
</nowiki></p>
Note that in the above example the <var class="product">Fast/Unload</var> Extraction Language program is
 
in file FUN FUNLOAD on a CMS format disk and the <var class="product">Model 204</var> data file
<p class="note"><b>Note:</b> In the above example, the Fast/Unload Extraction Language program is in file <code>FUN FUNLOAD</code> on a CMS format disk, and the <var class="product">Model&nbsp;204</var> data file <code>SIRXREFD</code> is on an OS-format minidisk.
SIRXREFD is on an OS format minidisk.
 
==See also==
==See also==
[[Fast/Unload overview#WIKFUN$$topics|Fast/Unload topics]]
{{Template:Fast/Unload topic list}}

Latest revision as of 17:42, 15 November 2017

Invoking Fast/Unload under z/OS

For versions of Fast/Unload through 4.7, the product is installed as a standalone z/OS program. As of the next version after 4.7, numbered 7.7 to associate it to Model 204 version 7.7, the product is integrated with the Model 204 Online load module and invoked as part of the integrated load module.

Regardless of product version, Fast/Unload is invoked with the EXEC JCL card, and its program name as distributed is FUNLOAD:

// EXEC PGM=FUNLOAD

DD names

The following DD names are used by Fast/Unload:

  • FUNIN — This DD contains the statements used to describe the unload. FUNIN must be composed of fixed-length, 80-byte records.
  • FUNPRINT — This DD is used as a log file and for reporting errors. This DD is referred to as the report data set. No DCB information is required, but if supplied:
    • RECFM may be x[B][A], where x is F or V. If not specified, it defaults to VBA. ASCII carriage control (the A suffix) is always used.
    • LRECL defaults to either 133 (for RECFM F) or 137 (for RECFM V)
    • BLKSIZE defaults to 8192 (for RECFM F) or 8196 (for RECFM V)
  • destination — A DD is required for each of the sequential data sets (which must be unique) declared as an output stream to which records are to be unloaded. FUNOUT is the default output stream for FUEL programs written for versions prior to 4.1.
  • input — A DD statement is required for the input Model 204 data file. The DD statement for the Model 204 file must match the internal name of the data file. In addition, if a Model 204 data file is made up of multiple physical files, DD cards must be provided for all physical files making up the logical file.
  • SYSUDUMP or SYSMDUMP
    • Prior to version 7.7:

      It is recommended that you allocate either SYSUDUMP or SYSMDUMP to the Fast/Unload job step.

    • As of version 7.7:

      Do not use SYSUDUMP. SYSMDUMP is still useful.

As of the version 7.7 integration of Fast/Unload with the Online load module, these additional DD names can be used with PGM=FUNLOAD for possible problem diagnosis by Rocket Technical Support. They are not required.

  • CCASNAP — If Fast/Unload encounters an abend, a Model 204 snap is created and sent to the CCASNAP DD. Since this is key to diagnosing many problems, Fast/Unload ensures that the DD name is allocated (to SYSOUT=A) if it has not been provided.
  • CCAAUDIT — You can capture the normal Model 204 audit trail if you provide a CCAAUDIT DD. This is a small file (generally less than 100 records) and the information is usually not important, but it might be helpful for problem diagnosis.
  • CCAPRINT — You can capture the normal Model 204 file for initialization if you provide a CCAPRINT DD. This is a small file (generally less than 50 records) and the information is usually not important, but it might be helpful for problem diagnosis. You should be able to define this as a SYSOUT file.

Sample JCL

The following is an example of JCL that runs pre-7.7 Fast/Unload as a standalone program in a z/OS environment:

//FUNLOAD JOB (0),CLASS=C,MSGCLASS=A,NOTIFY=HOMER //FUNLOAD EXEC PGM=FUNLOAD,REGION=1024K //STEPLIB DD DSN=M204.FUNLOAD.LOAD,DISP=SHR //SYSUDUMP DD DSN=SYSOUT=* //SIRXREFD DD DSN=ULSPF.V404.SIRXREFD,DISP=SHR //FUNOUT DD UNIT=TAPE,VOL=SER=DUMP1, // LABEL=(1,SL),DISP=(NEW,PASS), // DSN=SIRXREFD.OUTPUT,DCB=BLKSIZE=30000 //FUNPRINT DD SYSOUT=* //FUNIN DD * OPEN SIRXREFD FOR EACH RECORD PUT '*' OUTPUT PAI END FOR //

The same JCL can be used for version 7.7 and later, except:

  • Change the load library. Use something like the following to reference the integrated Model 204 library:

    //STEPLIB DD DISP=SHR,DSN=M204.V77.LOADLIB

  • Consider using the additional optional 7.7 DD statements.

Invoking Fast/Unload as a standalone CMS program

Fast/Unload must be invoked by the Model 204 CMS interface because it uses the CMS interface's EXCP and BSAM simulation. The program name of Fast/Unload as distributed is FUNLOAD. A FILEDEF must be provided for any DD to be used by Fast/Unload.

Note: Because Fast/Unload uses the Model 204 CMS interface, any file can be on an OS format minidisk.

The following DDNAMEs are used by Fast/Unload:

  • FUNIN — This DD contains the FUEL used to describe the unload. FUNIN must be composed of fixed length, 80 byte records.
  • FUNPRINT — This DD will be used as a log file and for reporting errors. This DD will also be referred to as the report data set.
  • destination — A DD is required for each of the sequential data sets (which must be unique) declared as an output stream to which records are to be unloaded. FUNOUT is the default output stream for FUEL programs written for versions prior to 4.1.

A FILEDEF statement is also required for the input Model 204 data file. The FILEDEF statement for the Model 204 file must match the internal name of the data file. In addition, if a Model 204 data file is made up of multiple physical files, FILEDEF commands must be provided for all physical files making up the logical file.

The following is an example of an EXEC that runs Fast/Unload in a CMS environment. Note that while REXX is used here, the EXEC could be written in EXEC or EXEC2.

/* Exec to run Fast/Unload */ Address command; 'FILEDEF * CLEAR'; 'FILEDEF FUNIN DISK FUN FUNLOAD A'; 'FILEDEF FUNPRINT DISK FUN LISTING A', '(RECFM VB LRECL 137 BLOCK 4096'; 'FILEDEF FUNOUT TAP1 (LRECL 10000 BLOCK 30000 RECFM VB'; 'FILEDEF SIRXREFD I DSN ULSPF V404 SIRXREFD'; 'M204CMS FUNLOAD'; Exit rc;

Note: In the above example, the Fast/Unload Extraction Language program is in file FUN FUNLOAD on a CMS format disk, and the Model 204 data file SIRXREFD is on an OS-format minidisk.

See also