z/OS MVS Program Management: User's Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Including library members

z/OS MVS Program Management: User's Guide and Reference
SA23-1393-00

DD statements referred to by an INCLUDE statement can define a library of files, either by pointing to a PDS or PDSE, or by pointing to a UNIX directory. The INCLUDE statement can then specify "members" of that library to be included. For a PDS or PDSE the member names are looked up in the data set directories. For a UNIX path the "members" listed in the INCLUDE statement are actually names of file within the directory. There may also be subdirectory path information attached to the file names.

Note that it is always possible to name a specific PDS or PDSE member, or UNIX file name, on the DD statement, and show only the DD name on the INCLUDE statement. From the binder perspective this is including sequential data.

See Including UNIX Files for more information on including UNIX files.

In the following example, one member name is specified on the INCLUDE statement.
//PAYROLL    DD     DSNAME=PROJECT.PAYROUTS,DISP=SHR,...
//SYSLIN     DD     DSNAME=&&CHECKS,DISP=(OLD,DELETE),...
//           DD     *
  INCLUDE    PAYROLL(FICA)
/*

If more than one member of a library is to be included, the INCLUDE statement specifies all the members to be used from that library. The member names appear in parentheses following the ddname of the library, and must not appear on the DD statement.

In the following example, an INCLUDE statement specifies two members from each of two libraries to be used as additional input:
//PAYROLL    DD     DSNAME=PROJECT.PAYROUTS,DISP=SHR,...
//ATTEND     DD     DSNAME=PROJECT.ATTROUTS,DISP=SHR,...
//SYSLIN     DD     *
  INCLUDE    PAYROLL(FICA,TAX),ATTEND(ABSENCE,OVERTIME)
/*

Each library could have been specified on a separate INCLUDE statement. Using either method a DD statement must be specified for each ddname.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014