Add Forms Control Entry (ADDFCTE)

Add FCT Entry

The ADDFCTE command adds an entry to an existing FCT. The FCT can contain up to 9999 entries. Each entry includes the following forms-control attributes:

Host form type
Host subsystem writer type
Local form type
Physical file member creation information
Format of the output data
Channel values and associated line numbers
Form size
Lines and characters per inch
Number of copies
User program name.

Error messages for ADDFCTE

*ESCAPE Messages

RJE0024: Errors found. Processing of request ended.
RJE0050: Entry cannot be added to the forms control table &1.

Parameters

Keyword	Description	Choices	Notes
FCT	Forms control table	Qualified object name	Required, Positional 1
	Qualifier 1: Forms control table	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
FORMTYPE	Host form type	Character value	Required, Positional 2
DEVTYPE	Device type	PRT, PUN	Optional, Positional 3
LCLFORM	Local form type	Character value, *FORMTYPE	Optional
FILE	Output file	Single values: WTRE, NONE Other values: Qualified object name	Optional
	Qualifier 1: Output file	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
MBR	Member	Name, WTRE, FIRST, *GEN	Optional
FSN	File member sequence number	0-999, *WTRE	Optional
DTAFMT	Data format	WTRE, DATA, FCFC, CMN	Optional
CHLVAL	Channel values	Single values: FILE Other values (up to 12 repetitions): Element list*	Optional
	Element 1:	1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12
	Element 2:	1-255
FORMSIZE	Form size	Single values: FILE Other values: Element list*	Optional
	Element 1: Form length	1-255
	Element 2: Form width	1-255
LPI	Lines per inch	*FILE, 4, 6, 8, 9	Optional
CPI	Characters per inch	*FILE, 10, 15	Optional
COPIES	Number of copies	1-99, *FILE	Optional
PGM	Program to call	Single values: WTRE, NONE Other values: Qualified object name	Optional
	Qualifier 1: Program to call	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
MSGQ	Message queue	Single values: WTRE, NONE Other values: Qualified object name	Optional
	Qualifier 1: Message queue	Name
	Qualifier 2: Library	Name, LIBL, CURLIB

Top

Forms Cntrl Table (FCT)

Specifies the qualified name of the FCT to which the entry is added.

The possible library values are:

*LIBL: The library list for the job is used to locate the FCT.
*CURLIB: The current library for the job is used to locate the FCT. If no current library is specified, QGPL is used.
library-name: Specify the name of the library where the FCT is located.

forms-control-table-name: Specify the name of the FCT to which an entry is added.

Host Form Type (FORMTYPE)

Specifies the host form type for the FCT entry. The value is received from the host subsystem in either a peripheral data set information record (PDIR) for SNA, or a form-mount message for BSC. It must contain from one through eight alphanumeric characters. Lowercase letters, blanks, or special characters must be enclosed in apostrophes. For example, a host form type of blanks is specified as FORMTYPE (' ') (four blanks).

Local Form Type (LCLFORM)

Specifies the local form type. It replaces the FORMTYPE value received from the host subsystem. This makes the form-mount messages more understandable to the system user when the output from the job is received. The local form type contains more characters than the host form type, and therefore can be more descriptive.

The possible values are:

*FORMTYPE: The host form type is not replaced.
local-form-type: Specify the local form type. It replaces the host form type when the output from the job is received. Valid values are from one to 10 alphanumeric characters. Lowercase letters, blanks, or special characters must be enclosed in apostrophes.

Output File (FILE)

Specifies the qualified name of the file that receives the data from the host subsystem.

The possible values are:

*WTRE: The file specified in the session description writer entry is used.
*NONE: A file is not associated with this entry. The session description writer entry determines where the data is sent. RJE does not use the information in the FCT entry.
The possible library values are:
- *LIBL: The library list for the job is used to locate the file.
- *CURLIB: The current library for the job is used to locate the file. If no current library is specified, QGPL is used.
- library-name: Specify the name of the library where the file is located.
file-name: Specify the name of the diskette, DDM, physical, printer, or source physical file that receives the data from the host subsystem. Diskette and printer files must be program described.

Member (MBR)

Specifies the file member to which output is directed. This parameter applies only if you specify a DDM, physical, or source physical file in the FILE parameter.

The possible values are:

*WTRE: Creates file members according to the method specified in the session description writer entry.
*GEN: Creates a member name formatted as either Affffffccc or Bffffffccc where:

A

Indicates that the file member contains print data.

B

Indicates that the file member contains punch data.

ffffff

Up to the first six non-blank characters of the host form type that was received from the host subsystem. Only A through Z, 0 through 9, $, #, @, and _ are valid in the form type that is used to generate member names.

ccc

Indicates a three-digit FSN controlled by the session to maintain member uniqueness.

If a member name already exists in the file, the three-digit FSN is incremented by one until either a unique name is reached and a member is created, or sequence numbers up to and including 999 have been tried without creating a member.

If no member is created, the writer issues a message requesting you to either try again or to cancel this file.
*FIRST: The first member in the file is used.
member-name: Specify the name of the file member. If the member is not found, an inquiry message is sent to the RJE message queue.

File Member Seq Number (FSN)

Specifies the initial three-digit FSN that is used to create member names. This parameter applies only if you specify *GEN for the MBR parameter.

The possible values are:

*WTRE: The FSN in the session description writer entry is used.
file-sequence-number: Specify the initial three-digit FSN. Leading zeros are not required for sequence numbers less than 100.

Data Format (DTAFMT)

Specifies the format of the output data.

The possible values are:

*WTRE: The output format from the session description writer entry is used.
*FCFC: The output data is in first-character forms control (FCFC) format. If DEVTYPE(*PUN) is specified, *FCFC is not valid.
The data can be written to a physical file in FCFC format and printed later using the Copy File (CPYF) command, specifying an FCFC printer file for the TOFILE parameter. The record length of the physical file must include one extra byte for the FCFC code.
*DATA: The output data is in data format. No FCFC codes are embedded in the data. Specify *DATA to send data to a physical file to be processed by a program.
*CMN: The output data is in communications format (256-character records). *CMN format decreases communications time. Before using the data, issue the CVTRJEDTA command to convert it to either FCFC format or data format. If you specify *CMN, the output file must be a physical file with a record length of 256 bytes.

Channel Values (BCHLVAL)

Specifies the printer carriage channel information, which is used to determine which line on a page to skip to before printing the next line of output.

The possible values are:

*FILE: The printer carriage channel information is the same as that in the device file.
carriage-channel-identifier line-number: Specify the channel identifiers and line numbers.
Each identifier has a value from 1 to 12, corresponding to printer channels 1 to 12. For each carriage channel identifier, RJE skips to the associated line number before printing. If a line number is not specified, single spacing is used. An identifier is specified only once for each command call.

The maximum line number is 255.

The CHLVAL parameter associates the channel identifier with a page line number. For example, CHLVAL((1 5)(10 55)) means to associate channel 1 with line 5, and channel 10 with line 55.

Form Size (FORMSIZE)

Specifies the form size on the server printer.

The possible values are:

*FILE: The form size specified in the device file is used.
Element 1: Form Length
form-length: Specify the form length in the FCT entry. The maximum value is 255, and it must be greater than or equal to the overflow line number specified in the device file. If it is not, the form length will not be changed when the FCT entry is used.
Element 2: Form Width
form-width: Specify the form width in the FCT entry. The maximum value is 255.

Note: If you specify OUTRCDLEN(*FIXED), use a form width of 198 with 15 characters per inch (cpi) and a form width of 132 with 10 cpi. If FORMSIZE(*FILE) and CPI(15) are specified, the form width should be 198 in the printer file description. If you specify OUTRCDLEN(*FILE), ensure that the form width is either greater than or equal to the length of the longest record that is received for this form type. If the form width is greater than the record length, the record is right-padded with blanks.

Line per Inch (LPI)

Specifies the number of print lines per inch (lpi) on the server printer.

The possible values are:

*FILE: Specify the number of print lines per inch in the device file.
4: Four print lines per inch is used.
6: Six print lines per inch is used.
8: Eight print lines per inch is used.
9: Nine print lines per inch is used.

Characters per Inch (CPI)

Specifies the number of characters per inch (cpi) on the server printer. The CPI parameter applies only when RJE is writing to a printer file.

The possible values are:

*FILE: The number of characters per inch in the device file is used.
10: RJE produces 132-character records at 10 cpi when *FIXED is specified for OUTRCDLEN.
15: RJE produces 198-character records at 15 cpi when *FIXED is specified for OUTRCDLEN.

Note: When host data is written by an RJE printer to a printer file, the record size that RJE uses is dependent on the cpi when *FIXED is specified for OUTRCDLEN, and on the page width when *FILE is specified. If OUTRCDLEN(*FIXED) and CPI(15) are specified, the form width in the FORMSIZE parameter should be 198 characters. Otherwise, the record is truncated to the specified form width.

Number of Copies (COPIES)

Specifies the number of copies to print. This parameter applies only to spooled files.

The possible values are:

*FILE: The number of copies specified in the device file is used.
number-of-copies: Specify a value between 1 and 99 for the number of copies to print.

Program to Call (PGM)

Specifies the qualified name of a user program associated with the session description.

The possible values are:

*WTRE: The program specified in the session description writer entry is used.
*NONE: No user program is associated with the writer.
The possible library values are:
- *LIBL: The library list for the job is used to locate the user program.
- *CURLIB: The current library for the job is used to locate the user program. If no current library is specified, QGPL is used.
- library-name: Specify the name of the library where the user program is located.
program-name: Specify the name of the user program.

Message Queue (MSGQ)

Specifies the qualified name of the message queue to which messages for the writer are sent.

The possible values are:

*WTRE: The message queue in the session description writer entry is used.
*NONE: A message queue is not used.
The possible library values are:
- *LIBL: The library list for the job is used to locate the message queue.
- *CURLIB: The current library for the job is used to locate the message queue. If no current library is specified, QGPL is used.
- library-name: Specify the name of the library where the message queue is located.
message-queue-name: Specify the name of the message queue.