##FD

Used within a job to include the contents of a file.

Syntax

##FD Infile [(Options)] [Comment]

Parameters

Infile

Specifies the file whose contents are to be included. This is any valid MPE file name. For both $STDIN and $STDINX you must close with :EOD.

(Options)

Any combination of these:

N[OTRANSLATE]
T[RANSPARENT]

NOTRANSLATE causes the FD file to be transmitted to the host without translation.
TRANSPARENT causes NRJE to ignore all JOB cards in the ##FD and pass them to the host as data. Otherwise, JOB cards in the ##FD file are treated as job delimiters by NRJE. If this option is included, the proper JCL must be included so that the host also treats the JOB card as data. To use this option you must be configured with NM capability.

If both Options are specified, they must be separated by a comma (,). If no options are specified, the default will be file translation to EBCDIC and no transparency.

Comment

Any character string following the closing parenthesis. The Comment becomes part of the prompting string when the Infile is $STDIN or $STDINX.

Description

Use the ##FD command within a job to include the contents of the Infile. ##FD files can be nested up to 20 levels deep. When a job file is submitted, NRJE scans each record for occurrences of ##FD in columns 1-4. Whenever it finds one, it opens the Infile and adds the contents to the job being spooled for transmission to the host. Any options specified must be compatible with the SUBMIT options and the workstation configuration.

If a job card is included in the Infile, then its format must adhere to the same syntax as that specified for the SUBMIT command. Refer to the "Description" section of the SUBMIT command discussed later in this chapter.

If a file is built that requests input from $STDIN or $STDINX, the optional comment field on the ##FD card should be used to identify the type of input that is expected. Then, when the job input stream is constructed, the comment is printed at the user's terminal ahead of the standard NRJE message:

ENTER INPUT ENDING WITH ":EOD"

For example, if an Infile DATA1 contains the ##FD record shown in example three below, then the following will appear at the user's terminal:

          THIS INPUT IS FOR FILE DATA1.
          ENTER INPUT ENDING WITH ":EOD"

The ##FD card, in this case, prompts the user for interactive input into the DATA1 file. Note that the comment has been capitalized by NRJE.

Example

##FD TATK100J (N)                        TATK100J is already translated.
 
##FD DS1 (T)                             Job cards are ignored. 
 
##FD $STDIN This input is for file DATA1. Prompts user for interactive input.

##FD

Technical documentation

» Table of Contents

» Glossary

» Index

Syntax

Parameters

Description

Example