Send File (SNDF)

The Send File (SNDF) command is used by a CL procedure to send a record to a display device that is being used by an interactive user. The device can be any display station, including the console. The command sends the data from the program's CL variables to the display's device file in the specified record format. These variables were automatically declared in the program (one for each field in the record format) when the CL source program was compiled and a Declare File (DCLF) command was processed as part of the source.

Of the record formats specified in the DCLF command, only one can be specified in each SNDF command. If the device file has not been opened, it is opened by this command. The file and record format specified in this command can be overridden by an Override with Display File (OVRDSPF) command if it is entered before the file is opened. However, care should be taken that the fields in the overriding record format correspond to the CL variables declared in the program.

Restrictions:

This command is valid only within a CL procedure.
This command is valid only for display files.
This command cannot be used with database files.

Keyword	Description	Choices	Notes
DEV	Display device	Name, *FILE	Optional, Positional 1
RCDFMT	Record format	Name, *FILE	Optional, Positional 2
OPNID	Open file identifier	Simple name, *NONE	Optional

Display device (DEV)

Specifies the name of the display device to which the data in the CL variables for the specified record format is to be sent.

*FILE: The program's data is to be sent to the device associated with the device file that was declared in the FILE parameter of the DCLF command. If more than one device name is specified in the device file, *FILE cannot be specified.
name: Specify the name of the device or the name of the CL variable that contains the name of the device to which the program's data is to be sent.

Record format (RCDFMT)

Specifies the name of the record format that is to be used to send data to the file. The format contains all the fields in the record. This parameter must be coded with a record format name if there is more than one record format name in the device file; *FILE cannot be coded if there is more than one. If the record format contains the INVITE DDS keyword (optioned on), the SNDF functions as if SNDRCVF WAIT(*NO) had been coded.

*FILE: There is only one record format in the device file; that is the format in which the program's data is to be sent to the file.
name: Specify the name of the record format in which the program's data is to be sent to the file. A CL variable cannot be used to specify the record format name.

Open file identifier (OPNID)

Specifies the open file identifier that was declared on a preceding Declare File (DCLF) command in the same CL procedure. A CL variable cannot be specified for this parameter value.

*NONE: No open file identifier is provided. This command will use the file associated with the DCLF command that had *NONE specified for the OPNID parameter. Only one file can be declared in a CL procedure with *NONE as the open file identifier.
simple-name: Specify a name that matches the OPNID parameter value on a preceding DCLF command in the same CL procedure.

Examples

Example 1: Using Display File with One Record Format

DCLF   FILE(MENU1)
 :
SNDF

The record format in the device file MENU1 is sent to the device specified in the file. There is only one record format in the file.

Example 2: Using Display File with Multiple Record Formats

DCLF   FILE(SCREEN1)  RCDFMT(REC1 REC2)
 :
SNDF   DEV(DISP3)  RCDFMT(REC1)

The device file named SCREEN1 causes the display station named DISP3 to display the data sent by the CL procedure. The data is shown in the format specified by the REC1 record format.

Example 3: Using Open File Identifier

DCLF   FILE(SCREEN1)  RCDFMT(REC1 REC2)  OPNID(OUTDSP1)
DCLF   FILE(SCREEN2)  RCDFMT(REC3 REC4)  OPNID(OUTDSP2)
 :
SNDF   DEV(*FILE)  RCDFMT(REC2)  OPNID(OUTDSP1)

The device file named SCREEN1 is used to send data to the display device named in the same device file. The data is presented to the user in the format specified by record format REC2. The SNDF command is associated with device file SCREEN1 because the open file identifier specified on the SNDF command matches the open file identifier specified on the DCLF command for display file SCREEN1.

Error messages

*ESCAPE Messages