Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, Programming Guide

Using the TITLE option of the OPEN statement

You can use the TITLE option of the OPEN statement to identify the data set to be associated with a PL/I file and, optionally, to provide additional characteristics of the data set.

Read syntax diagramSkip visual syntax diagram>>-TITLE--(--expression--)-------------------------------------><
 

The expression must yield a character string with the following syntax:

Read syntax diagramSkip visual syntax diagram>>-+-alternate_ddname--------------------+---------------------><
   | .---------------------------------. |
   | V                                 | |
   '---/filespec--+---+--+-----------+-+-'
                  '-,-'  '-dd_option-'
 
alternate_ddname
The name of an alternate DD_DDNAME environment variable. An alternate DD_DDNAME environment variable is one not named after a file constant. For example, if you had a file named INVENTRY in your program, and you establish two DD_DDNAME environment variables—the first named INVENTRY and the second named PARTS—you could associate the file with the second one using this statement:
open file(Inventry) title('PARTS');
filespec
Any valid z/OS UNIX or z/OS DSN file specification.
dd_option
One or more options allowed in a DD_DDNAME environment variable.

For more information about options of the DD_DDNAME variable, see Specifying characteristics using DD_DDNAME environment variables.

Here is an example of using the OPEN statement in this manner:

open file(Payroll) title('/June.Dat, append(n),recsize(52)');

With this form, PL/I obtains all DD information either from the TITLE expression or from the ENVIRONMENT attribute of a file declaration. A DD_DDNAME environment variable is not referenced.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)