ibm-information-center/dist/eclipse/plugins/i5OS.ic.dbp_5.4.0.1/rbafocosof.htm

79 lines
6.0 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="Files shared in a job" />
<meta name="abstract" content="In order for your application program to use the open data path built by the Open Query File (OPNQRYF) command, your program must share the query file. If your program does not open the query file as shared, then it actually does a full open of the file it was originally compiled to use (not the query open data path built by the OPNQRYF command)." />
<meta name="description" content="In order for your application program to use the open data path built by the Open Query File (OPNQRYF) command, your program must share the query file. If your program does not open the query file as shared, then it actually does a full open of the file it was originally compiled to use (not the query open data path built by the OPNQRYF command)." />
<meta name="DC.subject" content="sharing, file, OPNQRYF command, database file, sharing in a job, open data path considerations, in a job" />
<meta name="keywords" content="sharing, file, OPNQRYF command, database file, sharing in a job, open data path considerations, in a job" />
<meta name="DC.Relation" scheme="URI" content="rbafoopnqf.htm" />
<meta name="DC.Relation" scheme="URI" content="rbafosfile.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbafocosof" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Files shared in a job</title>
</head>
<body id="rbafocosof"><a name="rbafocosof"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Files shared in a job</h1>
<div><p>In order for your application program to use the open data path
built by the Open Query File (OPNQRYF) command, your program must share the
query file. If your program does not open the query file as shared, then it
actually does a full open of the file it was originally compiled to use (not
the query open data path built by the OPNQRYF command). </p>
<div class="p">Your program will share the query open data path, depending on the following
conditions: <ul><li>Your application program must open the file as shared. Your program meets
this condition when the first or only member queried (as specified on the
FILE parameter) has an attribute of SHARE(*YES). If the first
or only member has an attribute of SHARE(*NO), then you must specify SHARE(*YES)
in an Override with Database File (OVRDBF) command before calling your program.</li>
<li>The file opened by your application program must have the same name as
the file opened by the OPNQRYF command. Your program meets this condition
when the file specified in your program has the same file and member name
as the first or only member queried (as specified on the FILE parameter).
If the first or only member has a different name, then you must specify an
Override with Database File (OVRDBF) command of the name of the file your
program was compiled against to the name of the first or only member queried.</li>
<li>Your program must be running in the same activation group to which the
query open data path (ODP) is scoped. If the query ODP is scoped to the job,
your program can run in any activation group within the job.</li>
</ul>
</div>
<div class="p">The OPNQRYF command never shares an existing open data path in the job
or activation group. A request to open a query file fails with an error message
if the open data path has the same library, file, and member name that is
in the open request, and if either of the following is true: <ul><li>OPNSCOPE(*ACTGRPDFN) or OPNSCOPE(*ACTGRP) is specified for the OPNQRYF
command, and the open data path is scoped to the same activation group or
job from which the OPNQRYF command is run.</li>
<li>OPNSCOPE(*JOB) is specified for the OPNQRYF command, and the open data
path is scoped to the same job from which the OPNQRYF command is run.</li>
</ul>
</div>
<p>Subsequent shared opens adhere to the same open options (such as SEQONLY)
that were in effect when the OPNQRYF command was run.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbafoopnqf.htm" title="The Open Query File (OPNQRYF) command is a control language (CL) command that allows you to perform many data processing functions on database files. These topics discuss how to create a query using the OPNQRYF command, how to specify parameters for its major functions, and how to use it with your high-level language program.">Use Open Query File (OPNQRYF) command</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rbafosfile.htm" title="By default, the database management system lets one file be read and changed by many users at the same time. However, you can share the database files in the same job or activation group through the SHARE parameter.">Share database files in the same job or activation group</a></div>
</div>
</div>
</body>
</html>