DEFINE FILE command - Revision history

DCameron: /* Usage notes */

2019-02-12T13:07:39Z

Usage notes

← Older revision		Revision as of 13:07, 12 February 2019
Line 94:		Line 94:

	<li>		<li>
	<p>Issue a new CREATE GROUP command.</p>		<p>Issue a new <var>[[CREATE_command:_Permanent_group\|CREATE GROUP]]</var> command.</p>
	</li>		</li>

DCameron: /* Usage notes */

2019-02-12T13:06:11Z

Usage notes

← Older revision		Revision as of 13:06, 12 February 2019
Line 74:		Line 74:

	<li>		<li>
	<p>In a User Language procedure (with the necessary privileges) </p>		<p>In a User Language [[Procedures\|procedure]] (with the necessary privileges) </p>
	</li>		</li>
	</ul>		</ul>

DCameron: /* Usage notes */

2019-02-12T13:05:01Z

Usage notes

← Older revision		Revision as of 13:05, 12 February 2019
Line 66:		Line 66:
	<ul>		<ul>
	<li>		<li>
	<p>In the CCAIN User 0 stream of the client copy of <var class="product">Model 204</var></p>		<p>In the [[Defining_the_runtime_environment_(CCAIN)\|CCAIN]] User 0 stream of the client copy of <var class="product">Model 204</var></p>
	</li>		</li>

DCameron: /* Syntax */

2019-02-12T13:03:11Z

Syntax

← Older revision		Revision as of 13:03, 12 February 2019
Line 42:		Line 42:
	<p>An equal sign (<tt>=</tt>) in single quotes indicates that the location is the client node, that is, the file is local. </p>		<p>An equal sign (<tt>=</tt>) in single quotes indicates that the location is the client node, that is, the file is local. </p>
	<p>		<p>
	The location name also might be required to match a value that is specified in the <var>DESTINATION</var> parameter of a local (client) <var>DEFINE PROCESS</var> command. If the <var>DESTINATION</var> name is specified in processgroup-symbolic name format, <var class="term">locationname</var> must match a specified symbolic name. </p>		The location name also might be required to match a value that is specified in the <var>DESTINATION</var> parameter of a local (client) <var>[[DEFINE_PROCESS_command:_Overview_of_intersystem_network_process\|DEFINE PROCESS]]</var> command. If the <var>DESTINATION</var> name is specified in processgroup-symbolic name format, <var class="term">locationname</var> must match a specified symbolic name. </p>
	<p>In the following example, the <var>DEFINE PROCESS</var> command includes: </p>		<p>In the following example, the <var>DEFINE PROCESS</var> command includes: </p>
	<p class="code">DESTINATION=(PGRP1,BOSTON)		<p class="code">DESTINATION=(PGRP1,BOSTON)

DCameron: /* Summary */

2019-02-12T12:56:41Z

Summary

← Older revision		Revision as of 12:56, 12 February 2019
Line 4:		Line 4:
	<dd>System manager, User 0		<dd>System manager, User 0
	<dt>Function		<dt>Function
	<dd>Defines a file synonym, a symbolic name for referencing a [[PQO:_Overview_of_Parallel_Query_Option/204\|Parallel Query Option/204]] remote file		<dd>Defines a file synonym, a symbolic name for referencing a [[PQO:_Overview_of_Parallel_Query_Option/204\|Parallel Query Option/204]] [[Files,_groups,_and_reference_context#Remote_files\|remote file]]
	</dl>		</dl>

DCameron: /* Summary */

2019-02-12T12:55:23Z

Summary

← Older revision		Revision as of 12:55, 12 February 2019
Line 4:		Line 4:
	<dd>System manager, User 0		<dd>System manager, User 0
	<dt>Function		<dt>Function
	<dd>Defines a file synonym, a symbolic name for referencing a Parallel Query Option/204 remote file		<dd>Defines a file synonym, a symbolic name for referencing a [[PQO:_Overview_of_Parallel_Query_Option/204\|Parallel Query Option/204]] remote file
	</dl>		</dl>

	==Syntax==		==Syntax==
	<p class="syntax">DEFINE FILE <span class="term">name</span> [LIKE <span class="term">previousname</span>] WITH SCOPE=SYSTEM		<p class="syntax">DEFINE FILE <span class="term">name</span> [LIKE <span class="term">previousname</span>] WITH SCOPE=SYSTEM

ELowell: /* Usage notes */

2017-04-06T21:39:16Z

Usage notes

← Older revision		Revision as of 21:39, 6 April 2017
Line 99:		Line 99:
	<p>Open the group again.</p>		<p>Open the group again.</p>
	</li>		</li>
	</ol>		</ol>

			==See also==
			<p>For general syntax and usage notes that apply to all forms of the <var>DEFINE</var> command, see <var>[[DEFINE command]]</var>.</p>

	[[Category: System manager commands]]		[[Category: System manager commands]]
	[[Category:Commands]]		[[Category:Commands]]

JAL: /* Syntax */ add link

2016-07-01T20:32:28Z

Syntax: add link

← Older revision		Revision as of 20:32, 1 July 2016
Line 15:		Line 15:
	<ul>		<ul>
	<li>		<li>
	<p><var class="term">name</var> is required and is the symbolic name (file synonym) assigned to the file. The name must be from one to eight characters in length. If the name is already in use as a file synonym for this copy of <var class="product">Model 204</var>, DEFINE FILE <~~var class="term"~~>name</~~var~~> gives <var class="term">name</var> a new definition.</p>		<p><var class="term">name</var> is required and is the symbolic name (file synonym) assigned to the file. The name must be from one to eight characters in length. If the name is already in use as a file synonym for this copy of <var class="product">Model 204</var>, <code>DEFINE FILE <i>name</i></code> gives <var class="term">name</var> a new definition.</p>
			<p>
			For additional details about file name requirements, see the [[Creating a file#filename\|CREATE FILE syntax]] discussion. </p>
	</li>		</li>

	<li>		<li>
	<p><var>LIKE</var> is optional and gives the file synonym currently being defined the attributes of the file referred to by <var class="term">previousname</var>, where <var class="term">previousname</var> is a symbolic name that was previously defined. </p>		<p><var>LIKE</var> is optional and gives the file synonym currently being defined the attributes of the file referred to by <var class="term">previousname</var>, where <var class="term">previousname</var> is a symbolic name that was previously defined. </p>
	<p> If used, <~~var~~>LIKE<~~/var~~> <~~var class="term"~~>~~previousname~~</~~var~~> assigns an additional file synonym, and the FILENAME and LOCATION parameters are not required.</p>		<p>
			If used, <code>LIKE <i>previousname</i></code> assigns an additional file synonym, and the <var>FILENAME</var> and <var>LOCATION</var> parameters are not required.</p>
	</li>		</li>

Line 28:		Line 31:

	<li>		<li>
	<p>A <var>FILENAME</var> setting is required, if <~~var~~>LIKE previousname</~~var~~> is not specified in the definition. actualfilename is the file's name as specified in a <var class="product">Model 204</var> CREATE FILE command on the INE node to which the file belongs. </p>		<p>A <var>FILENAME</var> setting is required, if <code>LIKE <i>previousname</i></code> is not specified in the definition. <var class="term">actualfilename</var> is the file's name as specified in a <var class="product">Model 204</var> <var>CREATE FILE</var> command on the INE node to which the file belongs. </p>
	</li>		</li>

	<li>		<li>
	<p><var>LOCATION</var> is required, if <~~var~~>LIKE previousname</~~var~~> is not specified in the definition. locationname refers to the location of the remote node on which the actual file resides. </p>		<p><var>LOCATION</var> is required, if <code>LIKE <i>previousname</i></code> is not specified in the definition. <var class="term">locationname</var> refers to the location of the remote node on which the actual file resides. </p>
	</li>		</li>

	<li>		<li>
	<p>An equal sign (=) in single quotes indicates that the location is the client node, that is, the file is local. </p>		<p>An equal sign (<tt>=</tt>) in single quotes indicates that the location is the client node, that is, the file is local. </p>
	<p>The location name also might be required to match a value that is specified in the DESTINATION parameter of a local (client) DEFINE PROCESS command. If the DESTINATION name is specified in processgroup-symbolic name format, locationname must match a specified symbolic name. </p>		<p>
	<p>In the following example, the DEFINE PROCESS command includes: </p>		The location name also might be required to match a value that is specified in the <var>DESTINATION</var> parameter of a local (client) <var>DEFINE PROCESS</var> command. If the <var>DESTINATION</var> name is specified in processgroup-symbolic name format, <var class="term">locationname</var> must match a specified symbolic name. </p>
			<p>In the following example, the <var>DEFINE PROCESS</var> command includes: </p>
	<p class="code">DESTINATION=(PGRP1,BOSTON)		<p class="code">DESTINATION=(PGRP1,BOSTON)
	</p>		</p>
	<p>The system manager then defines a synonym for a remote file by specifying the following location name in a file definition:</p>		<p>
			The system manager then defines a synonym for a remote file by specifying the following location name in a file definition:</p>
	<p class="code">LOCATION=BOSTON		<p class="code">LOCATION=BOSTON
	</p>		</p>
	</li>		</li>
	</ul>		</ul>

	==Example==		==Example==

JAL: /* Example */ typo

2016-07-01T20:12:40Z

Example: typo

← Older revision		Revision as of 20:12, 1 July 2016
Line 48:		Line 48:

	==Example==		==Example==
	In the following example, DEFINE FILE specifies the synonym CARS for the file VEHICLES:		In the following example, <var>DEFINE FILE</var> specifies the synonym <code>CARS</code> for the file VEHICLES:
	<p class="code">DEFINE FILE CARS WITH -		<p class="code">DEFINE FILE CARS WITH -
	SCOPE=SYSTEM -		SCOPE=SYSTEM -
	FILENAME=VEHICLES -		FILENAME=VEHICLES -
	LOCATION=BOSTON		LOCATION=BOSTON
	</p>		</p>

	==Usage notes==		==Usage notes==
	<p>Useful only for PQO users, the DEFINE FILE command maps a file synonym defined by a local user against the actual name of a local or remote file, using the location where the file resides. Once the DEFINE FILE command has been issued, local users can refer to the file using the synonym name. </p>		<p>Useful only for PQO users, the DEFINE FILE command maps a file synonym defined by a local user against the actual name of a local or remote file, using the location where the file resides. Once the DEFINE FILE command has been issued, local users can refer to the file using the synonym name. </p>

ELowell: /* Syntax */

2013-08-22T17:53:53Z

Syntax

← Older revision		Revision as of 17:53, 22 August 2013
Line 7:		Line 7:
	</dl>		</dl>
	==Syntax==		==Syntax==
	<p class="syntax">DEFINE FILE name [LIKE previousname] WITH SCOPE=SYSTEM		<p class="syntax">DEFINE FILE <span class="term">name</span> [LIKE <span class="term">previousname</span>] WITH SCOPE=SYSTEM
	FILENAME=actualfilename		FILENAME=<span class="term">actualfilename</span>
	LOCATION={locationname \|'='}		LOCATION={<span class="term">locationname</span> \|'='}
	</p>		</p>

Line 15:		Line 15:
	<ul>		<ul>
	<li>		<li>
	<p>name is required and is the symbolic name (file synonym) assigned to the file. The name must be from one to eight characters in length. If name is already in use as a file synonym for this copy of <var class="product">Model 204</var>, DEFINE FILE name gives<var> name</var> a new definition.</p>		<p><var class="term">name</var> is required and is the symbolic name (file synonym) assigned to the file. The name must be from one to eight characters in length. If the name is already in use as a file synonym for this copy of <var class="product">Model 204</var>, DEFINE FILE <var class="term">name</var> gives <var class="term">name</var> a new definition.</p>
	</li>		</li>

	<li>		<li>
	<p><var>LIKE</var> is optional and gives the file synonym currently being defined the attributes of the file referred to by previousname, where previousname is a symbolic name that was previously defined. </p>		<p><var>LIKE</var> is optional and gives the file synonym currently being defined the attributes of the file referred to by <var class="term">previousname</var>, where <var class="term">previousname</var> is a symbolic name that was previously defined. </p>
	<p> If used, <var>LIKE previousname</var> assigns an additional file synonym, and the FILENAME and LOCATION parameters are not required.</p>		<p> If used, <var>LIKE</var> <var class="term">previousname</var> assigns an additional file synonym, and the FILENAME and LOCATION parameters are not required.</p>
	</li>		</li>

Line 46:		Line 46:
	</li>		</li>
	</ul>		</ul>

	==Example==		==Example==
	In the following example, DEFINE FILE specifies the synonym CARS for the file VEHICLES:		In the following example, DEFINE FILE specifies the synonym CARS for the file VEHICLES: