Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The CHGFCTE command changes the attributes in an existing FCT entry. The parameters FCT, FORMTYPE, and DEVTYPE uniquely identify the entry being changed.
FCT entries are read by an active session when a writer is started and when a form-mount message is received from the host subsystem. If an FCT entry is updated and not read by the active session, the update does not change the way the host subsystem data is processed.
For example, if you are receiving data for form type xxxx and issue a CHGFCTE command for the same form type, the change does not take effect until the writer is canceled and restarted, or until another form-mount message is received from the host subsystem.
*ESCAPE Messages
Top |
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, *SAME, *FORMTYPE | Optional |
FILE | Output file | Single values: *SAME, *WTRE, *NONE Other values: Qualified object name |
Optional |
Qualifier 1: Output file | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
MBR | Member | Name, *SAME, *WTRE, *FIRST, *GEN | Optional |
FSN | File member sequence number | 0-999, *SAME, *WTRE | Optional |
DTAFMT | Data format | *SAME, *WTRE, *DATA, *FCFC, *CMN | Optional |
CHLVAL | Channel values | Single values: *SAME, *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: *SAME, *FILE Other values: Element list |
Optional |
Element 1: Form length | 1-255 | ||
Element 2: Form width | 1-255 | ||
LPI | Lines per inch | *SAME, *FILE, 4, 6, 8, 9 | Optional |
CPI | Characters per inch | *SAME, *FILE, 10, 15 | Optional |
COPIES | Number of copies | 1-99, *SAME, *FILE | Optional |
PGM | Program to call | Single values: *SAME, *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: *SAME, *WTRE, *NONE Other values: Qualified object name |
Optional |
Qualifier 1: Message queue | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB |
Top |
Specifies the qualified name of the FCT associated with the entry being changed.
The possible library values are:
forms-control-table-name: Specify the name of the FCT being changed.
Top |
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).
Top |
Specifies the device type associated with the FCT entry.
The possible values are:
Top |
Specifies the local form type that replaces the FORMTYPE value received from the host subsystem. This form type makes the form-mount messages more understandable to the system user when the output from the job is received. The local form type has more characters than the host form type and, therefore, can be more descriptive.
The possible values are:
Top |
Specifies the qualified name of the file that receives the data from the host subsystem.
The possible values are:
The possible library values are:
Top |
Specifies the file member to which output is directed. This parameter applies only if a DDM, physical, or source physical file is specified in the FILE parameter.
The possible values are:
If a member name already exists in the file, the sequence number is incremented by one until a unique name is reached and a new member is created, or until 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.
Top |
Specifies the initial three-digit FSN that is used to create member names. This parameter applies only if *GEN is specified for the MBR parameter.
The possible values are:
Top |
Specifies the format of the output data.
The possible values are:
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.
Top |
Specifies the printer carriage channel information, which is used by RJE to determine which line on a page to skip to before printing the next line of output.
The possible values are:
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 per 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.
Top |
Specifies the form size on the server printer.
The possible values are:
Element 1: Form Length
Element 2: Form Width
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.
Top |
Specifies the number of print lines per inch (lpi) on the server printer.
The possible values are:
Top |
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:
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(*FILE) and CPI(15) are specified, the form width in the FORMSIZE parameter should be 198 characters.
Top |
Specifies the number of copies to print. This parameter applies only to spooled files.
The possible values are:
Top |
Specifies the qualified name of a user program associated with the session description.
The possible values are:
The possible library values are:
Top |
Specifies the qualified name of the message queue to which messages for the writer are sent.
The possible values are:
The possible library values are:
Top |
Top |
*ESCAPE Messages
Top |