$Dsn - Revision history

JAL: misc cleanup

2015-06-08T15:40:12Z

misc cleanup

← Older revision		Revision as of 15:40, 8 June 2015
Line 1:		Line 1:
	<p>$~~DSN~~ is useful with <var class="product">Model 204</var> files that are comprised of multiple data sets. You specify the <var class="product">Model 204</var> file's DD name and the ordinal number (first, second, third, and so on) of one of the file's data sets, and $~~DSN~~ returns the data set's name. </p>		<p>
	<p>The $~~DSN~~ syntax is:</p>		<var>$Dsn</var> is useful with <var class="product">Model 204</var> files that are comprised of multiple data sets. You specify the <var class="product">Model 204</var> file's DD name and the ordinal number (first, second, third, and so on) of one of the file's data sets, and <var>$Dsn</var> returns the data set's name. </p>
			<p>
			The <var>$Dsn</var> syntax is:</p>
	<p class="syntax">$DSN('<span class="term">ddname</span>',<span class="term">dsnnum</span>)		<p class="syntax">$DSN('<span class="term">ddname</span>',<span class="term">dsnnum</span>)
	</p>		</p>
	<p>~~where~~:</p>		<p>
			Where:</p>
	<ul>		<ul>
	<li><var class="term">ddname</var> is a <var class="product">Model 204</var> file's DD or file name. The file that you specify must be ~~OPEN~~ by you while you are using $~~DSN~~. This ensures reliable output.</li>		<li><var class="term">ddname</var> is a <var class="product">Model 204</var> file's DD or file name. The file that you specify must be opened by you while you are using <var>$Dsn</var>. This ensures reliable output.</li>
	~~</li>~~
	<li><var class="term">dsnnum</var> is a positive integer that represents the ordinal number of a data set. For example, specify 3 for <var class="term">dsnnum</var> if you want the name of the third of the multiple data sets that comprise the <var class="product">Model 204</var> file.</li>		<li><var class="term">dsnnum</var> is a positive integer that represents the ordinal number of a data set. For example, specify 3 for <var class="term">dsnnum</var> if you want the name of the third of the multiple data sets that comprise the <var class="product">Model 204</var> file.</li>
	~~</li>~~
	</ul>		</ul>
	<p>If no file or DD name is specified, if the data set number is too large, and if <var class="product">Model 204</var> cannot find the data set name, the system returns a counting error message.</p>		<p>
	<p>The output string is right~~-filled~~ with ~~SPACEs~~ to 44 bytes.</p>		If no file or DD name is specified, if the data set number is too large, and if <var class="product">Model 204</var> cannot find the data set name, the system returns a counting error message.</p>
	~~<b>~~Examples~~</b>~~		<p>
	<p>An example using $~~DSN~~ follows:</p>		The output string is padded on the right with blanks to 44 bytes.</p>
	<p class="code">~~FOR~~ %~~I FROM~~ 1 TO $~~DSNNUM~~('FU') BY 1
	~~PRINT~~ %~~I AND~~ $~~DSN~~('FU',%I)		==Examples==
	~~END FOR~~		<p>
			An example using <var>$Dsn</var> follows:</p>
			<p class="code">for %i from 1 to $dsnnum('FU') by 1
			print %i and $dsn('FU', %i)
			end for
	</p>		</p>
	<p>The next example does a straight $~~DSN~~ call for a file mapped to one data set.</p>		<p>
	<p class="code">%~~FILENAME IS STRING LEN~~ 8		The next example does a straight <var>$Dsn</var> call for a file mapped to one data set:</p>
	%~~FILENAME~~ = 'VEHICLES'		<p class="code">%filename is string len 8
	~~PRINT~~ 'FILE ' ~~WITH~~ %~~FILENAME WITH~~ ' ~~IS CONTAINED IN~~ -		%filename= 'VEHICLES'
	~~DATASET~~ ' ~~WITH~~ $~~DSN~~(%~~FILENAME~~,1)		print 'FILE ' with %filename with ' is contained in -
			dataset' with $dsn(%filename,1)
	</p>		</p>

	[[Category:SOUL $functions]]		[[Category:SOUL $functions]]

Tbullock: 44 bytes in z/OS anyway, I don't know about CMS or VSE...

2015-06-05T22:18:00Z

44 bytes in z/OS anyway, I don't know about CMS or VSE...

← Older revision		Revision as of 22:18, 5 June 2015
Line 11:		Line 11:
	</ul>		</ul>
	<p>If no file or DD name is specified, if the data set number is too large, and if <var class="product">Model 204</var> cannot find the data set name, the system returns a counting error message.</p>		<p>If no file or DD name is specified, if the data set number is too large, and if <var class="product">Model 204</var> cannot find the data set name, the system returns a counting error message.</p>
			<p>The output string is right-filled with SPACEs to 44 bytes.</p>
	<b>Examples</b>		<b>Examples</b>
	<p>An example using $DSN follows:</p>		<p>An example using $DSN follows:</p>
	<p class="code">FOR %I FROM 1 TO $DSNNUM('FU') BY 1		<p class="code">FOR %I FROM 1 TO $DSNNUM('FU') BY 1
	PRINT $DSN('FU',%I)		PRINT %I AND $DSN('FU',%I)
	END FOR		END FOR
	</p>		</p>

Tbullock: $DSNNUM only takes one parameter, not two.

2015-06-04T18:24:08Z

$DSNNUM only takes one parameter, not two.

← Older revision		Revision as of 18:24, 4 June 2015
Line 13:		Line 13:
	<b>Examples</b>		<b>Examples</b>
	<p>An example using $DSN follows:</p>		<p>An example using $DSN follows:</p>
	<p class="code">FOR %I FROM 1 TO $DSNNUM('FU'~~,%I~~) BY 1		<p class="code">FOR %I FROM 1 TO $DSNNUM('FU') BY 1
	PRINT $DSN('FU',%I)		PRINT $DSN('FU',%I)
	END FOR		END FOR

Mlarocca: Mlarocca moved page $DSN to $Dsn: Lower case change

2014-07-17T13:17:15Z

Mlarocca moved page $DSN to $Dsn: Lower case change

← Older revision	Revision as of 13:17, 17 July 2014
(No difference)

ELowell at 19:12, 13 August 2013

2013-08-13T19:12:24Z

← Older revision		Revision as of 19:12, 13 August 2013
Line 7:		Line 7:
	<li><var class="term">ddname</var> is a <var class="product">Model 204</var> file's DD or file name. The file that you specify must be OPEN by you while you are using $DSN. This ensures reliable output.</li>		<li><var class="term">ddname</var> is a <var class="product">Model 204</var> file's DD or file name. The file that you specify must be OPEN by you while you are using $DSN. This ensures reliable output.</li>
	</li>		</li>
	<li><var class="term">dsnnum</var> is a positive integer that represents the ordinal number of a data set. For example, specify 3 for dsnnum if you want the name of the third of the multiple data sets that comprise the <var class="product">Model 204</var> file.</li>		<li><var class="term">dsnnum</var> is a positive integer that represents the ordinal number of a data set. For example, specify 3 for <var class="term">dsnnum</var> if you want the name of the third of the multiple data sets that comprise the <var class="product">Model 204</var> file.</li>
	</li>		</li>
	</ul>		</ul>

ELowell at 19:10, 13 August 2013

2013-08-13T19:10:41Z

← Older revision		Revision as of 19:10, 13 August 2013
Line 1:		Line 1:
	<p>$DSN is useful with <var class="product">Model 204</var> files that are comprised of multiple data sets. You specify the <var class="product">Model 204</var> file's DD name and the ordinal number (first, second, third, and so on) of one of the file's data sets, and $DSN returns the data set's name. </p>		<p>$DSN is useful with <var class="product">Model 204</var> files that are comprised of multiple data sets. You specify the <var class="product">Model 204</var> file's DD name and the ordinal number (first, second, third, and so on) of one of the file's data sets, and $DSN returns the data set's name. </p>
	<p>The $DSN syntax is:</p>		<p>The $DSN syntax is:</p>
	<p class="~~code~~">$DSN('ddname',dsnnum)		<p class="syntax">$DSN('<span class="term">ddname</span>',<span class="term">dsnnum</span>)
	</p>		</p>
	<p>where:</p>		<p>where:</p>
	<ul>		<ul>
	<li>ddname is a <var class="product">Model 204</var> file's DD or file name. The file that you specify must be OPEN by you while you are using $DSN. This ensures reliable output.</li>		<li><var class="term">ddname</var> is a <var class="product">Model 204</var> file's DD or file name. The file that you specify must be OPEN by you while you are using $DSN. This ensures reliable output.</li>
	</li>		</li>
	<li>dsnnum is a positive integer that represents the ordinal number of a data set. For example, specify 3 for dsnnum if you want the name of the third of the multiple data sets that comprise the <var class="product">Model 204</var> file.</li>		<li><var class="term">dsnnum</var> is a positive integer that represents the ordinal number of a data set. For example, specify 3 for dsnnum if you want the name of the third of the multiple data sets that comprise the <var class="product">Model 204</var> file.</li>
	</li>		</li>
	</ul>		</ul>

Alex: Automatically generated page update

2013-04-20T13:18:53Z

Automatically generated page update

New page

$DSN is useful with <var class="product">Model 204</var> files that are comprised of multiple data sets. You specify the <var class="product">Model 204</var> file's DD name and the ordinal number (first, second, third, and so on) of one of the file's data sets, and $DSN returns the data set's name. 
The $DSN syntax is:
$DSN('ddname',dsnnum)

where:
<ul>
<li>ddname is a <var class="product">Model 204</var> file's DD or file name. The file that you specify must be OPEN by you while you are using $DSN. This ensures reliable output.</li>
</li>
<li>dsnnum is a positive integer that represents the ordinal number of a data set. For example, specify 3 for dsnnum if you want the name of the third of the multiple data sets that comprise the <var class="product">Model 204</var> file.</li>
</li>
</ul>
If no file or DD name is specified, if the data set number is too large, and if <var class="product">Model 204</var> cannot find the data set name, the system returns a counting error message.
Examples
An example using $DSN follows:
FOR %I FROM 1 TO $DSNNUM('FU',%I) BY 1
PRINT $DSN('FU',%I)
END FOR

The next example does a straight $DSN call for a file mapped to one data set.
%FILENAME IS STRING LEN 8
%FILENAME = 'VEHICLES'
PRINT 'FILE ' WITH %FILENAME WITH ' IS CONTAINED IN -
DATASET ' WITH $DSN(%FILENAME,1)

[[Category:SOUL $functions]]