ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakd_5.4.0.1/rzakdmstusrd.htm

83 lines
5.1 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="reference" />
<meta name="DC.Title" content="DTASTMCMD (Data Stream Command) keyword in printer files" />
<meta name="abstract" content="Use this record- or field-level keyword to store a data stream command or some other piece of information in a spooled file." />
<meta name="description" content="Use this record- or field-level keyword to store a data stream command or some other piece of information in a spooled file." />
<meta name="DC.subject" content="DTASTMCMD (Data Stream Command) keyword, Data Stream Command (DTASTMCMD) keyword" />
<meta name="keywords" content="DTASTMCMD (Data Stream Command) keyword, Data Stream Command (DTASTMCMD) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakdmstprkey.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzakdmstusrd" />
<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>DTASTMCMD (Data Stream Command) keyword in printer files</title>
</head>
<body id="rzakdmstusrd"><a name="rzakdmstusrd"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">DTASTMCMD (Data Stream Command) keyword in printer files</h1>
<div><p>Use this record- or field-level keyword to store a data stream
command or some other piece of information in a spooled file.</p>
<div class="section"><p>This command can be used to determine how to process a record
or field on a particular page of the spooled file. DTASTMCMD is valid only
for printer files with device type *AFPDS specified.</p>
<div class="p">The format of the
keyword is: <pre>DTASTMCMD(text |&amp;text-field);</pre>
</div>
<p>The
text must be enclosed in single quotation marks. If the length of the text
is greater than 255 characters, an error message will be signaled at compile
time.</p>
<p>The program-to-system field specified must exist in the same record
format as the DTASTMCMD keyword. If the length of the program-to-system field
is greater than 255 characters, an error message will be signaled at compile
time.</p>
<p>User applications or user specified programs that need to know
how to process a particular page in the spooled file can search the data stream
and retrieve the data stream command. This will be enclosed in an AFPDS (MODCA)
NOP command. The NOP will be built into the datastream before any printable
data for the record or field containing the keyword. Since this information
is just being stored, this keyword will not have a direct effect on the actual
file. For more information about the NOP command, refer to the <cite>MO:DCA™ Reference</cite>,
SC31-6802.</p>
<p>Option indicators are valid for this keyword.</p>
<div class="note"><span class="notetitle">Note:</span> You
can specify this keyword only once for each record and once for each field.</div>
</div>
<div class="section"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the DTASTMCMD keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A R RECORD1 DTASTMCMD('TEXT(Record 1)')
A FIELD1 10A 5 5
A 01 DTASTMCMD('TEXT(Field 1)')
A FIELD2 10A 10 5DTASTMCMD(&amp;DATA);
A DATA 10A P
A</pre>
<p>The data stream for the record RECORD1 has the text for
DTASTMCMD as TEXT(Record 1). If indicator 01 is optioned on, the data stream
for the field FIELD1 has the text for DTASTMCMD as TEXT(Field 1). If indicator
01 is optioned off, no data stream text is generated for DTASTMCMD on FIELD1.
FIELD2 will use what is contained in DATA as the text for DTASTMCMD.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakdmstprkey.htm" title="See the valid keyword entries for defining printer files in this topic.">Keyword entries for printer files (positions 45 through 80)</a></div>
</div>
</div>
</body>
</html>