Change Forms Control Entry (CHGFCTE)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
Change FCT Entry
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.
Error messages for CHGFCTE
*ESCAPE Messages
- RJE0024
- Errors found. Processing of request ended.
- RJE0028
- Device type &2 for form type &1 does not exist in &3.
| Top |
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, *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 |
Forms Cntrl Table (FCT)
Specifies the qualified name of the FCT associated with the entry being changed.
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 being changed.
| Top |
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).
| Top |
Device Type (DEVTYPE)
Specifies the device type associated with the FCT entry.
The possible values are:
- *PRT: The printer device is used.
- *PUN: The punch device is used.
| Top |
Local Form Type (LCLFORM)
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:
- *SAME: The local form type replaced by the host form type specified in the FCT entry does not change.
- *FORMTYPE: The host form type is not replaced.
- local-form-type: Specify the local form type that replaces the host form type when the output from the job is received. Valid values range from one to ten alphanumeric characters in length. Lowercase letters, blanks, or special characters must be enclosed in apostrophes.
| Top |
Output File (FILE)
Specifies the qualified name of the file that receives the data from the host subsystem.
The possible values are:
- *SAME: The file associated with the FCT entry does not change.
- *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.
| Top |
Member (MBR)
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:
- *SAME: The file in the FCT entry does not change.
- *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
- A three-digit FSN controlled by the session to maintain member uniqueness.
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.
- *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.
| Top |
File Member Seq Number (FSN)
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:
- *SAME: The FSN in the FCT entry does not change.
- *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.
| Top |
Data Format (DTAFMT)
Specifies the format of the output data.
The possible values are:
- *SAME: The data format in the FCT entry does not change.
- *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.
| Top |
Channel Values (CHLVAL)
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:
- *SAME: The carriage information specified in the FCT entry does not change.
- *FILE: The carriage information specified in the device file is used.
- 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 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 |
Form Size (FORMSIZE)
Specifies the form size on the server printer.
The possible values are:
- *SAME: The form size in the FCT entry does not change.
- *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.
| Top |
Lines per Inch (LPI)
Specifies the number of print lines per inch (lpi) on the server printer.
The possible values are:
- *SAME: The number of print lines per inch in the FCT entry does not change.
- *FILE: The number of print lines per inch specified in the device file is used.
- 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.
| Top |
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:
- *SAME: The number of characters per inch in the FCT entry does not change.
- *FILE: The number of characters per inch specified 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(*FILE) and CPI(15) are specified, the form width in the FORMSIZE parameter should be 198 characters.
| Top |
Number of Copies (COPIES)
Specifies the number of copies to print. This parameter applies only to spooled files.
The possible values are:
- *SAME: The number of copies of either printed or punched output specified in the FCT entry does not change.
- *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.
| Top |
Program to Call (PGM)
Specifies the qualified name of a user program associated with the session description.
The possible values are:
- *SAME: The user program name in the FCT does not change.
- *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 in which the user program is located.
- program-name: Specify the name of the user program.
| Top |
Message Queue (MSGQ)
Specifies the qualified name of the message queue to which messages for the writer are sent.
The possible values are:
- *SAME: The message queue in the FCT entry does not change.
- *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.
| Top |
Examples
None| Top |
Error messages
*ESCAPE Messages
- RJE0024
- Errors found. Processing of request ended.
- RJE0028
- Device type &2 for form type &1 does not exist in &3.
| Top |