HLI: Model 204 data sets in HLI jobs - Revision history

ELowell: /* Specifying a Model 204 data set */

2016-07-16T00:58:08Z

Specifying a Model 204 data set

← Older revision		Revision as of 00:58, 16 July 2016
Line 75:		Line 75:
	===Specifying a Model 204 data set===		===Specifying a Model 204 data set===
	<p>		<p>
	To specify a particular Model 204 data set, include a job control statement that references the data set in the job setup. ~~Refer to the <var class="book">Rocket Model 204 Host Language Interface Reference Manual</var>~~ for detailed information about IFAM1 and IFAM4 jobs. </p>		To specify a particular Model 204 data set, include a job control statement that references the data set in the job setup. See [[HLI: Job requirements]] for detailed information about IFAM1 and IFAM4 jobs. </p>
	<p>		<p>
	The following sections describe each of the Model 204 data sets used in HLI jobs.</p>		The following sections describe each of the Model 204 data sets used in HLI jobs.</p>

ELowell: /* Overview */

2016-07-16T00:56:57Z

Overview

← Older revision		Revision as of 00:56, 16 July 2016
Line 5:		Line 5:

	<p>		<p>
	~~Refer to the <var class="book">Rocket Model 204 Host Language Interface Reference Manual</var>~~ for a description of IFAM1 and IFAM4 jobs.</p>		See [[HLI: Job requirements]] for a description of IFAM1 and IFAM4 jobs.</p>

	==Model 204 data sets for IFAM1 and IFAM4 jobs==		==Model 204 data sets for IFAM1 and IFAM4 jobs==

ELowell at 16:38, 29 April 2016

2016-04-29T16:38:40Z

← Older revision		Revision as of 16:38, 29 April 2016
Line 193:		Line 193:

	==See also==		==See also==
	{{Template: HLI topic list}}		{{Template: HLI programming topic list}}

	[[Category: Host Language Interface]]		[[Category: Host Language Interface]]

ELowell: /* CHKPOINT file */

2016-01-30T00:33:38Z

CHKPOINT file

← Older revision		Revision as of 00:33, 30 January 2016
Line 190:		Line 190:
	The CHKPOINT file is optional for IFAM1 and IFAM4 jobs. However, CHKPOINT is required for checkpointing, which is used with the recovery facility. </p>		The CHKPOINT file is optional for IFAM1 and IFAM4 jobs. However, CHKPOINT is required for checkpointing, which is used with the recovery facility. </p>
	<p>		<p>
	See [[HLI ~~and~~ Model 204 recovery and checkpoints]] for more information about CHKPOINT used in HLI jobs. </p>		See [[HLI: Model 204 recovery and checkpoints]] for more information about CHKPOINT used in HLI jobs. </p>

	==See also==		==See also==

ELowell: /* CCAJRNL, CCAJLOG, and CCAAUDIT files */

2016-01-30T00:31:50Z

CCAJRNL, CCAJLOG, and CCAAUDIT files

← Older revision		Revision as of 00:31, 30 January 2016
Line 182:		Line 182:
	The CCAJRNL, CCAJLOG, and CCAAUDIT files are optional for IFAM1 and IFAM4 jobs. However, CCAJRNL is required for the recovery facility and functions differently for recovery in IFAM1 and IFAM4. </p>		The CCAJRNL, CCAJLOG, and CCAAUDIT files are optional for IFAM1 and IFAM4 jobs. However, CCAJRNL is required for the recovery facility and functions differently for recovery in IFAM1 and IFAM4. </p>
	<p>		<p>
	See [[HLI ~~and~~ Model 204 recovery and checkpoints]] for more information about CCAJRNL, CCAJLOG, and CCAAUDIT used in HLI jobs. </p>		See [[HLI: Model 204 recovery and checkpoints]] for more information about CCAJRNL, CCAJLOG, and CCAAUDIT used in HLI jobs. </p>

	==CHKPOINT file==		==CHKPOINT file==

ELowell: /* CCASERVR file */

2016-01-30T00:30:30Z

CCASERVR file

← Older revision		Revision as of 00:30, 30 January 2016
Line 146:		Line 146:
	All runs that use server swapping (the parameter NSERVS is less than NUSERS) require one of more server data sets, which can be either temporary or permanent files. </p>		All runs that use server swapping (the parameter NSERVS is less than NUSERS) require one of more server data sets, which can be either temporary or permanent files. </p>
	<p>		<p>
	CCASERVR is required in IFAM4 (and is not valid for use in IFAM1). </p>		CCASERVR is required in IFAM4 (and is not valid for use in IFAM1).</p>
	<p>		<p>
	The server data sets are used for temporary storage of a user's work area when that user is swapped out of memory. See [[HLI ~~and~~ Model 204 tables]] for information about the user work area. </p>		The server data sets are used for temporary storage of a user's work area when that user is swapped out of memory. See [[HLI: Model 204 tables]] for information about the user work area.</p>

	==CCASNAP file==		==CCASNAP file==

ELowell: Created page with " ==Overview==
This chapter describes the Model 204 data sets used in an IFAM1 or IFAM4 HLI job for application programmers who are using the Host Language Interface facili..."

2016-01-29T23:15:08Z

Created page with " ==Overview== This chapter describes the Model 204 data sets used in an IFAM1 or IFAM4 HLI job for application programmers who are using the Host Language Interface facili..."

New page

==Overview==

This chapter describes the Model 204 data sets used in an IFAM1 or IFAM4 HLI job for application programmers who are using the Host Language Interface facility. 


Refer to the <var class="book">Rocket Model 204 Host Language Interface Reference Manual</var> for a description of IFAM1 and IFAM4 jobs.

==Model 204 data sets for IFAM1 and IFAM4 jobs==

===Required data sets===

The following standard Model 204 data sets are required in IFAM1 and IFAM4 job runs. Model 204 requires each of these data sets for a particular function. 
<table>
<tr class="head">
<th>Model 204 data set</th>
<th>Function</th>
</tr>
<tr>
<td>CCAPRINT</td>
<td>Prints the contents of CCAIN</td>
</tr>
<tr>
<td>CCASERVR</td>
<td>Holds user work area for server swapping (IFAM4 only)</td>
</tr>
<tr>
<td>CCASNAP</td>
<td>Stores a snap dump used for error diagnostics</td>
</tr>
<tr>
<td>CCATEMP</td>
<td>Writes a scratch file used for temporary storage</td>
</tr>
</table>

Note: For IFAM2, these data sets are included in the Model 204 Online job. 

===Data sets required for a particular Model 204 facility===

Except for CCAAUDIT which is optional, Model 204 requires that you specify the following data sets when using the particular facility: 
<table>
<tr class="head">
<th>Data set</th>
<th>Function</th>
<th>Required for...</th>
</tr>
<tr>
<td>CCAAUDIT</td>
<td>Audit log</td>
<td>Optional for recovery</td>
</tr>
<tr>
<td>CCAGRP</td>
<td>Group definitions</td>
<td>Permanent file groups</td>
</tr>
<tr>
<td>CCAJRN</td>
<td>Journal log</td>
<td>Recovery</td>
</tr>
<tr>
<td>CHKPOINT</td>
<td>Checkpoint log</td>
<td>Recovery</td>
</tr>
<tr>
<td>CCASTAT</td>
<td>Pointer to table</td>
<td>Security features</td>
</tr>
</table>

===Specifying a Model 204 data set===

To specify a particular Model 204 data set, include a job control statement that references the data set in the job setup. Refer to the <var class="book">Rocket Model 204 Host Language Interface Reference Manual</var> for detailed information about IFAM1 and IFAM4 jobs. 

The following sections describe each of the Model 204 data sets used in HLI jobs.

==CCAPRINT file==

CCAPRINT defines a single sequential output data set that contains a summary of the user parameter lines and output generated by User 0 (from CCAIN in IFAM4). 

The CCAPRINT file is required for IFAM1 and IFAM4 jobs. 

The following guidelines apply when using CCAPRINT:
<ul>
<li>In IFAM1 and IFAM4 under z/OS, specify SYSOUT=A.</li>
<li>In IFAM1 under VSE, specify SYSLST.</li>
<li>In IFAM1 under CMS, specify PRINTER .</li>
</ul>

==CCATEMP file==

CCATEMP is a scratch file, either temporary or permanent, whose pages are used as work areas during a Model 204 run. The CCATEMP data set is initialized with each Model 204 run. CCATEMP must not be shared with other Model 204 jobs. 

The CCATEMP file is required for IFAM1 and IFAM4 jobs. 

===Multiple uses for CCATEMP===

Model 204 uses the scratch file for HLI jobs primarily to hold the results of IFFIND calls and record set lists. 

In addition, Model 204 uses CCATEMP in the following ways: 
<ul>
<li>Copies of sorted records
Copies of records sorted via IFSORT occupy pages in CCATEMP.
For a single cursor IFSTRT thread, Model 204 releases the pages in CCATEMP as the records are processed by IFGET or when IFFIND is called. For a multiple cursor IFSTRT thread, Model 204 holds the pages in CCATEMP until the sorted set is released.
</li>
<li>File group references
File groups also use the scratch file. For IFAM1 and IFAM4 jobs that use file groups, Technical Support recommends that you allocate a scratch file of 20 pages for each thread. (Note that in IFAM1, a single thread is permitted.) 
</li>
</ul>

===CCATEMP size requirements===

When using CCATEMP, the unit type must be compatible with the installation site's page size, as summarized below.
<table>
<tr class="head">
<th>Page size</th>
<th>Allowable CCATEMP units</th>
</tr>
<tr>
<td>6184</td>
<td>3330, 3340, 3350, 3375, 3380, 3390, or 2305-2</td>
</tr>
</table>

The size of the scratch file is related to the complexity of the retrievals executed during the run. 

Note also that copies of sorted records in CCATEMP are at least as large as the original records in Table B. Coded values are expanded to character strings. You must allocate enough CCATEMP space to hold the records to be sorted. 

Note: If you encounter the CCATEMP FULL error message in an IFAM1 or IFAM4 job run, increase the CCATEMP space allocation. 

===Using secondary CCATEMP data sets===

To increase the efficiency of the scratch file for very heavy usage, you can partition CCATEMP into as many as 10 secondary data sets (CCATMP0 through CCATMP9). 

You can optionally provide secondary scratch data sets for a Model 204 run using file names CCATMP0 through CCATMP9. Model 204 logically appends all the space in each available data set to CCATEMP. 

Spreading the data sets over many channels and balancing the channel load improves performance. Also, partitioning makes it possible to incorporate one or more high-speed storage media for CCATEMP. 

Note: If you specify CCATMP data sets in a job run, Model 204 attempts to open the secondary data sets in numerical order and stops at the first missing data set. 
==CCASERVR file==

All runs that use server swapping (the parameter NSERVS is less than NUSERS) require one of more server data sets, which can be either temporary or permanent files. 

CCASERVR is required in IFAM4 (and is not valid for use in IFAM1). 

The server data sets are used for temporary storage of a user's work area when that user is swapped out of memory. See [[HLI and Model 204 tables]] for information about the user work area. 

==CCASNAP file==
Model 204 can trap program checks and file integrity problems at appropriate times and print snap dumps of selected portions of storage to the CCASNAP data set. 
These dumps are invaluable to Technical Support for locating and correcting errors.
The CCASNAP file is required for IFAM1 and IFAM4 jobs. 
The following guidelines apply when using CCASNAP:
<ul>
<li>
In IFAM1 and IFAM4 under z/OS, either the SYSUDUMP or SYSMDUMP data set might also be required to diagnose certain errors. Both are normally specified as SYSOUT data sets.</li>
<li>
In IFAM1 under VM, a VMDUMP may be required in addition to CCASNAP. </li>
<li>
In IFAM1 under VSE, CCASNAP goes to SYSLST.</li>
</ul>

==CCASTAT file==

CCASTAT points to a previously created password table data set. 

CCASTAT is required for any IFAM1 or IFAM4 run that uses the Model 204 security features. 

==CCAGRP file==
CCAGRP is a previously created data set that stores definitions of permanent groups. 
CCAGRP is required for any IFAM1 or IFAM4 run that accesses permanent file groups. 

Note: To access the definitions in the CCAGRP file, set option 2 of the SYSOPT parameter. 

==CCAJRNL, CCAJLOG, and CCAAUDIT files==

The Model 204 journals-- CCAJRNL and the optional CCAJLOG--and audit trail (CCAAUDIT) files provide a log of information about a Model 204 run. A single execution of Model 204 can log information in a journal(s), an audit trail, or both. 

The CCAJRNL, CCAJLOG, and CCAAUDIT files are optional for IFAM1 and IFAM4 jobs. However, CCAJRNL is required for the recovery facility and functions differently for recovery in IFAM1 and IFAM4. 

See [[HLI and Model 204 recovery and checkpoints]] for more information about CCAJRNL, CCAJLOG, and CCAAUDIT used in HLI jobs. 

==CHKPOINT file==

CHKPOINT is a sequential file that contains copies of Model 204 file pages before updates are applied and marker records that record the date and time when no updating activity is occurring on the system. 

The CHKPOINT file is optional for IFAM1 and IFAM4 jobs. However, CHKPOINT is required for checkpointing, which is used with the recovery facility. 

See [[HLI and Model 204 recovery and checkpoints]] for more information about CHKPOINT used in HLI jobs. 

==See also==
{{Template: HLI topic list}}

[[Category: Host Language Interface]]